NAME
mxstm - add, remove, and list system type manager rules.
SYNOPSIS
mxstm
mxstm -a -n <product name> -p snmp|dmi ( -x <attribute>=<value> )+
mxstm -r -n <product name>
mxstm -a -f <filespec>
mxstm -r -f <filespec>
mxstm -l [ -n <product name> ]
mxstm -l [ -p snmp|dmi [ -f <filespec> ] ]
DESCRIPTION
The mxstm command allows the user to add, remove, and list system type
manager rules for use with Systems Insight Manager.
OPTIONS
mxstm recognizes the following options:
-a Add a new rule. Optionally use the -f option to
import one or more rules in XML format from a
file. The XML file must be encoded in UTF-8 and
must be declared with encoding="UTF-8".
-r Remove an existing rule. Optionally use the -f
option to delete one or more rules in XML format
from a file. The XML file must be encoded in UTF-8
and must be declared with encoding="UTF-8".
-l List rules. Use the -n option to provide a product
name and list rule details. Use the -f option to
output rules in XML format to a file. Optionally
specify a protocol to selectively output rules
matching the specified protocol. The XML file
output by this command is valid input for the -a
and -r options. This option can be used to create
an XML file that can be modified for use with the
-a and -r options. The XML file will be encoded in
UTF-8.
-x <attribute>[=<value>]
Attribute is the name of a protocol specific
attribute and value is the value to be assigned to
the attribute.
-n Product name.
-p Protocol. Should be snmp (snmp or dmi if the
central management server is hosted on a Microsoft
Windows operating system).
-x SNMP Required attributes: sysoid.
SNMP Optional attributes: url, urldesc, type, subtype, osname,
osvendor, osversion, sysoidrule, oid, oidval, oidrule, and
priority.
DMI Required attributes: comp1, group1, sgroup1, attrib1, val1,
and rule1.
DMI Optional attributes: url, type, subtype, comp2, group2,
sgroup2, attrib2, val2, rule2, comp3, group3, sgroup3, attrib3,
val3, rule3, and priority.
The "type" attribute can take values of Cluster, Complex,
Desktop, Enclosure, Env, Handheld, Hub, KVM, MgmtProc, Other,
PDU, Partition, Portable, PowerSupply, Printer, RAS, Rack,
Router, Server, Switch, UPS, Unknown, and Workstation. The
"subtype" attribute can take values of MSCS, NSCUW7, None, OVMS,
PowerEnc, RAC, ServerEnc, TCR_PS, and TruCluster. Attribute
values for "type" and "subtype" attributes are case sensitive.
Compare Rules: StartsWith|Contains|Match|EndsWith|AnyValue
Insufficient or invalid optional attributes will be replaced with
sensible defaults where possible.
RETURN VALUE
Upon completion, mxstm returns:
0 The operation completed successfully.
>0 An error occured during operation.
AUTHOR
mxstm was developed by the Hewlett-Packard Company.
SEE ALSO
/opt/mx/dtd/stmrules.dtd