CA IdentityMinder 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 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 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.

File Locations

This guide uses the following abbreviations for installation locations:

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

Location of the CA IAM Connector Server Files in the Installers

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

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

  Provisioning\ConnectorServer
  

• CA CloudMinder: 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 Connector Server

Default Installation Locations

When you install CA IAM Connector Server, 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 Connector Server.

Default Installation locations for CA IdentityMinder

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

Default Installation locations for CA CloudMinder

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

Default Installation locations for CA GovernanceMinder