bhpart

Displays information about host partitions

Synopsis

bhpart [-r] [host_partition_name ...]
bhpart [-h | -V]

Description

By default, displays information about all host partitions. Host partitions are used to configure host-partition fairshare scheduling.

Options

-r
Displays the entire information tree that is associated with the host partition recursively.
host_partition_name ...
Displays information about the specified host partitions only.
-h
Prints command usage to stderr and exits.
-V
Prints LSF release version to stderr and exits.

Output

The following fields are displayed for each host partition:
HOST_PARTITION_NAME
Name of the host partition.
HOSTS
Hosts or host groups that are members of the host partition. The name of a host group is appended by a slash (/). To see information about host groups, use the bmgroup command.
USER/GROUP
Name of users or user groups who have access to the host partition. To see information about user groups, use the bugroup command.
SHARES
Number of shares of resources that are assigned to each user or user group in this host partition, as configured in the lsb.hosts file. The shares affect dynamic user priority for when fairshare scheduling is configured at the host level.
PRIORITY
Dynamic user priority for the user or user group. Larger values represent higher priorities. Jobs belonging to the user or user group with the highest priority are considered first for dispatch.

In general, users or user groups with larger shares, fewer started and reserved jobs, and a lower CPU time and run time have higher priority.

STARTED
Number of job slots that are used by running or suspended jobs that are owned by users or user groups in the host partition.
RESERVED
Number of job slots that are reserved by the jobs that are owned by users or user groups in the host partition.
CPU_TIME
Cumulative CPU time that is used by jobs of users or user groups that are run in the host partition. Measured in seconds, to one decimal place.

LSF calculates the cumulative CPU time by using the actual (not normalized) CPU time and a decay factor. The decay factor is calculated such that 1 hour of recently used CPU time decays to 0.1 hours after an interval of time that is specified by the HIST_HOURS parameter in the lsb.params file (5 hours by default).

RUN_TIME
Wall-clock run time plus historical run time of jobs of users or user groups that are run in the host partition. Measured in seconds.

LSF calculates the historical run time by using the actual run time of finished jobs and a decay factor. The decay factor is calculated such that 1 hour of recently used run time decays to 0.1 hours after an interval of time that is specified by the HIST_HOURS parameter in the lsb.params file (5 hours by default). Wall-clock run time is the run time of running jobs.

ADJUST
Dynamic priority calculation adjustment that is made by the user-defined fairshare plug-in (libfairshareadjust.*).

The fairshare adjustment is enabled and weighted by the parameter FAIRSHARE_ADJUSTMENT_FACTOR in the lsb.params file.

Files

Reads lsb.hosts.

See also

bugroup, bmgroup, lsb.hosts