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

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



lshosts


displays hosts and their static resource information

SYNOPSIS

lshosts [-w | -l] [-R "res_req"] [host_name | cluster_name] ...

lshosts -s [shared_resource_name ...]

lshosts [-h | -V]

DESCRIPTION

Displays static resource information about hosts.

By default, returns the following information: host name, host type, host model, CPU factor, number of CPUs, total memory, total swap space, whether or not the host is a server host, and static resources. Displays information about all hosts in the cluster. See lsf.cluster(5).

In MultiCluster job forwarding model, the default behavior is to return the following information: host name, host type, host model, CPU factor, number of CPUs, total memory, total swap space, whether or not the host is a server host, and static resources. Displays information about all hosts in the local cluster and for all hosts in equivalent remote clusters that the local cluster sees. See lsf.cluster(5).

In MultiCluster resource leasing model, returns information about hosts in the local cluster.

The -s option displays information about the static shared resources and their associated hosts.

OPTIONS

-w

Displays host information in wide format. Fields are displayed without truncation.

-l

Displays host information in a long multi-line format. In addition to the default fields, displays information about the maximum /tmp space, the number of local disks, the execution priority for remote jobs, load thresholds, and run windows.

-R "res_req"

Only displays information about the hosts that satisfy the resource requirement expression. For more information about resource requirements, see lsfintro(1). The size of the resource requirement string is limited to 512 bytes. LSF supports ordering of resource requirements on all load indices, including external load indices, either static or dynamic.

In MultiCluster, only displays information about the hosts in the local cluster that satisfy the resource requirement expression.

host_name...| cluster_name...

Only displays information about the specified hosts. Do not use quotes when specifying multiple hosts.

For MultiCluster, displays information about hosts in the specified clusters. The names of the hosts belonging to the cluster are displayed instead of the name of the cluster. Do not use quotes when specifying multiple clusters.

-s [shared_resource_name ...]

Displays information about the specified resources. The resources must be static shared resources. If no shared resource is specified, then displays information about all shared resources. Returns the following information: the resource names, the values of the resources, and the resource locations.

-h

Prints command usage to stderr and exits.

-V

Prints the LSF release version to stderr and exits.

OUTPUT

Host-Based Default

Displays the following fields:

HOST_NAME

The name of the host. This display field is truncated.

type

The host type. This display field is truncated.

With MultiCluster, if the host type of a remote cluster's host is not defined in the local cluster, the keyword unknown will be displayed.

model

The host model. This display field is truncated.

With MultiCluster, if the host model of a remote cluster's host is not defined in the local cluster, the keyword unknown will be displayed.

cpuf

The relative CPU performance factor. The CPU factor is used to scale the CPU load value so that differences in CPU speeds are considered. The faster the CPU, the larger the CPU factor.

The CPU factor of a host with an unknown host type is 1.0.

ncpus

The number of processors on this host.

maxmem

The maximum amount of physical memory available for user processes.

maxswp

The total available swap space.

server

Indicates whether the host is a server or client host. "Yes" is displayed if the host is an LSF server. "No" is displayed if the host is a client.

RESOURCES

The Boolean resources defined for this host, denoted by resource names, and the values of external numeric and string static resources. See lsf.cluster(5), and lsf.shared(5) on how to configure external static resources.

Host Based -l Option

In addition to the above fields, the -l option also displays the following:

ndisks

The number of local disk drives directly attached to the host.

maxtmp

The maximum /tmp space in megabytes configured on a host.

rexpri

UNIX only. The execution priority of remote jobs run by the RES. rexpri is a number between -20 and 20, with -20 representing the highest priority and 20 the lowest. The default rexpri is 0, which corresponds to the default scheduling priority of 0 on BSD-based UNIX systems and 20 on System V-based systems.

RUN_WINDOWS

The time windows during which LIM considers the host as available to execute remote jobs. These run windows have the same function for LSF hosts as dispatch windows have for LSF Batch hosts. (See lsf.cluster(5).)

LOAD_THRESHOLDS

The thresholds for scheduling interactive jobs. If a load index exceeds the load threshold (or falls below the load threshold, for decreasing load indices), the host status is changed to "busy." If the threshold is displayed as a dash "-", the value of that load index does not affect the host's status. See lsload(1).

Resource-Based -s Option

Displays the static shared resources. Each line gives the value and the associated hosts for the static shared resource. See lsf.shared(5), and lsf.cluster(5) on how to configure static shared resources.

The following fields are displayed:

RESOURCE

The name of the resource.

VALUE

The value of the static shared resource.

LOCATION

The hosts that are associated with the static shared resource.

FILES

Reads lsf.cluster.cluster_name.

SEE ALSO

lsfintro(1), ls_info(3), ls_policy(3), ls_gethostinfo(3), lsf.cluster(5), lsf.shared(5)

[ 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.