HP XC System 3.x Software - Manual (Page 79)

Specifying Nodes with xcxclus
By default, you do not need to specify the nodes you want to monitor with xcxclus, and
xcxclus
monitors all the nodes that are in your job allocation when it starts. However, you can
specify nodes with xcxclus to:
• Monitor a subset of nodes in your job allocation.
• Monitor nodes outside of your job allocation. You specify the option -unrestricted-nodes
and must have superuser privileges to do this.
See “Specifying Nodes for xclus or xcxclus” (page 79) for information about specifying nodes
for xcxclus.
Specifying Nodes for xclus or xcxclus
On HP XC cluster systems, you do not have to specify the nodes you want to monitor and xclus
or xcxclus monitors the nodes in your job allocation. However, specifying nodes is useful in
the following cases:
• You are running xclus on a non-cluster system. In this case, you must specify the nodes
you want to monitor.
• You want to monitor a subset of the nodes in your job allocation.
• You want to monitor nodes outside of your job allocation. If you are on an HP XC cluster
system, you must also specify the option -unrestricted-nodes. If you are using xcxclus,
you must have superuser capability to specify this option.
Use one of the following methods to specify nodes:
• Specify the names of the nodes you want to monitor using the -nodes option.
• Create a cluster file and specifying the name of the cluster file name using the -cluster
option.
• Create a cluster file in the current working directory with the name cluster. This method
is successful only if you are running xclus on a standalone system.
Specifying Nodes with -nodes
To specify node names in the run string, use the following syntax:
xclus|xcxclus -nodes node_specification[,node_specification...]
Where:
node_specification
Is a node name, or a node name prefix followed by
[number_specs]
.
number_specs Is a comma-separated list of ranges, and a range is a singleton or a
dash-separated pair. If you use the [number_specs] form, use
the appropriate quotation symbols for your shell.
For example:
% xclus -nodes node1,node2,node3,node4
The following commands are equivalent to each other:
% xclus -nodes 'c1,c3,c5,c6,c7,c9,c12'
% xclus -nodes 'c1,c[3,5-7,9],c12'
% xclus -nodes 'c[1,3,5-7,9,12]'
Creating a Cluster File
A cluster file contains node names, with one node name per line. For example, to monitor node1,
node2
, node3, and node4, create the file cluster that contains the following text:
node1
node2
node3
node4
Starting xclus and xcxclus 79