Integrate with CA UIM for Virtualization Management

From the 10.1.2 release, the SNMP Gateway probe and SBGW /Southbound gateway are no longer recommended for alarms synchronization from CA UIM to 
DX NetOps Spectrum
. Please use the 
DX NetOps Spectrum
 Gateway (spectrumgtw) probe for this.
For more information about the integration of 
DX NetOps Spectrum
 with other CA products, see Integration Compatibility.
We recommend that you go through the 
DX NetOps 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.
This section describes how to set up the integration between the current releases of 
DX NetOps 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 
DX NetOps Spectrum
 and CA UIM for Virtualization Management to monitor virtual datacenters and to use 
DX NetOps Spectrum
 root cause analysis feature to rapidly troubleshoot and resolve issues:

Prerequisites for 
DX NetOps Spectrum
 and CA UIM Integration for Virtualization Management
Consider the following Prerequisites for the integration:
If you have enabled 
DX NetOps Spectrum
 and CA UIM integration for server management in 9.4 release, while upgrading to 10.1.2, you must configure the latest CA UIM REST API (nisapi_WASP).
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.
  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 the 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 (
    ) and SNMP Gateway (
    ) probes are configured before enabling the 
    DX NetOps Spectrum
     and CA UIM integration.
  4. All the primary SpectroSERVERs should be up and running while enabling the 
    DX NetOps Spectrum
     and CA UIM integration.
  5. Enable QoS metrics and alarms in CA UIM for 
    DX NetOps 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. DX NetOps Spectrum
     models virtual machines (VMs) whose PrimaryDNSName and PrimaryIPV4address attribute data are not reported to 
    DX NetOps Spectrum
     by UIM. For UIM to report these attributes, deploy VMware Tools on all the VMs.
In previous releases of CA UIM, the nisapi_service_host package was deployed to the service_host probe. As of CA UIM release 8.47, the service_host probe was deprecated and its functionality was moved to the wasp probe.
  • By default
    the wasp probe uses port 80. However, because the wasp probe is a core component in CA UIM, this port should already be open in a properly functioning CA UIM environment.
Deploy and Configure Probes
To optimize the 
DX NetOps Spectrum
 and CA UIM integration, deploy and configure the following CA UIM probes on CA UIM server:
  • snmpgtw
     Sends traps from CA UIM to 
    DX NetOps Spectrum
    . The SNMP gateway converts alarms to SNMP trap messages that are readable by any SNMP-based event manager. 
  • vmware (VMware Monitoring)
     The vmware probe automates all common monitoring and data collection tasks, and lets you focus on problems as they arise. The vmware probe collects and stores data and information from the monitored components through VMware Virtual Center (vCenter), or by connecting to ESX servers directly, at customizable intervals. You can define alarms to be generated when specified thresholds are breached or when the service is unavailable. 
  • net_connect
     The net_connect (Network Connectivity Monitoring) probe measures network connectivity that is based on "ping" (ICMP ECHO) and the TCP connections to a list of user-defined services. The service can be NetBIOS, Telnet, FTP, and HTTP. The probe supports the CA UIM family of solutions by sending quality of service (QoS) messages.
  • (nisapi) service_host or wasp
     Queries the CA Nimsoft Manager using the Restfull Services API to retrieve the list of CA UIM models to be monitored. Deploy service_host v8.04/ wasp v8.4.2 or higher.
  • cdm
     The CPU, Disk, Memory Performance Monitoring (cdm) probe monitors the performance and resource load on the system with the robot. The CA UIM CPU, Disk & Memory (cdm) probe generates alarms that are based on configured threshold values and trending statistics.
    The probe provides the following benefits:
    • Generate alarms that are based on configured threshold values. The probe generates alarms that can trigger corrective actions immediately.
    • Generate trending Quality of Service (QoS) data. The information is measured and sent to the data_engine probe to process and store in the CA UIM database. The historical data facilitates capacity planning for monitored systems in the IT environment. Some examples are as follows:
      • View how disks are filling up over time
      • Plan batch jobs according to the CPU utilization
      • Upgrade systems which consistently operate near capacity
  • spectrumgtw
     The spectrumgtw (
    DX NetOps Spectrum
     Gateway) probe provides a bidirectional (CA UIM to 
    DX NetOps Spectrum
    DX NetOps Spectrum
     to CA UIM) integration between CA Unified Infrastructure Management and 
    DX NetOps Spectrum
     enabling you to perform the following actions:
    • Export and correlate 
      DX NetOps Spectrum
       Inventory from a Global Collection to CA UIM inventory.
    • Bi-directional synchronization of alarms
    • Bi-directional Clear / Update of alarms
    • View symptomatic 
      DX NetOps Spectrum
       alarms in the context for the root-cause alarm in CA UIM
    • Ticket ID synchronization between 
      DX NetOps Spectrum
       and CA UIM
