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

Starting xclus and xcxclus
To start xclus or xcxclus, follow these steps:
1. Set up the Xtools environment.
2. Set the DISPLAY environment variable.
3. Start the xclus or xcxclus program. If you are using xclus and are running on a
non-cluster system or do not have a job allocation, you must specify the nodes you want to
monitor.
Step 1: Setting Up the Xtools Environment
On systems with the modules utility, enter the following command to set up the Xtools
environment:
% module load xtools
Alternatively, you can manually add the Xtools binary directory (/opt/xtools/bin) to your
PATH
environment variable, and /opt/xtools/man to your MANPATH. For example:
% setenv PATH /opt/xtools/bin:$PATH
% setenv MANPATH /opt/xtools/man:$MANPATH
Step 2: Setting the DISPLAY Environment Variable
The xclus and xcxclus utilities are X11 clients. You must set the DISPLAY environment variable
so the utility can open the appropriate X11 display device. For example:
% setenv DISPLAY myhost:0.0
Step 3: Starting xclus or xcxclus
This section describes how to start xclus or xcxclus.
Starting xclus
On HP XC cluster systems, you can start xclus by entering the following command:
% xclus
By default, xclus determines the nodes in your job allocation when it starts and monitors those
nodes. If a node leaves your job allocation, xclus stops monitoring that node. If you are not
running any jobs, the xclus utility terminates.
Specifying Nodes with xclus
On non-cluster systems, you must specify the nodes you want xclus to monitor. On HP XC
cluster systems, you can specify alternate nodes for xclus to monitor, such as a subset of the
nodes in your job allocation. See
“Specifying Nodes for xclus or xcxclus” (page 79) for
information about specifying nodes for xclus.
Starting xcxclus
To start xcxclus, enter the following command:
% xcxclus
By default, xcxclus determines the nodes in your job allocation when it starts and monitors
those nodes. If a node leaves your job allocation, xcxclus stops monitoring that node. If you
are not running any jobs, the xcxclus utility terminates.
78 Using Xtools