[ 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), andlsf.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 defaultrexpri
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), andlsf.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.