NetIQ Documentation: Operations Center 5.5 Server Configuration Guide - Controlling Display of Alarms

11.7 Controlling Display of Alarms

11.7.1 Configuring Maximum Alarms

For performance reasons, Operations Center software is set by default to restrict the maximum number of alarms displayed in the Operations Center Console and the dashboard.

The Operations Center Console does not send requests to the Operations Center server for alarms of any nodes whose alarm flags are set to False.

To change the default setting for alarms limits:

Add the HyperQuery.NumPoints.SizeLimit property to the /OperationsCenter_install_path/config/Formula.custom.properties file.

For example, the following code sample illustrates the entry to limit the number of alarms to 1000:
```
HyperQuery.NumPoints.SizeLimit=1000
```
Start/Restart the Operations Center server.

11.7.2 Limiting the Roll Up of Alarms to Root Elements

For performance reasons, Operations Center software is set to restrict the roll up of alarms to the Enterprise, Elements, Locations, Services, and Service Models root elements. Significant performance impact can occur if users attempt to view all alarms for the entire Operations Center server (such as at the Enterprise root). The roll up of alarms is allowed to the Administration root element, which is useful when auditing is enabled.

To change the default system behavior for alarms roll‑up:

Stop the Operations Center server.
Update the /OperationsCenter_install_path/config/Formula.custom.properties file.

For example, the following code samples illustrate the entries for the Enterprise and Elements root nodes, which set the roll up of alarms to those elements:
```
# If set to false, alarms will not show at the enterprise level.
Server.showEnterpriseAlarms=true
```
```
# If set to false, alarms will not show at the Elements root.
Server.showElementsRootAlarms=true
```
When flags are set to True, users can view all alarms under the root element. However, setting these flags to True can significantly impact performance when retrieving every alarm for the entire Operations Center system (for example, at the Enterprise root).

If any of the showRootElementAlarms flags are set to False, all users are denied the ability to view a roll up of alarms at the corresponding root element. This includes new real time alarms, as well as historical alarms. The Alarms view can be selected, but the data display is empty.
Start the Operations Center server.

11.7.3 Displaying a Message for Paused Alarms

In the Alarms view, when the user selects an alarm, Operations Center software dynamically pauses all updates. The status bar in the bottom left of the Operations Center console displays a PAUSED message with the corresponding date and time:

Figure 11-5 Alarm Status Bar

Also, the Resume button on the Alarms view toolbar blinks when alarms are paused.

To emphasize that the Alarms view is paused, use a script to display a pop‑up alert when the Alarms view is in Pause mode for a specified amount of time.

Displaying the alert requires using two scripts from the script repository:

/OperationsCenter_install_path/database/scripts/util/pauseStop_op.fs

/OperationsCenter_install_path/database/scripts/util/pause_op.fs

For more information about using these scripts, refer to instructions at the top of the pause_op.fs file.

11.7.4 Resuming Alarms after Pause

Custom settings can be made that control the Resume behavior in the Alarms view.

To customize the Resume behavior for alarms:

Edit the /OperationsCenter_install_path/html/client/template/launch.jnlp file, then add the following property assignment in the resources section:
```
<property name="Client.alarm.resume.delay" value="‑1/">
```
Do one of the following:
- Set the value to ‑1 to pause alarms until the Resume toolbar button is clicked.
- Set the value to 0 to resume alarms when the Alarms view closes.
- Set the value to any number greater than one (1, 2, …N) to resume alarms after the specified number of seconds.
Run the Operations Center Configuration Manager and click Apply.

For more information on the Operations Center Configuration Manager, see the Operations Center 5.5 Server Configuration Guide.

11.7.5 Pause Alarms on Right-Click

Custom settings can be made to pause the Alarms View and halt the visual update of alarm data when using right-click operations. This ensures that a right-click operation does not lose it’s context if new alarm data is being received.

To halt alarm refresh for alarms on right-click:

Edit the /OperationsCenter_install_path/html/client/template/launch.jnlp file, then add the following property assignment in the resources section:
```
<property name="Client.alarm.pause.right.click" value="true"/>
```
Alarms are paused for right-click operations. For information on setting Client.alarm.resume.delay property to resume alarms after a specified time, see Section 11.7.4, Resuming Alarms after Pause.
Run the Operations Center Configuration Manager and click Apply.

For more information on the Operations Center Configuration Manager, see the Operations Center 5.5 Server Configuration Guide.