User's Guide
Alarm and Event Administration
The following sections describe how to administer alarms and events:
About alarm and event administration
Alarm and event administration is about reconfiguring the severity level on individual alarms, viewing the alarm list and event log, and deleting old alarm and event entries from the database.
Reconfiguring alarm serverity level
Follow the instruction below to reconfigure an alarm's severity level.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
Check if already reconfigured
- Double-click the getReconfiguredAlarmSeverity method.
- Enter the alarm identifier.
The reconfigured serverity level is displayed. If -1
is displayed, the severity level is not reconfigured.
Change alarm severity level
- Double-click the setReconfiguredAlarmSeverity method.
- Enter the alarm identifier and the new severity level.
The serverity level for the specified alarm is changed.
Listing alarms with reconfigured serverity levels
Follow the instruction below to list all alarms with a reconfigured alarm severity level. The alarm identifiers and the reconfigured severity levels are displayed.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
- Double-click the listReconfiguredAlarmSeverities method.
All alarms with reconfigured serverity levels are displayed.
Removing alarm serverity level reconfiguration for an alarm
Follow the instruction below to remove the reconfigured severity level for an alarm and restore the alarm's default serverity level.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
- Double-click the removeReconfiguredAlarmSeverity method.
- Enter the alarm identifier.
The alarm's default serverity level is restored.
Viewing the alarm list
Follow the instruction below to view the alarm list.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
- Double-click the listAlarms method.
- Specify one or all SLEE services and one or all severity levels using the serviceName and serverity fields. See table below:
Parameter
|
Description
|
serviceName
|
Enter a service name if you want alarms raised by a specific SLEE service.
Leave empty if you want alarms for all SLEE services
|
severity
|
Enter the severity level you are interested in:
0 - all levels
1 - warning
2 - minor
3 - major
4 - critical
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Lists all alarms...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...raised within the specified time period.
|
Date
|
|
...raised after the specified from date.
|
|
Date
|
...raised before the specified to data.
|
|
|
....raised.
|
- Specify a certain alarm type or all alarm types using the identifier field. See table below:
To view:
|
Enter:
|
All alarm types
|
0 (zero)
|
A certain alarm type
|
The alarm type number
|
The specified alarms are displayed.
Deleting alarm entries from the database
Follow the instruction below to delete alarm list entries from the database.
- Start an Network Gatekeeper Management Tool and log in.
- Select any SLEE in the SLEEs pane.
- Double-click the SLEE_alarm service.
- Double-click the deleteAlarms method.
- Specify one or all SLEE services and one or all severity levels using the serviceName and serverity fields. See table below:
Parameter
|
Description
|
serviceName
|
Enter a service name if you want alarms raised by a specific SLEE service.
Leave empty if you want alarms for all SLEE services
|
severity
|
Enter the severity level you are interested in:
0 - all levels
1 - warning
2 - minor
3 - major
4 - critical
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Deletes all alarms...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...raised within the specified time period.
|
Date
|
|
...raised after the specified from date.
|
|
Date
|
...raised before the specified to data.
|
|
|
....raised.
|
- Specify a certain alarm type or all alarm types using the identifier field. See table below:
To delete:
|
Enter:
|
All alarm types
|
0 (zero)
|
A certain alarm type
|
The alarm type number
|
The specified alarms are now deleted from the database.
Viewing the event log
Follow the instruction below to view the event log.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_event service.
- Double-click the listEvents method.
- Specify one or all SLEE services and one or all importance levels using the serviceName and level fields. See table below:
Parameter
|
Description
|
serviceName
|
Enter a service name if you want events raised by a specific SLEE service.
Leave empty if you want alarms for all SLEE services
|
level
|
Enter the importance level you are interested in:
0 - all levels
1 - low
2 - medium
3 - high
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Lists all events...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...recorded within the specified time period.
|
Date
|
|
...recorded after the specified from date.
|
|
Date
|
...recorded before the specified to data.
|
|
|
....recorded.
|
- Specify a certain event type or all event types using the identifier field. See table below:
To view:
|
Enter:
|
All event types
|
0 (zero)
|
A certain event type
|
The event type number
|
The specified events are displayed.
Deleting event entries from the database
Follow the instruction below to delete event log entries from the database.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_event service.
- Double-click the deleteEvents method.
- Specify one or all SLEE services and one or all importance levels using the serviceName and level fields. See table below:
Parameter
|
Description
|
serviceName
|
Enter a service name if you want events raised by a specific SLEE service.
Leave empty if you want alarms for all SLEE services
|
level
|
Enter the importance level you are interested in:
0 - all levels
1 - low
2 - medium
3 - high
|
- Specify a time period using the fromDate and toDate fields. See table below:
fromDate
|
toDate
|
Deletes all events...
|
Date (In format: YYYY-MM-DD hh:mm)
|
Date
|
...recorded within the specified time period.
|
Date
|
|
...recorded after the specified from date.
|
|
Date
|
...recorded before the specified to data.
|
|
|
....recorded.
|
- Specify a certain event type or all event types using the identifier field. See table below:
To delete:
|
Enter:
|
All event types
|
0 (zero)
|
A certain event type
|
The event type number
|
The specified events are now deleted.
Adding an alarm listener
Follow the instruction below to add an alarm listener. Applications acting as alarm listeners must be re-registered if they are restarted.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
- Double-click the addAlarmListener method.
- Enter the following data:
Parameter
|
Description
|
listenerIOR
|
The stringified IOR to an object implementing the alarm listener interface.
|
registerInAllInstances
|
If set to TRUE the listener will be registered with all alarm service instances in the system.
If set to FALSE the alarm listener will only be registered with this instance. That is, only alarms raised by services in this SLEE will be provided.
|
The specified alarm listener is now registered.
Removing an alarm listener
Follow the instruction below to remove an alarm listener.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_alarm service.
- Double-click the removeAlarmListener method.
- Enter the following data:
Parameter
|
Description
|
listenerIOR
|
The stringified IOR to an object implementing the alarm listener interface.
|
removeFromAllInstances
|
If set to TRUE the listener will be removed from all alarm service instances in the system.
If set to FALSE the alarm listener will only be removed from this instance.
|
The specified alarm listener is now removed.
Adding an event listener
Follow the instruction below to add an event listener. Applications acting as event listeners must be re-registered if they are restarted.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_event service.
- Double-click the addEventListener method.
- Enter the following data:
Parameter
|
Description
|
listenerIOR
|
The stringified IOR to an object implementing the event listener interface.
|
registerInAllInstances
|
If set to TRUE the listener will be registered with all event service instances in the system.
If set to FALSE the event listener will only be registered with this instance. That is, only event raised by services in this SLEE will be provided.
|
The specified event listener is now registered.
Removing an event listener
Follow the instruction below to remove an event listener.
- Start an Network Gatekeeper Management Tool and log in.
- Double-click the SLEE_event service.
- Double-click the removeEventListener method.
- Enter the following data:
Parameter
|
Description
|
listenerIOR
|
The stringified IOR to an object implementing the event listener interface.
|
removeFromAllInstances
|
If set to TRUE the listener will be removed from all event service instances in the system.
If set to FALSE the event listener will only be removed from this instance.
|
The specified event listener is now removed.