CA Identity Manager Connector Guides › Connectors Guide › Installation › Install Connectors

Install Connectors

CA IAM Connector Server comes with many connectors. You do not need to install these connectors.

When we update a connector or create a new one, we post it on the Connector Download page. If you want to add a new or updated connector, use this download page, as described in the following instructions.

Follow these steps:

1. Navigate to the Connector Download page.
2. Find your connector, then download its Endpoint Guide and its attribute list.

   Note: Not all connectors have an Endpoint Guide yet. For those that do not, use the link to the CA Identity Manager Connectors Guide.

3. Download the connector file. This ZIP file contains the following components:
   • A JAR file
   • A ZIP file that contains the connector JAR file plus other components that are required by the installer.
   • A readme that lists the connector version and other details
4. If CA IAM Connector Server is already installed, put the JAR file into any local directory, then deploy the connector.
5. If CA IAM Connector Server is not installed, install the new connector when you install CA IAM Connector Server:
   1. Find the old connector ZIP file in the installation files for CA IAM Connector Server, then rename the file.
   2. Add the new connector ZIP file to the installation files for CA IAM Connector Server. Ensure that the filename is the same as the old connector file.
   3. Run the installer for CA IAM Connector Server.

      The CA IAM Connector Server installation program also installs the new connector.

The connector is now available for use.

Contents of Downloaded ZIP File for a Connector

When you download a connector from the Connector Download page, you receive a ZIP file. The ZIP file contains the following files:

• A JAR file—Contains the entire connector as an OSGi bundle. Deploy this file to replace the old connector in an existing installation.
• A ZIP file—Contains the entire connector in installable form. Use this file to replace the old connector in the installation files for CA IAM Connector Server. This lets you install the new connector when you install the connector server.
• An XML file—(Optional) Contains the metadata for the connector. Use this with Connector Xpress if you want to add custom attributes to the connector.

  The metadata files are also supplied in the JAR and ZIP files. This file is only supplied separately for connectors that support custom attributes.

• A readme—Lists the version of the connector.

Example: Contents of the downloaded file for the ACF2 ACFESAGE connector

The name of the downloaded file is acf2acfesage.zip.

The downloaded ZIP contains the following files:

• acf2acfesage_metadata.xml
• jcs-connector-acfesage-1.1.0.jar
• jcs-connector-acf2acfesage.zip
• readme.txt

Example: Contents of the downloaded file for the Google Apps connector

The name of the downloaded file is google-apps.zip.

The downloaded ZIP contains the following files:

• jcs-connector-gab-1.1.0.jar
• jcs-connector-gab.zip
• readme-google-apps.txt

This connector does not support custom attributes, so the metadata file is not supplied separately.