Specifications

Ridgeline Concepts and Solutions Guide
359
The Ridgeline user name is required. All other parameters are optional.
The basic command displays information about the last 300 alarms in the Ridgeline database. By using
filtering options, you can display information about selected alarms. You can specify a time period of
interest as well as characteristics of the alarms you want to include.
You can select alarms based on criteria such as the alarm name, severity, category, source (the IP
address or IP address and port that generated the alarm) and whether the alarm has been
acknowledged. You can combine many of these criteria so that only alarms that meet all your criteria
will be included in the results. For example, you may want to display only critical alarms from a
specific device, or all alarms in a specific category that are not acknowledged.
Table 15 specifies the options you can use with this command:
Table 15: AlarmMgr command options
Option Value Default
-user <username> Ridgeline user name. This option is required. None
-password <password> Ridgeline user password. If the password is blank, do not include
this argument.
No
password
-host <hostname | IP
address>
Ridgeline server hostname or IP address localhost
-port <port> Ridgeline server port number 80
-h <N> Display alarms that occurred within the last N
hours
These options are
mutually exclusive
and may not be
combined
Last 300
alarms
-d <N> Display alarms that occurred N days ago
-y Display alarms that occurred yesterday
-c <category> Display alarms that occur for a specific
category. Category specification is case
insensitive. Must be quoted if category name
includes spaces or other delimiters.
When these
options are
combined, an
alarm must meet
all criteria to be
included in the
results.
Each of these
options may be
specified only
once.
All
categorie
s
-s <severity> Display alarms that occur for a specific
severity. Severity specification is case
insensitive.
All
severity
levels
-dip <IP address> Display alarms that occur for a specific device
as specified by IP address.
All
devices
-p <port> Display alarms that occur for a specific port on
the device specified with the -dip option.
All ports
-an <alarm name> Display alarms that occur for a specific alarm.
Alarm name specification is case insensitive.
Must be quoted if alarm name includes spaces
or other delimiters.
All
alarms
-a Display all acknowledged alarms. All
alarms
-u Display all unacknowledged alarms.
-f <file specification> Name of file to receive output. If you do not specify a path, the file is
placed in the current directory. If the file already exists, it is
overwritten.
Comman
d window
(stdout).