Integrate CA Spectrum and CA UIM for Virtualization Management

Contents
casp101
From the Spectrum v10.1.2 release, the SNMP Gateway probe and SBGW /Southbound gateway are no longer recommended for alarms synchronization from CA UIM to CA Spectrum. Please use the Spectrum Gateway (spectrumgtw) probe for this.
For more information refer to the following CA Spectrum - CA UIM Integration Compatibility Matrix:
CA Spectrum
CA UIM
Inventory sync using nisapi
snmpgtw /SBGW
spectrumgtw
10.1
8.2, 8.3
YES
NA
10.1.1
8.2, 8.3
YES
NA
10.1.2
8.47
You no longer have to deploy nisapi separately.
The wasp probe which is a core component in CA UIM contains the nisapi_service_host probe functionality. 
By default, the CA Spectrum integration uses the nisapi package deployed in wasp as part of the CA UIM installation or upgrade.
NA
YES
We recommend that you go through the CA Spectrum-CA UIM Integration using spectrumgtw probe - FACT SHEET to understand the changes to the integration whether you are new to this integration or an existing user.
Contents
This section describes how to set up the integration between the current releases of CA Spectrum and CA UIM for Virtualization Management. It also describes how to use its features to perform specific tasks such as synchronize inventory at regular intervals, manage alarms and events, and run reports.
The following video describes how you can integrate CA Spectrum and CA UIM for Virtualization Management to monitor virtual datacenters and to use CA Spectrum’s root cause analysis feature to rapidly troubleshoot and resolve issues:

Prerequisites for CA Spectrum and CA UIM Integration for Virtualization Management
Consider the following Prerequisites for the integration:
If you have enabled CA Spectrum and CA UIM integration for server management in 9.4 release, while upgrading to CA Spectrum Release 10.1.2, you no longer have to deploy nisapi separately.
By default, the CA Spectrum integration uses the nisapi package deployed in wasp as part of a CA UIM 8.47 installation or upgrade. 
If you are integrating CA-UIM with CA Spectrum
till r10.1.1
. Follow these steps:
  1. 8.0.4 probe must be downloaded and configured before enabling the integration. You can download nisapi from the following link:
    Download nisapi 8.0.4 at http://nmscdn.nimsoft.com/nisapi_8.0.0/nisapi_service_host-8.0.4.zip.
  2. To migrate nisrest to nisapi, take the following steps:
    1. Stop svchost service.
    2. Navigate to C:\Program Files (x86)\CA UIM\probes\service\service_host\catalinaBase\webapps
    3. Remove nisrest.war and the nisrest directory
    4. Add latest nisapi to archive.
    5. Deploy nisapi and restart svchost service.
      Migrating nisrest to nisapi is a one time activity that is performed before enabling the integration.
  3. Verify that the VMware (
    vmware
    ) and SNMP Gateway (
    snmpgtw
    ) probes are configured before enabling the CA Spectrum and CA UIM integration.
  4. All the primary SpectroSERVERs should be up and running while enabling the CA Spectrum and CA UIM integration.
  5. Enable QoS metrics and alarms in CA UIM for Spectrum OneClick views and condition-correlation to work.
  6. CA UIM integration must be enabled on the OneClick server, which is configured to Main Location Server (MLS) (preferably server which does not have SRM).
  7. CA Spectrum models virtual machines (VMs) whose PrimaryDNSName and PrimaryIPV4address attribute data are not reported to CA Spectrum by UIM. For UIM to report these attributes, deploy VMware Tools on all the VMs.
How to Integrate CA Spectrum and CA UIM for Virtualization Management
From the OneClick Administration page, you can enable the integration between CA Spectrum and CA UIM for Virtualization Management. When you enable the integration all the virtual entities managed by CA UIM appear in CA Spectrum.
If you want to change any details on the Administration page, refresh the page before making any changes.
If you enable the integration for VMware Management, all the entities that are managed by Virtual Host Manager (VHM) such as VMware, Hyper-V, Zones, Huawei SingleCloud, and LPAR through CA Virtual Application Insight Module (VAIM) are disabled permanently and all the existing VHM models are deleted. You must reinstall CA Spectrum for CA VAIM based Virtualization Management.
Follow these steps:
  1. Open the OneClick Administration page.
    The OneClick Administration page opens.
  2. Click the Administration tab.
    Links to various OneClick web server configuration pages is displayed.
  3. Click the UIM Configuration link in the left panel.
    The UIM Configuration page opens.
    The following image illustrates the configuration options that are available in the UIM Configuration window:
    Spetrum UIM VMware Integration_101.png
    UIM Server Host Name
    Indicates the IP address/hostname of the UIM Server.
    UIM Server Port
    Indicates the server port number of CA UIM.
    UMP Server Host Name
    Indicates the IP address/hostname of UMP.
    UMP Server Port
    Indicates the server port number of UMP.
  4. Select the SpectroSERVER for the new CA UIM models to be created.
  5. To enable the CA UIM integration, select VMware Management.
    The following warning message appears:
    VMware message_101.png
  6. To confirm, click
    OK.
    In the OneClick Admin page, do not enable or disable the '
    VMware Management
    ' or '
    Server Management
    ' options when the MLS is down. This may cause unexpected errors.
    In the CA Spectrum OneClick console, do not create any container of type '
    UIMInventoryContainer
    '.
  7. Click
    Test.
    If test is successful, “
    Test connection to UIM Server was successful
    ”, message appears.
  8. Click
    Save.
    Successfully saved configuration to the database message appears.
    CA UIM integration is now enabled.
If you change any settings on any of the OneClick server other than the integration OneClick server. The message, "Saving details on this OC will change the Integration OC Server. Click [OK] to continue" appears. If you click Save, the integration OneClick server changes and the details are saved. If you click Cancel, the details are saved but the integration OneClick server remains same.
If the Main Location Server (MLS) in a Distributed SpectroSERVER (DSS) setup is down and if it does not have a secondary SpectroSERVER, the configuration information that is specified in the UIM Configuration page fails to save to the database. We recommend that you use the Fault Tolerance (FT) setup for MLS to avoid any inconsistent behavior.
  • If the CA UIM-CA Spectrum integration is enabled in a FT setup, it is recommended that you synchronize the Primary and Secondary SpectroSERVERs after the first successful synchronization. This will ensure that you have the integration data backed up in case the Primary/ dedicated SS (specified in the OneClick Admin > UIM Configuration) goes down.
  • It is also recommended that you synchronize the Primary and Secondary SpectroSERVERs, after a successful synchronization job, if you are moving Datacenters from a MLS to a Non-MLS landscape.
Disable the Integration
You can disable the CA Spectrum and CA UIM Integration for Virtualization Management from the OneClick Administration page.
Follow these steps:
  1. Open the OneClick Administration page.
    The OneClick Administration page opens.
  2. Click the Administration tab.
    Links to various OneClick web server configuration pages is displayed.
  3. Click the UIM Configuration link in the left panel.
    The UIM Configuration window opens.
  4. Consider the following scenarios to disable the CA UIM integration:
    • Clear both Server and VMware Management options and click
      Save
      .
      The following message appears:
      Disable Integration_101.png
      Click Ok, CA Spectrum and CA UIM integration for both Server Management and Virtualization Management is disabled.
      Wait for the all the CA UIM Host server models and the folder hierarchy to be cleared from the UIM Manager in the OneClick view after disabling the integration. To validate, search for any UIM Host Server models, using the search option.
    • If you clear the VMware Management check box and click
      Save.
      The following message appears:
      Disable Confirmation_101.png
Click Ok,
CA Spectrum and CA UIM integration for Virtualization Management is disabled.