Learn more about Platform products at http://www.platform.com

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]



lsload


displays load information for hosts

SYNOPSIS

lsload [-l] [-N | -E] [-I load_index[:load_index] ...] [-n num_hosts] [-R res_req] [host_name ... | cluster_name ...]

lsload -s [resource_name ...]

lsload [-h | -V]

DESCRIPTION

Displays load information for hosts. Load information can be displayed on a per-host basis, or on a per-resource basis.

By default, displays load information for all hosts in the local cluster, per host.

With MultiCluster, also displays load information for all hosts in equivalent clusters (see lsf.cluster(5)).

By default, displays raw load indices.

By default, load information for resources is displayed according to CPU and paging load.

OPTIONS

-l

Long format. Displays load information without truncation along with additional fields for I/O and external load indices.

This option overrides the index names specified with the -I option.

-N

Displays normalized CPU run queue length load indices (see lsfintro(1)).

-E

Displays effective CPU run queue length load indices (see lsfintro(1)). Options -N and -E are mutually exclusive.

-I load_index[:load_index] ...

Displays only the specified load indices. Separate multiple index names with colons (for example, r1m:pg:ut).

Specify any built-in load index. Specify external load indices only for host- based resources that are numeric and dynamic (you cannot specify external load indices for shared, string or Boolean resources).

-n num_hosts

Displays only load information for the requested number of hosts. Information for up to num_hosts hosts that best satisfy the resource requirements is displayed.

-R res_req

Displays only load information for hosts that satisfy the specified resource requirements. See lsinfo(1) for a list of built-in resource names.

Load information for the hosts is sorted according to load on the specified resources.

If res_req contains special resource names, only load information for hosts that provide these resources is displayed (see lshosts(1) to find out what resources are available on each host).

If one or more host names are specified, only load information about the hosts that satisfy the resource requirements is displayed.

With MultiCluster, when a cluster name is specified, displays load information of hosts in the specified cluster that satisfy the resource requirements.

host_name ... | cluster_name ...

Displays only load information for the specified hosts.

With MultiCluster, displays only load information for hosts in the specified clusters.

-s [resource_name ...]

Displays information about all dynamic shared resources configured in the cluster, or about the specified resources only. Specify dynamic shared resources.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

OUTPUT

HOST-BASED OUTPUT (default output)

Built-in load indices include r15s, r1m, r15m, ut, pg, io, ls, it, swp, mem and tmp. External load indices are configured in the file lsf.cluster.cluster_name (see lsf.cluster(5)). The selection and order sections of res_req control for which hosts are displayed and how the information is ordered (see lsfintro(1)).

The display includes the following fields:

HOST_NAME

Standard host name used by LSF, typically an Internet domain name with two components.

status

Status of the host. A minus sign (-) may precede the status, indicating that RES is not running on the host.

Possible statuses are:

ok

The host is in normal load sharing state and can accept remote jobs.

busy

The host is overloaded because some load indices exceed configured thresholds. Load index values that caused the host to be busy are preceded by an asterisk (*).

lockW

The host is locked by its run window. Run windows for a host are specified in the configuration file (see lsf.conf(5)) and can be displayed by lshosts. A locked host will not accept load shared jobs from other hosts.

lockU

The host is locked by the LSF administrator or root.

unavail

The host is down or the Load Information Manager (LIM) on the host is not running.

unlicensed

The host does not have a valid LSF license.

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.

ls

The number of current login users.

it

On UNIX, the idle time of the host (keyboard not touched on all logged in sessions), in minutes.

On Windows NT, the it index is based on the time a screen saver has been active on a particular host.

tmp

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

swp

The amount of available swap space, in megabytes.

mem

The amount of available RAM, in megabytes.

io

By default, io is not shown.

If -l is specified, shows the disk I/O rate exponentially averaged over the last minute, in KB per second.

external_index

By default, external load indices are not shown.

If -l is specified, shows indices for all dynamic custom resources available on the host, including shared, string and Boolean resources.

If -I load_index is specified, only shows indices for specified non-shared (host-based) dynamic numeric custom resources.

RESOURCE-BASED OUTPUT (lsload -s)

Displays information about dynamic shared resources. Each line gives the value and the associated hosts for an instance of the resource. See lim(8), and lsf.cluster(5) for information on configuring dynamic shared resources.

The displayed information consists of the following fields:

RESOURCE

Name of the resource.

VALUE

Value for an instance of the resource.

LOCATION

Hosts associated with the instance of the resource.

EXAMPLES

% lsload -R "select[r1m<=0.5 && swp>=20 && type==ALPHA]"

OR, in restricted format:

% lsload -R r1m=0.5:swp=20:type=ALPHA

Displays the load of ALPHA hosts with at least 20 megabytes of swap space, and a 1-minute run queue length less than 0.5.

% lsload -R "select[(1-swp/maxswp)<0.75] order[pg]"

Displays the load of the hosts whose swap space utilization is less than 75%. The resulting hosts are ordered by paging rate.

% lsload -I r1m:ut:io:pg

Displays the 1-minute CPU raw run queue length, the CPU utilization, the disk I/O and paging rates for all hosts in the cluster.

% lsload -E

Displays the load of all hosts, ordered by r15s:pg, with the CPU run queue lengths being the effective run queue lengths (see lsfintro(1)).

% lsload -s verilog_license

Displays the value and location of all the verilog_license dynamic shared resource instances.

SEE ALSO

lsfintro(1), lim(8), lsf.cluster(5), lsplace(1), lshosts(1), lsinfo(1), lslockhost(8), ls_load(3)

DIAGNOSTICS

Exit status is -10 if an LSF problem is detected or a bad resource name is specified.

Exit status is -1 if a bad parameter is specified, otherwise lsload returns 0.

[ Top ]


[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]


      Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.