Table of Contents

NAME

lsmon - display and update load information of the hosts in a LSF cluster

SYNOPSIS

lsmon [ -h ] [ -V ] [ -N | -E] [ -n num_hosts ] [ -R res_req ] [ -I index_list ] [ -i interval ] [ -L logfile ] [ host_name ... ]

DESCRIPTION

lsmon is a full-screen LSF monitoring utility that displays and updates the load information of the hosts in an LSF cluster. A sorted table of load information is displayed and updated periodically. The load information that is displayed includes the following fields:

HOST_NAME
The name of the hosts which specified by host_name or selected by the resource requirement string res_req.

status
The status of the host. Possible values are: ok, busy, lockW, lockU, and unavail. A minus sign (-) may proceed the status, indicating that the Remote Execution Server (RES) on the host is not running. See lsload(1) for a detailed explanation of host status.

r15s
The 15-second exponentially averaged CPU run queue length.

r1m
The 1-minute exponentially averaged CPU run queue length.

r15m
The 15-minute exponentially averaged CPU run queue length.

ut
The CPU utilization exponentially averaged over the last minute, between 0 and 1.
pg
The memory paging rate exponentially averaged over the last minute, in pages per second.
io
The disk I/O rate exponentially averaged over the last minute, in Kbytes per second.
ls
The number of current login users.
it
The idle time of the host (keyboard not touched on all logged in sessions), in minutes.

swp
The amount of currently available swap space, in Mbytes.

mem
The amount of currently available memory, in Mbytes.

tmp
The amount of free space in /tmp, in Mbytes.

While the program is running, the following commands are valid:

^L
Refresh the screen
i
Prompt you to input a new update interval
n
Prompt you to input a new number of hosts to display
N
Toggle between displaying CPU run queue load indices in normalized load and raw load.
E
Toggle between displaying CPU run queue load indices in effective load and raw load.
R
Prompt you to input new resource requirements
q
Quit the program

OPTIONS

-h Print command usage to stderr and exit.

-V Print LSF release version to stderr and exit.

-N The returned CPU run queue load indices should be normalized load (see lsfintro(1) ). The default is to return the raw load indices.

-E The returned CPU run queue load indices should be effective load (see lsfintro(1) ). The default is to return the raw load indices. The options -N and -E are mutual exclusive.

-n num_hosts
The number of hosts requested. When this option is specified, the hosts that best satisfy the resource requirements only up to the number specified by num_hosts are displayed. If this option is not given, then as many hosts as are eligible (that is, that satisfy the resource requirements) are displayed, up to the number of lines that will fit on the screen.

-R res_req
Resource requirements. If this option is specified, then load information for only those hosts that satisfy the resource requirements is returned. See lsinfo(1) for a list of the built-in resource names. The loads for the returned hosts are sorted according to the load on the resource(s) given in res_req, or by default according to CPU and paging load. If res_req contains special resource names, then only load information about those hosts that provide these resources are displayed (see lshosts(1) to find out what resources are available on each host).

-I index_list
List of load index names seperated by `:' (e.g r1m:pg:ut). If this option is specified then only the given indices will be displayed.

-i interval
The update interval of load information (default is 10 seconds).

-L logfile
Save the load information into a file. An argument is used to specify the filename to be used. The format of the log file is described in lim.acct(5) .

NOTES

Specifying an invalid resource requirement string while lsmon is running (via the `R' option) cause lsmon to exit with an appropriate error message.

lsmon exit if it does not receive a reply from the LIM within the update interval.

SEE ALSO

lsfintro(1) , lshosts(1) , lsinfo(1) , lsload(1) , lslockhost(8) , lim.acct(5) , ls_load(3)

Table of Contents