Sun HPC ClusterTools 6 Software User's Guide
|
   
|
Displaying Information With mpinfo
|
What You Can Do
|
Task
|
Option
|
|
How to display information about published names
|
-T
|
|
How to display information about any cluster
|
-c
|
|
How to display information about the current cluster
|
-C
|
|
How to display information about individual partitions
|
-p
|
|
How to display information about all partitions
|
-P
|
|
How to display information about individual nodes
|
-n
|
|
How to display information about all nodes
|
-N
|
|
How to display an online list of valid attributes
|
-lc -lp -ln
|
|
How to restrict output to individual attributes
|
-A
|
|
How to display information in verbose mode
|
-v
|
 To Display Information About Published
Names (-T)
|
Use the -T option:
The name, associated port value, and the jid of the publishing job are displayed. For example:
% mpinfo -T
JID NAME PORT
14 bachelor xxx.xxx.xxx.xxx:48944
14 biker xxx.xxx.xxx.xxx:48944
14 centralia xxx.xxx.xxx.xxx:48944
14 rockstar xxx.xxx.xxx.xxx:48944
18 freddie xxx.xxx.xxx.xxx:501
18 lackluster xxx.xxx.xxx.xxx:503
18 bennie xxx.xxx.xxx.xxx:505
18 stellar xxx.xxx.xxx.xxx:507
|
The fields in the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About Any
Cluster (-c)
|
Use the -c option:
% mpinfo -c [cluster] -C | -P | - N
|
If you do not enter a cluster, the command uses the cluster named by the SUNHPC_CLUSTER environment variable. If that environment variable has not been set, be sure to manually enter a cluster, or the command fails.
Use one of the three options -C, -P, or -N to indicate the type of information you want to display (cluster-level, partition, or node). Use only one option at a time. For example:
% mpinfo -c hpc-cluster-0 -C
NAME ADMINISTRATOR DEF_INTER_PART
hpc-cluster-0 - all
% mpinfo -c hpc-cluster-0 -P
NAME NODES: Tot(cpu) Enb(cpu) Onl(cpu) ENA LOG MP
all 1(28) 1(28) 1(28) yes yes yes
% mpinfo -c hpc-cluster-0 -N
NAME UP PARTITION OS OSREL NCPU FMEM FSWP LOAD1 LOAD5 LOAD15
node0 y all SunOS 5.10 10 748.07 1459 10.54 10.62 10.66
node1 y all SunOS 5.10 10 811.63 1492 10.51 10.53 10.55
node2 y all SunOS 5.10 10 715.10 1432 10.87 10.88 10.91
node3 y all SunOS 5.10 10 837.91 1514 10.06 10.24 10.31
|
The fields in the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About the Current Cluster (-C)
|
Use the -C option (upper case):
This option is a shortcut for a common use of the -c option:
% mpinfo -C
NAME ADMINISTRATOR DEF_INTER_PART
hpc-cluster-0 - all
% mpinfo -c hpc-cluster-0 -C
NAME ADMINISTRATOR DEF_INTER_PART
hpc-cluster-0 - all
|
The fields in the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About Individual Partitions (-p)
|
Use the -p option:
% mpinfo -p partition-name[,partition-name ...]
|
Separate multiple partition names with a comma. You can also enclose the set of partition names in quotation marks.
For example:
% mpinfo -p part1,part2
NAME NODES: Tot(cpu) Enb(cpu) Onl(cpu) ENA LOG MP
part1 1( 4) 1( 4) 1( 4) no yes yes
part2 1( 4) 1( 4) 1( 4) yes yes yes
|
The fields of the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About All
Partitions (-P)
|
Use the -P option (upper case):
For example:
% mpinfo -P
NAME NODES: Tot(cpu) Enb(cpu) Onl(cpu) ENA LOG MP
part10 1( 4) 1( 4) 1( 4) no yes yes
part11 1( 4) 1( 4) 1( 4) yes yes yes
|
The fields of the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About Individual Nodes (-n)
|
Use the -n option:
% mpinfo -n node-name[,node-name...]
|
When listing multiple node names, separate the names with commas but no spaces. For example:
% mpinfo -n node1,node2
NAME UP PARTITION OS OSREL NCPU FMEM FSWP LOAD1 LOAD5 LOAD15
node1 y all SunOS 5.10 2 2252 7935 0.04 0.03 0.03
node2 y all SunOS 5.10 2 2084 7743 0.03 0.02 0.02
|
The fields in the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display Information About All Nodes
(-N)
|
Use the -N option (upper case).
For example:
% mpinfo -N NAME UP PARTITION OS OSREL NCPU FMEM FSWP LOAD1 LOAD5 LOAD1
node0 y p0 SunOS 5.10 1 0.89 158.34 0.09 0.11 0.13
node1 y p0 SunOS 5.10 1 31.41 276.12 0.00 0.01 0.01
node2 y p1 SunOS 5.10 1 25.59 279.77 0.00 0.00 0.01
node3 y p1 SunOS 5.10 1 25.40 279.88 0.00 0.00 0.01
|
The fields in the output are described in TABLE 10-1.
Include the -A option to restrict the output to a particular attribute or set of attributes. (See To Restrict Output to Individual Attributes (-A).)
To Display an Online List of Valid
Attributes (-lc, -lp, -ln)
|
Use the -lc, -lp, or -ln options for clusters, partitions, or nodes:
% mpinfo -lc
% mpinfo -lp
% mpinfo -ln
|
For example:
% mpinfo -lc
name cluster name (NAME)
admin cluster administrator (ADMINISTRATOR)
definter default interactive partition (DEF_INTER_PART)
% mpinfo -lp
name partition name (NAME)
enabled partition state (ENA)
nodes node count (NODES: Tot(cpu) Enb(cpu) Onl(cpu))
maxt max total procs (MAXT)
login logins allowed (LOG)
mp mp jobs allowed (MP)
% mpinfo -ln
cpu_idle idle cpu idle time (%) (IDLE)
cpu_iowait iowait cpu iowait time (%) (IWAIT)
cpu_kernel kernel cpu kernel time (%) (KERNL)
cpu_type cpu cpu architecture (CPU)
...
|
To Restrict Output to Individual Attributes (-A)
|
Add the -A option to other mpinfo options to restrict the output to specific attributes of a node, partition, or cluster:
% mpinfo -p partition -A attribute[,attribute...]
% mpinfo -P -A attribute[,attribute...]
% mpinfo -n node -A attribute[,attribute...]
% mpinfo -N -A attribute[,attribute...]
% mpinfo -c cluster [-C | -P | -N] -A attribute[,attribute...]
% mpinfo -C partition -A attribute[,attribute...]
|
Separate multiple partition attributes with commas but no spaces. For a list of valid attributes, see TABLE 10-1.
This example begins by showing the full set of node attributes displayed when you identify the object (in this case with the -N option), but leave out the -A option. Then it shows how adding the -A option restricts the list to a subset of the information:
% mpinfo -N
NAME UP PARTITION OS OSREL NCPU FMEM FSWP LOAD1 LOAD5 LOAD15
node0 y all SunOS 5.10 10 750.19 1527 10.52 10.66 10.70
node1 y all SunOS 5.10 10 816.07 1576 10.55 10.59 10.61
node2 y all SunOS 5.10 10 721.84 1524 10.91 10.95 10.96
node3 y all SunOS 5.10 10 840.41 1596 10.42 10.42 10.40
% mpinfo -N -A name
NAME
node0
node1
node2
node3
|
TABLE 10-1 Attributes D isplayed by -A option to mpinfo
|
Object
|
Attribute
|
Description
|
|
Partition
|
NAME
|
Name of the partition
|
|
|
NODES
|
Information about the nodes in the partition:
Tot - total number of nodes
Enb - number that are enabled
Onl - number currently online
ENA - whether the partition is enabled (YES/NO)
LOG - whether the node accepts logins (YES/NO)
MP - whether the node accepts multinode jobs (YES/NO)
|
|
|
MAXT
|
Maximum number of simultaneously running processes allowed on each node of the partition
|
|
Cluster
|
NAME
|
Name of the cluster (host name of the master node)
|
|
|
ADMINISTRATOR
|
Name of the cluster's administrator
|
|
|
DEF_INTER_PART
|
Default interactive partition
|
|
Node
|
cpu_idle
|
Percent of time CPU is idle (IDLE).
|
|
|
cpu_iowait
|
Percent of time CPU spends waiting for
I/O (IWAIT).
|
|
|
cpu_kernel
|
Percent of time CPU spends in kernel (KERNL).
|
|
|
cpu_type
|
CPU architecture (CPU).
|
|
Node (continued)
|
cpu_user
|
Percent of time CPU spends running user's program (USER).
|
|
|
domain
|
DNS domain.
|
|
|
enabled
|
If set, node is available for spawning jobs on it.
|
|
|
load1
|
Load average for the past minute (LOAD1).
|
|
|
load5
|
Load average for the past five minutes (LOAD5).
|
|
|
load15
|
Load average for the past 15 minutes (LOAD15).
|
|
|
manufacturer
|
Hardware manufacturer (MANUFACTURER).
|
|
|
mem_free
|
Node's available RAM (in Mbytes) (FMEM).
|
|
|
mem_total
|
Node's total physical memory (in Mbytes) (MEM).
|
|
|
name
|
Name of the node (NAME).
|
|
|
ncpus
|
Number of CPU modules in the node (NCPU).
|
|
|
os_arch_kernel
|
Node's kernel architecture (MACH).
|
|
|
os_max_proc
|
Maximum number of processes allowed on the node (note that this is all processes, including cluster daemons) (MPROC).
|
|
|
os_name
|
Name of the operating system running on the node (OS).
|
|
|
os_release
|
Operating system's release number (OSREL).
|
|
|
os_release_maj
|
The major number of the operating system release number (MAJ).
|
|
|
os_release_min
|
The minor number of the operating system release number (MIN).
|
|
|
os_version
|
Operating system's version (OSVER).
|
|
|
partition
|
The partition of which the node is a member (PARTITION).
|
|
|
serial_number
|
Hardware serial number (SERIAL).
|
|
|
swap_free
|
Node's available swap space (in Mbytes) (FSWP).
|
|
|
swap_total
|
Node's total swap space (in Mbytes) (SWAP).
|
To Display Information in Verbose Mode
(-v)
|
Add the -v option to any other option to display its information in verbose mode: Verbose mode displays a little more information than standard mode, and makes it easier to read. This example shows how the information is displayed first without, and then with the verbose mode:
% mpinfo -p partition -v
% mpinfo -P -v
% mpinfo -n node -v
% mpinfo -N -v
% mpinfo -c cluster [-C | -P | -N] -v
% mpinfo -C partition -v
|
% mpinfo -N
NAME UP PARTITION OS OSREL NCPU FMEM FSWP LOAD1 LOAD5 LOAD15
node0 y all SunOS 5.10 10 839.30 1610 10.18 10.57 10.65
node1 y all SunOS 5.10 10 900.45 1646 10.12 10.47 10.54
node2 y all SunOS 5.10 10 802.66 1592 10.42 10.78 10.84
node3 y all SunOS 5.10 10 927.55 1676 10.11 10.48 10.48
% mpinfo -N -v
Node "node0":
LPM Interfaces: shm,tcp
State: enabled & online
partition: "all"
os: SunOS 5.10 (Generic_108528-07)
arch: sun4u, cpu: sparc, ncpus: 10
manufacturer: Sun_Microsystems, serial no: 809deb49
memory: 1280.000M (775.727M free), swap: 1932.539M (1579.609M free)
isalist: sparcv9+vis sparcv9 sparcv8plus+vis sparcv8plus sparcv8 sparcv8-fsmuld sparcv7 sparc
load averages: 10.53, 10.57, 10.64
cpu states: 0.00% idle, 46.31% user, 53.69% kernel, 0.00% iowait
local attributes:
Node "node1":
LPM Interfaces: shm,tcp
State: enabled & online
partition: "all"
.
.
.
|
Command Reference (mpinfo)
TABLE 10-2 Options for mpinfo
|
Command
|
Description
|
|
-T
|
Display name publishing information
|
|
-c
|
Display cluster-level, partition, or node information about any cluster
|
|
-C
|
Display cluster-level information about the current cluster; equivalent to mpinfo -c cluster-name -C
|
|
-p
|
Display information about individual partitions
|
|
-P
|
Displays information about all partitions in the cluster
|
|
-n
|
Displays information about individual nodes
|
|
-N
|
Displays information about all nodes in the cluster
|
|
-lc
|
List the cluster attributes that can be displayed by -A
|
|
-lp
|
List the partition attributes that can be displayed by -A
|
|
-ln
|
List the node attributes that can be displayed by -A
|
|
-A
|
Restrict the display of cluster, partition, or node information to individual attributes--must combine with one of these options: -c -C -p -P -n -N
|
|
-v
|
Display information in verbose mode--must combine with one of these options: -c -C -p -P -n -N
|
| Sun HPC ClusterTools 6 Software User's Guide
|
819-4131-10
|
|
Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.