Moogsoft Docs

UIM Configuration

This doc covers the integration steps to provide an alarm integration from UIM to Moogsoft AIOps. The integration has following steps:

  • Add the UIM SDK to Moogsoft AIOps.

  • Create/Identify the queue on the hub which is active and attach the alarm messages

  • Enter the queue name and hub IP/hostname/FQDN in the Monitor section of the uim_lam.conf file.

Knowledge of the SNAP and UIM system is required. The SSL is currently not supported in the UIM LAM.

Add the UIM SDK to Moogsoft AIOps

SNAP/UIM installation has proprietary JAVA SDK included with it. It is used by multiple components in the SNAP or UIM. The SDK jar has to be added to Moogsoft AIOps.

Copy the nimsoft-SDK.jar to the following location in Moogsoft AIOps: $MOOGSOFT_HOME/lib/cots/nonDist.

The nimsoft-SDK.jar can be found in the UIM installation home directory. The SDK jar is located here:

<nimsoft_home>\probes\service\wasp\webapps\nisapi\WEB-INF\lib

The nimsoft-SDK.jar for Linux can be found in the directory system/opt/nimsoft.

The name of the UIM SDK jar can be different for different versions. Fully qualified domain name (FQDN) and hostname entry should be made in the host file.

The nimsoft-SDK.jar can only be used if the user has the UIM license.

UIM Queue creation/selection

The subscribe mechanism enables the client to select alarms based on the alarms subject. A client that is configured to receive UIM alarms sends a subscribe request to the hub. The client then receives alarms matching the subscribed subjects from the hub.

The subscribed alarms are received by the UIM LAM from an attached queue in UIM. If an attached queue is present in UIM then it can be used, otherwise, a new attached queue can be created. The queue is created in the hub view part of the Infrastructure Manager application of UIM.

Note

For UIM SNAP, the Infrastructure Manager application is not available, therefore the steps mentioned below will not be applicable. To get the queue details of UIM SNAP navigate to C:\Program Files\CA\UIM Snap\hub\q . Check if event_management is present; this will be the default queue name

Note

The below-mentioned steps are only applicable for UIM.

Note

The Infrastructure Manager can only be installed on a windows machine. For UIM installed on Linux, the Infrastructure Manager application installed on windows OS and connected to it is used for queue creation.The Infrastructure Manager is accessed by taking a remote connection of the windows machine on which it is installed.

The steps to create a queue are as follows:

  1. Click on the Windows Start button and navigate to All Programs > Nimsoft Monitoring. Click on Infrastructure Manager.

  2. Click on Security and then select Login

  3. Enter the user Credentials in the Login dialog and click on OK.

  4. Navigate to the Robot in the left panel where hub is deployed.

  5. Select the Robot. It displays the probes in the right panel.

  6. Double-click the hub probe to open the hub dialog, then select the Queues tab.

  7. Click the New button in the Queues tab of the hub configuration dialog. The New Queue dialog opens. Complete the details as follows:

    • Name: "Queue_Name"

    • Type: attach

    • Address: Leave blank (not required)

    • Message: alarm2 - Will provide enriched alarm.

      Alarm message can be used but this will not provide an enrichment alarms process by UIM.

  8. Enter the following details in the New Queue dialog and then click OK:

    • Active: Select the check box. If the check box is not selected, then the queue will not send the alarms from UIM

    • Name: Enter the desired name of the queue

    • Type: Select attach. Selecting attach disables the Address and Bulk Size field

    • Address: The field remains disabled

    • Subject: Select alarm

    • Bulk size: It is automatically set to <default> and disabled

  9. The queue is added to the Queues tab in the hub configuration window.

  10. Click Apply in the hub configuration window.

  11. The queue is added to the Queues tab of hub configuration window.

  12. Click on Apply in the hub configuration window.

  13. When prompted to restart the hub, click Yes.

The queue is created and its status can be checked in the Status tab.