Integrate with UIM for Virtualization Management

Contents
casp1032
From the 10.1.2 release, the SNMP Gateway probe and SBGW /Southbound gateway are no longer recommended for alarms synchronization from 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
-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 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 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 UIM Integration for Virtualization Management
Consider the following prerequisites for the integration:
If you have enabled
DX NetOps Spectrum
and UIM integration for server management in 9.4, then while upgrading to 10.1.2, you must configure the latest UIM REST API (nisapi_WASP).
If you are integrating UIM with
CA Spectrum
10.1.1 (or earlier), 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 (
    vmware
    ) and SNMP Gateway (
    snmpgtw
    ) probes are configured before enabling the
    DX NetOps Spectrum
    and UIM integration.
  4. All the primary SpectroSERVERs should be up and running while enabling the
    DX NetOps Spectrum
    and UIM integration.
  5. Enable QoS metrics and alarms in UIM for
    DX NetOps Spectrum
    OneClick views and condition-correlation to work.
  6. 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 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 UIM, this port should already be open in a properly functioning UIM environment.
Deploy and Configure Probes
To optimize the
DX NetOps Spectrum
and UIM integration, deploy and configure the following UIM probes on UIM server:
  • snmpgtw
    Sends traps from 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 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 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 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 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 (UIM to
    DX NetOps Spectrum
    and
    DX NetOps Spectrum
    to 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 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 UIM
    • Ticket ID synchronization between
      DX NetOps Spectrum
      and UIM
From 10.2.1, all UIM events (apart from events related to VMWare and servers) are no longer considered as generic events.
Specific events raised on UIM from the following probes are mapped to unique events created in
DX NetOps Spectrum
. This allows you to manage the events (raised on 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 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 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 UIM for Virtualization Management
From the OneClick Administration page, you can enable the integration between
DX NetOps Spectrum
and UIM for Virtualization Management. When you enable the integration all the virtual entities managed by 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
    -UIM Integration is enabled with Multi-tenancy. When the integration is enabled with Multi-tenancy, 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
    -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 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 UIM to
    DX NetOps Spectrum
    . This is applicable to 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 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
        Administration
        ,
        SSL Certificates
        , upload the certificate file then click
        Save
        . Restart the OneClick web server for the changes to take effect.
        Inventory from the group you specify in this field is synchronized from 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 UIM are to be created.
  4. To enable the 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
    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
    DX NetOps Spectrum
    OneClick console, do not create any container of type '
    UIMInventoryContainer
    '.
  6. Click
    Test.
    If the test is successful, “
    Test connection to UIM Server was successful
    ”, the message appears.
  7. Click
    Save.
    Successfully saved configuration to the database message appears.
    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 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 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 UIM integration:
  5. Clear both Server and VMware Management options and click
    Save
    .
    The following message appears:
    Disable Integration_101.png
  6. Click Ok,
    DX NetOps Spectrum
    and UIM integration for both Server Management and Virtualization Management is disabled.
    Wait for the all the 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
    Save.
    The following message appears:
    Disable Confirmation_101.png
  8. Click OK.
    DX NetOps Spectrum
    and UIM integration for Virtualization Management is disabled.