NAME
mxnode - add, modify, identify, remove, or list nodes in Systems
Insight Manager
SYNOPSIS
mxnode -a hostname(s)|ipaddress(es) Identify and add node(s)
mxnode -a -f filename Identify and Add node(s)
from XML file
mxnode -a -m -f filename Add and/or modify node(s)
from XML file
mxnode -m -f filename Identify and modify
node(s) from XML file
mxnode -r nodename(s) Remove node(s)
mxnode -r -f filename Remove node(s) from XML
file
mxnode -ln [systemname(s)] List system name(s) from
the repository
mxnode -ld [systemname(s)] List system(s) from the
repository in detailed format
mxnode -lt [systemname(s)] List system(s) from the
repository in tabular format
mxnode -lf [systemname(s)] List system(s) from the
repository in XML format
DESCRIPTION
The mxnode command allows the user to add, modify, remove or list
systems in Systems Insight Manager.
When a system is added to the Systems Insight Manager repository with
the -a option, mxnode stores the system name, the fully-qualified
network hostname (if such a name exists), and an IP address as
attributes of the system.
Then the system will also be "identified",meaning that it will be
examined via the SNMP and/or the WBEM management protocols to
determine the device type, the operating system type and revision, and
other information needed to correctly determine which tools may be
appropriate to use with a given system. Like the system name,
hostname and IP address, the information collected during system
identification will also be stored in system attributes. Since it can
take some time to gather this information, it could take up to 30
seconds for a system to appear in a list results.
Successful system identification will depend upon system access
credentials which must be set prior to running mxnode. See
mxnodesecurity(1M) for details about how to specify system access
credentials.
Systems may be specified either on the command line or in XML
(filename may be either a file name or "-", which means the standard
input). The -a option requires either a hostname or an IP address,
since it has to do with systems that have not yet been added to the
Systems Insight Manager repository. Other options that operate on
systems that have already been added, such as -m, require the system
name rather than the hostname or IP address (though mxnode can look up
the system name if either the hostname or the IP address is provided
in XML input). One option, -r, requires that the system name be
explicitly specified, either on the command line or in XML, as a
safeguard to make sure that only the intended systems are removed.
The XML format is documented in mxnode(4). To see an example, enter
"mxnode -lf mysystem", substituting one of your system names for
"mysystem".
The -r option allows the user to remove a system from the Systems
Insight Manager repository. The system to be removed must be
specified by its system name, not its systemname or IP address.
Removing a system only removes its context from the Systems Insight
Manager repository. The CMS itself cannot be remove, nor can non-empty
container systems.
During the removal process, the Systems Insight Manager system is
removed from all Systems Insight Manager system groups, and all
Systems Insight Manager authorizations (see mxauth(1M)) for the system
are removed.
It is not an error to remove a system from the Systems Insight Manager
repository while an Systems Insight Manager task is running on the
system. The Systems Insight Manager does not terminate the task on the
system; task results and status are sent to the Systems Insight
Manager when the task completes.
As with adding, modifying or listing systems, systems may be specified
on the command line or in a file.
The -l* forms of this command allow Systems Insight Manager system
information to be listed. Specifying no options with this command
provides a listing of system names with no other information. This
listing is the same as the -l option with the n qualifier. The -l
option with the d qualifier provides a detailed screen-viewable
listing of the systems. The -l option with the t qualifier provides a
tabular listing of systems with detailed information. The -l option
with the f qualifier provides an XML listing of the systems.
Only Systems Insight Manager full rights users may use mxnode to add,
modify or remove systems. Any Systems Insight Manager user may
display Systems Insight Manager system information.
System Attributes
The following are predefined system attributes:
System name The system name is by default the same as the
hostname, if a hostname exists, or else the IP
address. The system name may be anything as long
as it is unique among all the systems in the
repository, and it may be changed.
Host name The hostname available from gethostbyname(1). It
may have embedded spaces and its maximum length is
16 characters. Hostnames are not case sensitive
and are represented internally as fully-qualified
names.
IP address The IP address corresponding to the hostname.
OS name This is the name of the operating system on the
managed system.
OS revision This is the revision level of the operating
system.
OS revision text
This is the operating system revision with
vendor-specific descriptive information.
OS vendor This is the operating system vendor.
Protocols These are the management protocols supported by
the managed system, with the revision level of
each protocol.
Management URL This is the management home page URL.
GUID The GUID is a unique identifier assigned to a
system in the repository.
Hardware device ID
The hardware device ID is another unique
identifier assigned to the hardware-specific
portion of a system in the repository.
Device type This is the major type of the device.
Device subtype This is a subtype of the device within the major
type.
Model This is the device model.
Added By This is the login of the Systems Insight Manager
user who added the system.
Added Date This is the date and time the system was added.
In addition to the above predefined options, Systems Insight Manager
plug-in extension applications may define their own system attributes.
Options
mxnode recognizes the following options:
-a hostname(s)|ipaddress(es)
Indicates that one or more Systems Insight Manager
systems are to be added. The operand for this
option may be either a hostname or an IP address.
Hostnames may or may not be fully qualified, and
will be resolved internally by Systems Insight
Manager. Identification will also run.
-m systemname(s)
Indicates that one or more Systems Insight Manager
systems are to be modified and re-identified. The
operand for this option may be a system name, if
used in conjunction with -i, or an XML file name
must also be specified via -f.
-f filename Indicates that systems to be added, modified,
removed or listed are specified in filename. The
contents of this file are described in "XML
format", below.
-l d systemname(s)
Displays a detailed listing of Systems Insight
Manager system attributes for the specified system
or all systems.
-l n systemname(s)
Displays a simple listing of Systems Insight
Manager system names for the specified system or
all systems.
-l t systemname(s)
Displays a tabular listing of Systems Insight
Manager system attributes for the specified system
or all systems.
-l f systemname(s)
Displays an XML listing of Systems Insight Manager
system attributes for the specified system or all
systems. The output from this option produces a
format suitable for use as the contents of the
filename for the -f option. This format is
described in "XML format", below.
-r Indicates that Systems Insight Manager systems are
to be removed.
RETURN VALUE
mxnode returns one of the following values:
0 Successful completion.
1 Command line syntax error.
2 Error in a file operation.
3 Undefined system error.
5 Duplicate system error.
6 Nonexistent user error.
7 System is locked error.
8 Nonexistent system group error.
21 Invalid name.
31 Unknown network host.
33 Missing mxnode plug-in identification collector.
38 Undefined node name.
50 Unauthorized user.
102 Systems Insight Manager Repository error.
221 Authentication failure.
222 Central Management Server (CMS) is not
initialized.
224 System installation error.
249 Unable to connect to the session manager.
250 Remote exception.
252 File input parsing error.
253 Duplicate name.
254 Systems Insight Manager Properties file error.
EXAMPLES
This example indicates that the nodes defined in the file
"new_nodes.xml" are to be identified and added.
mxnode -ai -f new_nodes.xml
The contents of the file "new_nodes.xml" might look like:
<?xml version="1.0" encoding="UTF-8"?>
<node-list>
<node name="azul" host-name="azul.mycompany.com" />
<node>
<sw-attribute name="IPAddress">192.1.1.1</sw-attribute>
</node>
<node name="maple" />
</node-list>
This example removes node "azul" from the repository.
mxnode -r azul
This example lists, in detailed format, all attributes for Systems
Insight Manager node "azul".
mxnode -ld azul
The output might look like the following:
Node name: azul
Host name: azul.mycompany.com
IP addresses: 192.1.2.3
OS name: HPUX
OS revision: 11.00
OS revision text: 11.00
OS vendor: HP
Protocols: SNMP:1.0
Management URL:
GUID: 00000000864162de0f07e31d86c00000
Hardware device ID: 00000000864162de0f07e31d86b00000
Device type: UnixWorkstation
Device subtype: HP9000
Model: 9000/785
Added by: root
Added on: Sep 24, 2002 4:15:46 PM
This example lists, in a tabular format, a subset of Systems Insight
Manager node attributes for all nodes in the repository.
mxnode -lt
The output might look like the following:
NAME HOST NAME OS NAME ADDED ON IP
ADDRESSES
azul azul.mycompany.com HPUX Sep 24, 2002 4:15:46 PM
192.1.2.3
verde verde.mycompany.com Linux Sep 24, 2002 4:15:47 PM
192.1.2.4
This example removes all nodes from the repository by creating an XML
listing and then using that to indicate which nodes to remove:
mxnode -lf | mxnode -r -f-
This example lists a node in XML format:
mxnode -lf azul
The output might look like the following:
<?xml version="1.0" encoding="UTF-8"?>
<node-list>
<node name="azul" guid="00000000868162fe0f07e31d86400000"
host-name="azul.mycompany.com">
<hw-attribute name="DeviceType">UnixWorkstation</hw-
attribute>
<hw-attribute name="DeviceSubType">HP9000</hw-attribute>
<hw-attribute name="Model">9000/785</hw-attribute>
<hw-attribute name="ProcessorFamily">pa-risc</hw-
attribute>
<sw-attribute name="OSName">HPUX</sw-attribute>
<sw-attribute name="OSVendor">HP</sw-attribute>
<sw-attribute name="OSRevision">11.00</sw-attribute>
<sw-attribute name="IPAddress">192.1.2.3</sw-attribute>
<sw-attribute name="ProtocolSupport">SNMP:1.0</sw-
attribute>
<sw-attribute name="Description">HP-UX phoenix B.11.00 A
9000/785 2004682655</sw-attribute>
<sw-attribute name="SystemName">azul.mycompany.com</sw-
attribute>
</node>
</node-list>
LIMITATIONS
This command may only be run on the CMS.
FILE PROCESSING
If Systems Insight Manager detects a formatting error while processing
an input file, the Systems Insight Manager will not make any changes
to the Systems Insight Manager domain based on the input file. Systems
Insight Manager will interrupt processing and issue an error message
describing the formatting error.
AUTHOR
mxnode was developed by the Hewlett-Packard Company.
SEE ALSO for HP-UX
mxngroup(1M), mxauth(1M), mxuser(1M), mxinitconfig(1M),
mxnodesecurity(1M), mxnode(4).
SEE ALSO for Linux
mxngroup(8), mxauth(8), mxuser(8), mxinitconfig(8), mxnodesecurity(8),
mxnode(4).