bmgroup

displays information about host groups and compute units

Synopsis

bmgroup [-r] [-l] [-w] [-cu] [group...]
bmgroup [-h | -V]

Description

Displays compute units, host groups, host names, and administrators for each group or unit.

By default, displays information about all compute units, host partitions, and host groups including host groups created for EGO-enabled SLA scheduling.

Host groups for EGO-enabled SLA

When hosts are allocated to an EGO-enabled SLA, they are dynamically added to a host group created by the SLA. The name of the host group is _sla_sla_name, where sla_name is the name of the EGO-enabled SLA defined in lsb.serviceclasses or in ENABLE_DEFAULT_EGO_SLA in lsb.params. One of the hosts in the host group has the name _virtual.

When the host is released to EGO, the entry is removed from the host group. bmgroup displays the hosts allocated by EGO to the host group created by the SLA.

Options

-l

Displays static and dynamic host group members. A ‘+’ sign before the host name indicates that the host is dynamic and is currently a member of the compute unit, host partitions, or host group. A ‘-’ sign before the host name indicates that the host is currently not an LSF host but is a member of the dynamic group, partition, or unit.

Also identifies condensed compute units, host partitions, or host groups as defined by CONDENSE in the HostGroup or ComputeUnit section of lsb.hosts.

-r

Expands host groups, host partitions, and compute units recursively. The expanded list contains only host names; it does not contain the names of subgroups. Duplicate names are listed only once.

-w

Wide format. Displays names without truncating fields.

-cu

Displays compute unit information. Use with [cu_name] to display only the specified compute unit.

group...

Only displays information about the specified groups (host groups, or compute unit with -cu). Do not use quotes when specifying multiple groups.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Output

In the list of hosts, a name followed by a slash (/) indicates a subgroup.

Files

Host groups, compute units, and host partitions are configured in the configuration file lsb.hosts(5). Compute unit types are defined by COMPUTE_UNIT_TYPES in lsb.params(5).

See also

lsb.hosts(5), lsb.params(5), bugroup(1), bhosts(1)