Connector Guides › Connectors Guide › Installation › Install Connectors

Install Connectors

CA IAM CS 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 IdentityMinder 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 CS is already installed, put the JAR file into any local directory, then deploy the connector.
5. If CA IAM CS is not installed, install the new connector when you install CA IAM CS:
   1. Find the old connector ZIP file in the installation files for CA IAM CS, then rename the file.
   2. Add the new connector ZIP file to the installation files for CA IAM CS. Ensure that the filename is the same as the old connector file.
   3. Run the installer for CA IAM CS.

      The CA IAM CS 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 CS. 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.

File Locations

This guide uses the following abbreviations for installation locations:

• cs_home: Installation directory of CA IAM Connector Server (CA IAM CS)
• cs_sdk_home: Installation directory of the Connector Server SDK
• conxp_home: Installation directory of Connector Xpress

Location of the CA IAM CS Files in the Installers

The installation files for the CA products that use CA IAM CS each contain the CA IAM CS files. However these installation files for CA IAM CS are supplied in different locations in each client:

• CA IdentityMinder: The connector files are in the following location:

  Provisioning\ConnectorServer
  

• CA IdentityMinder: The connector files are in the following location:

  Servers\ConnectorServer
  

• CA GovernanceMinder: The connector files are in the following location:

Location of the Connector Files in CA IAM CS

Default Installation Locations

When you install CA IAM CS, you can define its installation location, or you can accept the default location.

The following tables list the default installation locations for the client products that use CA IAM CS.

Default Installation locations for CA IdentityMinder

The locations in this table also apply to an on-premise installation for CA IdentityMinder.

Default Installation locations for CA IdentityMinder

This table shows the location of CA IAM CS when it is installed as part of a cloud installation.

Default Installation locations for CA GovernanceMinder