9 - C H A P T E R -

C H A P T E R 9

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

How to Displ ay Information About Published
Names (-T)

Use the -T option:

% mpinfo -T

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 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to Displ ay 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.8   10   748.07 1459 10.54 10.62 10.66

node1 y  all       SunOS 5.8   10   811.63 1492 10.51 10.53 10.55

node2 y  all       SunOS 5.8   10   715.10 1432 10.87 10.88 10.91

node3 y  all       SunOS 5.8   10   837.91 1514 10.06 10.24 10.31

The fields in the output are described in TABLE 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to Display Information About the Current Cluster (-C)

Use the -C option (upper case):

% mpinfo -C

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 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to D isplay 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 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to Display Information About All
Partitions (-P)

Use the -P option (upper case):

% mpinfo -P

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 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to Display In formation 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 node0,node1 NAME  UP PARTITION OS    OSREL NCPU FMEM   FSWP    LOAD1 LOAD5 LOAD1

node0 y  p0        Solaris 8   1    0.89   158.34  0.09  0.11  0.13

node1 y  p0        Solaris 8   1    31.41  276.12  0.00  0.01  0.01

The fields in the output are described in TABLE 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How to Display Info rmation About All Nodes
(-N)

Use the -N option (upper case).

% mpinfo -N

For example:

% mpinfo -N NAME  UP PARTITION OS    OSREL NCPU FMEM   FSWP    LOAD1 LOAD5 LOAD1

node0 y  p0        Solaris 8   1    0.89   158.34  0.09  0.11  0.13

node1 y  p0        Solaris 8   1    31.41  276.12  0.00  0.01  0.01

node2 y  p1        Solaris 8   1    25.59  279.77  0.00  0.00  0.01

node3 y  p1        Solaris 8   1    25.40  279.88  0.00  0.00  0.01

The fields in the output are described in TABLE 9-1.

Include the -A option to restrict the output to a particular attribute or set of attributes. (See How to Restrict Output to Individual Attributes (-A).)

How 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)

...

How 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 9-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.8   10   750.19 1527 10.52 10.66 10.70

node1 y  all       SunOS 5.8   10   816.07 1576 10.55 10.59 10.61

node2 y  all       SunOS 5.8   10   721.84 1524 10.91 10.95 10.96

node3 y  all       SunOS 5.8   10   840.41 1596 10.42 10.42 10.40

% mpinfo -N -A name

NAME

node0

node1

node2

node3


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`).
	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`).
Node (continued)	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`).

How to Displ ay 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.8   10   839.30 1610 10.18 10.57 10.65

node1 y  all       SunOS 5.8   10   900.45 1646 10.12 10.47 10.54

node2 y  all       SunOS 5.8   10   802.66 1592 10.42 10.78 10.84

node3 y  all       SunOS 5.8   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.8 (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`)


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`

What You Can Do

Command Reference (mpinfo)

Command Reference (`mpinfo`)