How to switch back from using EMS to using NAS again
search cancel

How to switch back from using EMS to using NAS again

book

Article ID: 199273

calendar_today

Updated On:

Products

DX Unified Infrastructure Management (Nimsoft / UIM) Unified Infrastructure Management for Mainframe CA Unified Infrastructure Management SaaS (Nimsoft / UIM)

Issue/Introduction

We have configured our UIM DEV environment to process alarm messages via EMS upon recommendation via one of the support cases we opened, but it did resolve the issue we were having at that time. Now we are looking to fallback from EMS to NAS to match production. Please let us know the steps to switch back to NAS from EMS.

Environment

  • Release: 9.1.0 or higher environments
  • Component: UIM - EMS
  • nas
  • ems

Cause

  • Customer needed EMS-focused configuration to be reverted back to NAS
  • This may also be required if and when customers (or support) notice that the alarm Subjects in later versions are incorrect
  • This may be evidenced by the nas message Subject showing as alarm1 instead of its correct Subject of alarm2

Resolution

Out of the box/defaults you should see in the hub with nas and ems installed, but not reconfigured for EMS, will display the proper Subjects like this:

 

Here is a quick checklist for message queue Subject names for nas and alarm_enrichment probes with NO EMS being used:

************************************************************

1. alarm_enrichment probe uses a Subject of alarm

2. nas probe uses a Subject of alarm2

So by default, the alarm_enrichment probe uses the "alarm" Subject and forwards messages to the "alarm2" subject for the nas probe.

*************************************************************

Before ems deployment, alarm messages flow through the UIM environment in the following manner:

  • probes and the baseline_engine send alarm messages with the Subject "alarm"
  • The alarm_enrichment probe receives the alarm messages, enriches them with user-defined data, and then changes the alarm message subject to "alarm2"
  • The nas probe receives the alarm2 message and performs further alarm processing


Post-reconfiguration, the alarm message Subjects used should be:

****************************************************************************

1.alarm_enrichment probe: Change the enrichment_subject key via nas Raw Configure mode from "alarm1" to "alarm"

2.nas probe continues to use a Subject of alarm2 (so normally no change is required here)

****************************************************************************

In some cases, if you reconfigure UIM in favor of using the NAS instead of the ems probe in your UIM environment:

The Alarm Routing Service is not 'automatically' removed.

The enrichment_subject in the nas configuration file (nas.cfg) remains or persists as "alarm1" an d that is undesireable.

 

In that case, use the following procedure to ensure that no alarms are lost.

Follow these steps:

This procedure assumes that legacy alarm messages are currently being sent to the ems probe.

If you did not:

a. Change the default routing destination to ems, and/or

b. Configure any routing rules to send alarms to ems,

Then-> Skip to step 3, otherwise:

  1. In the Alarm Routing Service configuration file, change the default destination back to nas and remove any routing rules. This action prevents alarms from getting 'stuck' in the legacy_alarm queue
  2. Enter the Raw Configure menu for the nas probe
  3. Navigate to the setup folder 
  4. Change the enrichment_subject key from "alarm1" to "alarm"
  5. If you had deactivated the nas probe, deploy and reactivate it
  6. Redeploy the correct ems probe version for your DX UIM version

Note that if you are running the spectrumgtw, you must have the ems probe installed on the Primary as well.

Additional Information

In some environments, if you run through the above process but after a restart of the nas/alarm_enrichment, the alarm_enrichment probe reverts back to a Subject of alarm1, follow these steps to avoid that issue:

1. Open nas probe in Raw Configure.
    Change the value of the "enrichment_subject" key (under the setup section) from "alarm1" to "alarm", and save the change.

2. Deactivate the trellis probe, delete trellis probe and delete the trellis probe folder (<UIM>/probes/service/trellis)

3. Deploy the trellis probe to the Primary UIM hub and Activate it.

4. Deploy nas-api-service package to the Primary UIM hub (this only applies to UIM v9.02 or earlier DX UIM releases)

5. (Spectrum Gateway probe Users only!) Deploy Spectrum UIM Services package to the Primary UIM hub.

(*) The version of 'Spectrum UIM Services' package should match the version of the Spectrum Gateway probe.

6. Open hub probe GUI in the Primary hub, go to [Queues] tab, highlight [alarm-routing-service] queue, delete the queue and save it.

7. Lastly, empty the alarm-routing-service queue a few times until all the queued alarms in that queue are gone. Do this via the Hub Status tab and after a hub restart, the queue will disappear from the Status Tab window and this is the expected result.

Then alarm_enrichment will no longer revert back to the message Subject of alarm1!

Shown below is a screenshot of the hub GUI in IM showing an example of the default queues and their expected message Subjects for reference.

nas default message Subject is always 'alarm2,' and alarm_enrichment is 'alarm.'

Powered by Wolken Software