NAME
mxngroup - add, modify, remove, or list node groups in Systems Insight
Manager
SYNOPSIS
mxngroup -a -g groupname [-d description] [-n [member...]]
mxngroup -a -f filename
mxngroup -m -g groupname [-d description] [-n [member...]]
mxngroup -m -f filename
mxngroup -r -g groupname
mxngroup -r -f filename
mxngroup [-l d|f|m|n] [-g groupname...]
mxngroup [-l d|f|m|n] [-n [member...]]
DESCRIPTION
The mxngroup command allows the user to create, modify, remove, and
list node groups in Systems Insight Manager. Node groups are
collections of nodes that are subsets of the entire node membership of
a Systems Insight Managed Cluster. They may have overlapping
memberships such that a single node may be a member of more than one
group. The node grouping mechanism allows flexible partitioning of a
Systems Insight Managed Cluster into logical collections that match
their use model.
When a node group is created, its attributes and membership may be
specified. When it is modified, its attributes may be selectively
modified and its membership may be reset.
The first two forms of this command allow the user to add node groups
to a Systems Insight Managed Cluster.
The second form allows the information regarding one or more node
groups to be provided in a file. The file must be formatted in the
eXtensible Markup Language (XML) format defined for Systems Insight
Manager node groups. See mxngroup(4).
The third and fourth forms allow the user to modify the information
stored about a node group in a Systems Insight Managed Cluster. As
with adding node groups, the group may be specified on the command
line or in a file. The file must formatted as described previously.
Note that when modifying node groups, Systems Insight Manager also
updates the authorization information related to any authorizations
associated with the modified node group.
The fifth and sixth forms allows the user to remove a node group. The
user may either specify an individual node group or a file containing
multiple node groups. The file must be formatted as described
previously. When an Systems Insight Manager full rights user removes a
node group, the Systems Insight Manager also removes all of the
authorizations associated with the removed node group.
The last two forms allow the user to list node group names and
attributes. The -l option indicates that node group information is to
be listed. With the n argument, node group names are listed, one per
line. The d argument indicates that a detailed listing of node group
names and attributes is desired. The f option results in a listing
that matches the file format used for the -f filename option in the
add and modify commands. The m argument gives a combined list of
members of the node groups, one member per line. The set of node
groups that gets listed may be constrained in two ways. With the -g
option, the names of the desired groups may be specified. The -n
option lists node groups that contain all of the specified members.
By default, all node groups are listed.
Only Systems Insight Manager full rights users may use mxngroup to
add, modify or remove node groups in a Systems Insight Managed
Cluster. Any Systems Insight Manager user may list group information.
File Processing
The mxngroup command allows a full rights user to add, modify, or
remove Systems Insight Manager node groups by specifying an XML file
containing a list of node groups and node group attributes.
The Systems Insight Manager processes the input file data in two
passes.
The first pass attempts to parse the XML file and generate a list of
node groups to process during the second pass. The first pass ensures
that the XML file is formatted properly, that the node group names are
valid, and the node group objects contain valid information. During
the first pass, if the Systems Insight Manager detects a error, the
Systems Insight Manager interrupts the process, issues an error
message describing the error, and leaves the Systems Insight Manager
repository unchanged.
If the Systems Insight Manager successfully processes the XML file in
the first pass, the Systems Insight Manager attempts to process the
node group list collected during the first pass. During this second
pass, the Systems Insight Manager processes the node group list until
it processes the entire list or until the Systems Insight Manager
encounters a logic error, such as specifying a duplicate node group
during an add or specifying a non-existent node group during a modify
or remove.
If an error occurs during the second pass, the Systems Insight Manager
interrupts processing at that point and issues an error message. If
the input file contains valid node group data prior to the invalid
data, the Systems Insight Manager processes that data completely and
modifies the Systems Insight Manager repository appropriately. The
Systems Insight Manager ignores all data subsequent to the invalid
data.
Options
mxngroup recognizes the following options:
-a Indicates that a group is to be added.
-m Indicates that a group is to be modified.
-r Indicates that a group is to be removed.
-l d Displays a detailed and screen-viewable listing of
node group information.
-l f Displays a file-formatted listing of node group
information (see mxngroup(4) ).
-l m Displays the member nodes of the node group.
-l n Displays the names of the node groups.
-f filename Specifies the path and name of the input file for
an add, modify, or remove operation.
-g groupname Specifies the name of the group to be added,
modified, removed, or listed. Node group names
must be 80 characters or less, must start with an
alphabetic character, and after the first
character may contain alphanumeric characters,
underscore (_), dash (-), and period (.)
characters and embedded blank characters.
-n member When used with the -a or -m options, this option
specifies the complete membership of a group that
is added or modified. When used in a listing
command (-l), this option indicates that the node
groups to be listed are the ones that contain the
specified members.
-d description Specifies the description for a group.
Note: When duplicate options are specified (for example, -f file1 -
f file2), the last instance of the option will be used by mxngroup (in
this example, file2).
RETURN VALUE
mxngroup returns one of the following values:
0 Successful completion.
1 Command line syntax error.
2 Error in a file operation.
3 Nonexistent node or node group error.
5 Duplicate name.
21 Invalid name.
50 Unauthorized user.
102 Systems Insight Manager Repository error.
222 Central Management Server (CMS) is not
initialized.
249 Unable to connect to the session manager.
250 Remote exception.
EXAMPLES
The following command creates a node group "group1" containing Systems
Insight Managed Cluster nodes "nodea", "nodeb", and "nodec":
mxngroup -a -g group1 -d "Example node group" -n nodea nodeb
nodec
To modify group "group1" to replace node "nodec" with node "noded",
the following command may be used:
mxngroup -m -g group1 -n nodea nodeb noded
The member nodes of group "group1" may be listed by using:
mxngroup -lm -g group1
The names of all the node groups that contain member "nodeb" may be
listed by using:
mxngroup -ln -n nodeb
or simply:
mxngroup -n nodeb
The following is an example of a legal node group XML file based on
the supported file format. The following example defines a node group
named "group1" with a description and two member nodes, node1.corp.com
and node2.corp.com.
<?xml version="1.0" encoding="UTF-8"?>
<node-group-list>
<node-group name="group1">
<description>This is group1.</description>
<member-node value="node1.corp.com" />
<member-node value="node2.corp.com" />
</node-group>
</node-group-list>
WARNINGS
Only Systems Insight Manager full rights users may use mxngroup to
add, modify or remove node groups in a Systems Insight Managed
Cluster. Any Systems Insight Manager user may display group
information.
LIMITATIONS
This command may only be run on the CMS.
AUTHOR
mxngroup was developed by the Hewlett-Packard Company.
SEE ALSO for HP-UX
mxngroup(4), mxuser(1M), mxnode(1M), mxauth(1M).
SEE ALSO for Linux
mxngroup(4), mxuser(8), mxnode(8), mxauth(8).