From 10.2.1, all CA UIM events (apart from events related to VMWare and servers) are no longer considered as generic events.
Specific events raised on CA UIM from the following probes are mapped to unique events created in 
DX NetOps Spectrum
. This allows you to manage the events (raised on CA UIM) from 
DX NetOps Spectrum
 more efficiently.
Additional event mapping for select metrics from the following probes (along with cdm and net_connect probes) is added from 10.2.1. Additional event mapping for Please refer to Additional event mapping from CA UIM Probes to 
DX NetOps Spectrum
  • logmon
     The Log Monitoring (logmon) probe scans ASCII-based systems and application log files by matching specified expressions. Alarms are generated when the log file content matches the defined expression.
  • rsp (Remote System probe)
     The Remote System Probe (rsp) allows you to monitor system metrics. The probe collects performance data in an agentless manner without installing proprietary software on the system.
  • sqlserver
     The SQL Server Monitoring (sqlserver) probe constantly monitors the internal performance and space allocation of SQL Server databases. The probe can run locally on the database server or it can be configured to run as a remote client. The probe feeds essential information that is based on predefined criteria to the UIM availability manager for appropriate alert notification, as required. An extensive range of checkpoints can be selected and individually scheduled to meet your monitoring requirements. The probe will run selected SQLs to extract vital information about your SQL Servers. The information is presented to database-administrator as alarms or reports.
  • processes (Process Monitoring)
     The (Process Monitoring) processes probe monitors the specified processes to detect any error situation. The probe also retrieves information about the process, for example, the CPU usage, memory usage, and so on. 
You can configure the CA UIM probes through the Probe Configuration interface. For more information, see the CA Unified Infrastructure Management Probe Space.
How to Integrate 
DX NetOps Spectrum
 and CA UIM for Virtualization Management
From the OneClick Administration page, you can enable the integration between 
DX NetOps Spectrum
 and CA UIM for Virtualization Management. When you enable the integration all the virtual entities managed by CA UIM appear in 
