CA Clarity PPM Connector Installation › Install the CA Clarity PPM Connector

Install the CA Clarity PPM Connector

Before starting this installation procedure, make sure that you meet all the installation prerequisites. You can install the CA Clarity PPM connector locally on the CA Clarity PPM server or on a stand-alone server.

You install the CA Clarity PPM connector on the system, which allows integration with the appropriate CA Clarity PPM and CA Spectrum SA instances. The Clarity_Install_2.5.0.1.log file is created in the SA_HOME\log\ directory. Use this log file to resolve installation issues. If the installation summary page lists installation errors, use this log file to resolve installation issues.

Note: The installer does not attempt to connect to CA Clarity PPM to verify the settings. If any settings are incorrect, the installation succeeds, but the connector can fail to initialize properly.

Follow these steps:

1. Double-click the Connector_Clarity.exe file from the CA Clarity PPM connector package.

   The installer introduction page appears.

2. Click Next.

   The license agreement page appears.

3. Scroll to the bottom of the agreement, select "I accept the terms of the License Agreement", and click Next.

   The choose install folder page appears.

   Note: This page does not open if CA Spectrum SA components already reside on the system.

4. Do one of the following to specify the installation folder, and click Next:
   • Accept the default.
   • Enter the name of a new installation folder.
   • Click Choose and select an installation folder.

   Note: The maximum installation path length is 150 characters. The installer blocks paths with more than 150 characters.

   One of the following occurs:

   • If another connector or the SA Manager resides on the same system, the catalyst connector configuration page opens.
   • If you are installing the CA Clarity PPM connector on a system with no other CA Spectrum SA components (that is, a clean installation), the integration services configuration page opens.
5. (Clean installation only) Specify the following information to connect to the appropriate SA Manager and configure CA Clarity PPM connector preferences:

   Manager Host

   Defines the name of the SA Manager server, which is the CA Spectrum SA manager component.

   ActiveMQ Port

   Defines the specified port number for the ActiveMQ server, which is installed with the SA Manager. Retain the default of 61616 unless you changed this port number when installing CA Spectrum SA.

   Default: 61616

   SA Admin

   Defines the name of the CA Spectrum SA administrator user. You define this user during CA Spectrum SA installation, and the default name is samuser.

   Default: samuser

   Password

   Defines the password for the CA Spectrum SA administrator user.

   UCF Broker Port

   Defines a valid port for the UCF Broker to interface with the CA Clarity PPM connector and perform create, update, and delete operations on domain managers.

   Default: 8020

   Verify Connection

   Defines verifying the SA Manager connection information when you click Next on the integration services configuration page.

   Use DNS for name resolution

   Specifies whether to use DNS to normalize CI server names. If a reliable DNS mechanism is not in place (for example, no DNS server on the network, or CIs not defined to the DNS), disable DNS lookups to prevent import delays. If you disable DNS, all name resolution must be handled without DNS, and you might be required to create a hosts file.

   Connector Name

   Defines the CA Clarity PPM connector name. Change the name only if you are installing multiple instances of the connector to operate in a high availability cluster environment. In this case, define this property as the virtual host name associated with the cluster. Connectors must reference the same virtual host name to perform appropriately in a failover scenario.

   The catalyst connector configuration page appears.

6. Complete the following fields:

   Clarity Host Name

   Specifies the name of the server running CA Clarity PPM.

   Clarity Port

   Specifies the port number that CA Clarity PPM is using for its standard web interface.

   Default: 80

   Clarity Client Port

   Specifies the CA Clarity PPM property used (with host) to identify a unique CA Clarity PPM instance.

   Default: 9091

   Clarity User Name

   The name of the CA Clarity PPM user that you defined during the installation.

   Clarity Password

   The password of the CA Clarity PPM user that you defined during the installation.

7. Click Next.

   The service startup page appears.

8. Specify starting the services automatically after installation, and click Next.

   The pre-installation summary page appears.

9. Review your selections, and click Install.

   The install complete page appears when the installation finishes.

10. Click Done.

    The installation summary page appears.