In this section:

This section provides procedures for alarm synchronization on the DSC. For more detailed information about alarm synchronization, refer to the REST API User Guide, Alarm Synchronization.

Overview 

Alarm synchronization allows all active alarms stored in the Active Trap List on the DSC, and Event List in SP2000, to be stored in management platforms. Both the DSC and SP2000 have the Element Management System (EMS) and GENView Manager (GVM), respectively, as their default, with an option to use Ribbon Application Management Platform (RAMP)The synchronization is provided using the REpresentational State Transfer (REST) Application Program Interface (API). For information about the REST API and to view the REST API commands, refer to the REST API User Guide, Alarm Synchronization.

Note

This feature does not impact the existing alarm functionality with the exception of two stateless SNMP traps - Alarm acknowledgement update (6665 alarmAckStateUpdate) and Alarm comment update (6666 alarmCommentUpdate).

Single Trap Stream

By default, the DSC sends out two streams of SNMP traps corresponding to the two management nodes. In order to use the REST API, the Single Trap Stream attribute must be enabled.

Enabling the Single Trap Stream attribute on the Web UI results in only one stream of SNMP traps from the management node, which resolves to the high-availability (HA) IP, to be sent out. The HA IP is used as the shared IP between the EMS, or RAMP, and DSC. 

Note

The source IP in the SNMP trap also contains the HA IP.

When registering a DSC node on the EMS or RAMP for the Alarm synchronization, the DSC node should be registered on the HA IP. The REST API handlers will check that the Active Traps attribute and the Single Trap Stream attribute are set for each incoming HTTP request and will return an error in response to the HTTP request if the DSC is not properly configured for this feature. For more information on Alarm State Synchronization, refer to the REST API Guide, Alarm Synchronization.

To receive an SNMP trap, a host needs to be entered in the Trap Host List. This can be accomplished through the DSC Web UI (refer to View SNMP Configuration Information) or SNMP if EMS Access has been enabled (refer to Configure SNMP Community Directives).  

The Single Trap Stream feature is not available on Google Cloud Platform (GCP), as there are no shared IP. 


Configuring Alarm Synchronization on the DSC

The following section provides procedures to enable the alarm synchronization and view active traps.  

To enable Alarm Synchronization

  1. Login to the DSC Web UI.
  2. Under Applications, click SNMP. 

  3. Enable Single Trap Stream attribute. 
    This ensures only one stream of traps with a source IP in the SNMP trap set to HA IP.

  4. Enable DSC REST API attribute. 
    This allows access to the DSC REST API. Once enabled, Active Traps are also enabled by default. 
    This starts populating the Active Trap List container with outstanding alarms in the form of SNMP traps.

    The Event Notification Setup for an alarm requires the SNMP Trap and the Dashboard attributes to have the same value (both ENABLED or both DISABLED) when the Active Traps attribute is enabled. Any mismatch will result in the inability to enable REST API. The only exception to this rule is when either one is set to DISABLED_PERMANENTLY.


      

  5. Click Continue. 

Once the alarm synchronization is enabled, the DSC stores and lists all active traps on Web UI under Active Trap List. There is no limit to the number of traps that can be stored under the Active Trap List.

Note

If an alarm was manually cleared on the DSC before the Active Traps attribute was enabled, the corresponding clear notification will not be sent to the EMS after the Active Traps attribute is enabled.

If you require a previous cleared alarm to be sent to the EMS, you must manually restore the alarm from the Web UI (refer to Restoring Alarms), so the DSC can send a new trap notification to the EMS.


To view an Active Trap List

  1. Login to Web UI.
  2. Click SNMP.

  3. Click Active Trap List.
Note

If an alarm is manually cleared through the EMS, it will be removed from the Active Trap List, but will still be visible under the cleared bucket list on the DSC Web UI.

To view an Active Trap

  1. Login to Web UI.
  2. Click SNMP.
  3. Click Active Trap List.
  4. Select an Active Trap.

The Active Trap screen displays the attributes used to construct the SNMP traps sent out to trap hosts. The Active Trap attributes include the Sequence Number, and Date and Time Stamp that can be used by the EMS to monitor any missing traps that may have dropped because of the connectivity related issues.

Configuring Alarm Synchronization on the SP2000

The following section provides procedures to enable the alarm synchronization and view the SP2K Event List. 

To enable Alarm Synchronization

  1. Login to the SP2000 Web UI.
  2. Under Applications, click SNMP

  3. Enable Single Trap Stream attribute. 
    This ensures only one stream of traps with a source IP in the SNMP trap set to HA IP.

  4. Enable DSC REST API attribute. 
    This allows access to the DSC REST API. 

  5. Choose your EMS Type with the drop-down menu. The options are RAMP and GVM (default). 
    This starts populating the Active Trap List container with outstanding alarms in the form of SNMP traps.

    Tip

    When the EMS Type attribute changes from GVM to RAMP, or vice versa, the SNMP application on the Web UI disappears for a few moments and then reappears. This is a normal behavior. 

    The Event Notification Setup for an alarm requires the SNMP Trap and the Dashboard attributes to have the same value (both ENABLED or both DISABLED) when the Active Traps attribute is enabled. Any mismatch will result in the inability to enable REST API. The only exception to this rule is when either one is set to DISABLED_PERMANENTLY.

To view SP2K Event List

  1. Login to Web UI.
  2. Click SNMP.

  3. Click SP2K Event List. 

To view an SP2K Active Trap

  1. Login to Web UI.
  2. Click SNMP.
  3. Click SP2K Event List. 
  4. Select an Active Trap.

The Active Trap screen displays the attributes used to construct the SNMP traps sent out to trap hosts. The Active Trap attributes include the Sequence Number, and Date and Time Stamp that can be used by the EMS to monitor any missing traps that may have dropped because of the connectivity related issues.