DX NetOps 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 
    DX NetOps Spectrum
     for CA VAIM based Virtualization Management.
  • From 10.2.3, 
    DX NetOps Spectrum
     can monitor both UIM models and SystemEdge models when 
    DX NetOps Spectrum
    -CA UIM Integration is enabled with Multi-tenancy.When the integration is enabled with Multi-tenancy, CA UIM origins are mapped to 
    DX NetOps Spectrum
     landscapes. In this scenario, 
    DX NetOps Spectrum
     monitors UIM models on the landscapes which are part of Multi-tenancy mapping and can monitor SystemEdge AIM based models on the landscapes which are not part of Multi-tenancy mapping.When the 
    DX NetOps Spectrum
    -CA UIM Integration is enabled without Multi-tenancy, 
    DX NetOps Spectrum
     monitors UIM models only. All the SystemEdge AIM based models are deleted on all the landscapes.
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.
      1. Click the UIM Configuration link in the left panel.
        The following image illustrates the configuration options that are available in the UIM Configuration window:
         UIM Group Name for Hosts and VMs.png
        If the integration was already enabled before the upgrade, then the
         Legacy Integration
         radio button would appear as selected by default.
        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. 
        UMP Server Protocol
        Indicates the network protocol to connect to the CA UMP server.
        From spectrumgtw 8.67 onwards, the UIM Group Name field in the UIM configuration section has been changed to Group Name for Hosts.
    UIM Group Name for Hosts
    : Specify the UIM group name in this field for selective inventory synchronization of hosts (of the UIM group specified) from CA UIM to 
    DX NetOps Spectrum
    . This is applicable for Server Management entities only.
    UIM Group Name for VMware
    : Specify the UIM group name in this field for selective inventory synchronization of VMware entities (of the UIM group specified) from CA UIM to 
    DX NetOps Spectrum
    . To address the challenges in providing filtering of VMware data from UIM to 
    DX NetOps Spectrum
    , a 'UIM Group Name for VMware' field is introduced from spectrumgtw v.8.67.
      1. 1. Ensure that you add vCenter and ESX hosts and the corresponding virtual machines to be synced to 
        DX NetOps Spectrum
        2. If the vCenter is not part of the group, ESX and VMs are not modeled in 
        DX NetOps Spectrum
         even though they are part of the group.
        3. If vCenter and VMs are part of the group and ESX is not, then the VMs are created without any relationship with the vCenter in 
        DX NetOps Spectrum
        Inventory from the group you specify in this field is synchronized from UIM to 
        DX NetOps Spectrum
        For successful encrypted communication (https protocol) between 
        DX NetOps Spectrum
         and UIM UMP Server, you must import SSL Certificate of UIM UMP Server into 
        DX NetOps Spectrum
         OneClick Server. To import the certificate, from the OneClick home page select 
        SSL Certificates
        , upload the certificate file then click 
        . Restart the OneClick web server for the changes to take effect.
        Inventory from the group you specify in this field is synchronized from CA UIM to 
        DX NetOps Spectrum
        If you leave the UIM/UMP Group Name field blank, all inventory from the specified UIM server is synchronized with 
        DX NetOps Spectrum
  3. Select the SpectroSERVER under which the new models for devices managed by CA UIM are to be created.
  4. To enable the CA UIM integration for VMware, select VMware Management. (
    Till 10.2.2 and spectrumgtw probe v8.65
    If you are setting up the integration using 10.2.3 and spectrumgtw probe v8.65, you can no longer enable/disable the VMware Management capability from the UIM Configuration page. To enable and configure the VMware Management capability for VMware, please refer to the spectrumgtw AC documentation.
    The following warning message appears:
    VMware message_101.png
  5. To confirm, click 
    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 
    DX NetOps Spectrum
     OneClick console, do not create any container of type '
  6. Click 
    If the test is successful, “
    Test connection to UIM Server was successful
    ”, the message appears.
  7. Click 
    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-
    DX NetOps 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 
DX NetOps Spectrum
 and CA UIM Integration for Virtualization Management from the OneClick Administration page.
From 10.2.3, select the No Integration option from the UIM Configuration page to disable the integration. To disable only VMware integration capabilities you need to disable the VM Server Integration from the VMware Configuration section of the spectrumgtw probe Admin Console. For more information, please refer to the spectrumgtw Admin Console documentation.
Follow these steps(Till 10.2.2):
  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:
  5. Clear both Server and VMware Management options and click 
    The following message appears:
     Disable Integration_101.png
  6. Click Ok, 
    DX NetOps 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.
  7. If you clear the VMware Management checkbox and click 
    The following message appears:
     Disable Confirmation_101.png
  8. Click OK.
    DX NetOps Spectrum
     and CA UIM integration for Virtualization Management is disabled.