Installation › How to Deploy a Tiered SA Manager Environment › Install the CA SOI Domain Connector

Install the CA SOI Domain Connector

You install the CA SOI Domain connector to enable a connection between a CA SOI deployment and an enterprise CA SOI layer. Each tier consists of a full CA SOI deployment, with the top tier named the Enterprise SA Manager. The CA SOI Domain connector forwards the following information from its source SA Manager to the Enterprise SA Manager for analysis in a unified view:

• Service CIs
• Service alerts
• Customer information that is associated with services

The CA SOI Domain connector subscribes to changes, so that it can automatically forward new services or changes to existing services to the Enterprise SA Manager. The connector also exposes service metric information for consuming applications.

You install the CA SOI Domain connectors on the Enterprise SA Manager. The Domain connectors obtain data from the different Enterprise Domain Managers and publish to the Enterprise SA Manager through the ActiveMQ Bus. Install as many CA SOI Domain connectors as required to tier your deployment to the desired level. Consider the following items during the CA SOI Domain connector deployment phase:

• Multiple CA SOI Domain connectors can connect to one Enterprise SA Manager, but only one CA SOI Domain connector can connect to each remote SA Manager.
• In firewall environments, the ActiveMQ Server port (61616 by default) must be open between the CA SOI Domain connector and the Enterprise SA Manager. Also, the SA Manager port (7090 by default) must be open between the CA SOI Domain connector and the SA Manager.
• The local source SA Manager web services host information for the CA SOI Domain connector is stored in the SOI_HOME\resources\Configurations\ssaDomain_MdrProdInstance.xml file.

Follow these steps:

1. Run Connector_Domain.exe from the Disk1\SOI folder of the CA SOI installation image.
2. Accept all license agreements, and click Next.
3. Enter the appropriate information in the following fields to configure a web services connection to the domain manager:

   SOI Manager Hostname

   Specifies the name of the domain manager host from which to pull data for use by the remote source SA Manager.

   SOI Manager Web Services Port

   Specifies the port in which to connect to web services on the source SA Manager.

   Default: 7090

   Web Service User

   Specifies the user that has access to the CA SOI web services on the source SA Manager.

   Default: samuser

   Web Service Password

   Specifies a valid password for the Web Service User

   Validate SOI Manager

   Specifies whether to verify the web services configuration information when you click Next.

4. Enter the appropriate information to configure the UI Server settings of the domain manager. Change these values only if the UI Server of the domain manager is remote to the domain manager. The field values allow a proper launch back to the domain manager Operations Console from the Enterprise SA Manager:

   Domain Manager UI Server Host

   Specifies the host on which the source SA Manager's UI Server resides.

   Default: domain manager host

   Domain Manager UI Server Port

   Specifies the source SA Manager's UI Server port.

   Default: 7070

5. Specify whether to start the services after installation completes, and click Next.
6. Review your selections, and click Install.

   The CA SOI Domain connector installs on the system and integrates with the specified source SA Manager and Enterprise SA Manager. An installation summary page opens when the installation finishes.

7. Click Done.

   If the installation summary page notes installation errors, view the Domain connector installation log file that is located in the SOI_HOME\log folder to troubleshoot the installation. This file is created when you click Done after the installation finishes.

   Note: You can install another instance of the domain connector to point to an additional SA Manager. Run the Domain Connector installation again and a dialog prompts you to configure an additional instance.