bgpinfo

Displays information about global fair share and global resources.

Synopsis

bgpinfo subcommand

bgpinfo [-h | -V]

Description

The bgpinfo command provides a set of subcommands to get information about global fair share.

This command can also display remote fair share load. The remote fair share load impacts your dynamic priority for job scheduling.

Information about each subcommand is available through the help command.

Subcommand synopsis

conf [-l] [global_policy_name...]

fsload [-l [-c cluster_name]] [global_policy_name...]

policy

resource [-c] [-l] [-s] [-w]

status [-l [global_policy_name ...]]

-h

-V

Options

subcommand: Runs the specified subcommand. See Usage section.
-h: Prints command usage to stderr and exits.
-V: Prints LSF release version to stderr and exits.

Usage

conf [-l] [global_policy_name ...]

Shows summary of global fair share policy configurations.

POLICY_NAME: The name of the global policy.
TYPE: Type of global policy.

If global_policy_name is specified, shows only the information for the specified global policies.

-l

Long format. Shows the following additional information:

SYNC_INTERVAL: fair share load synchronization interval.
SYNC_MODE: Synchronization mode (all or partial).
PARTICIPANTS: Participants in the global fair share policy.

$ bgpinfo conf
POLICY_NAME       TYPE
low               fair share
admin             fair share
 
$ bgpinfo conf -l
POLICY NAME: low
-- A global fair share policy for low queue.
  TYPE: fair share
  PARAMETERS:
  SYNC_INTERVAL: 30 seconds
  SYNC_MODE: partial
  PARTICIPANTS: low@c1 low@c2
 
POLICY NAME: admin
-- A global fair share policy for admin queue.
  TYPE: fair share
  PARAMETERS:
  SYNC_INTERVAL: 30 seconds
  SYNC_MODE: all
  PARTICIPANTS: admin@c1 admin@c2
 
$ bgpinfo conf -l admin
POLICY NAME: admin
-- A global fair share policy for admin queue.
  TYPE: fair share
  PARAMETERS:
  SYNC_INTERVAL: 30 seconds
  SYNC_MODE: all
  PARTICIPANTS: admin@c1 admin@c2

fsload [-l [-c cluster_name]] [global_policy_name ...]

Shows the aggregated fair share load for global fair share policies.

By default, displays recursively the summed fair share load information for the global share account tree for all global fair share policies. Use the fsload -l option to display fair share load information for each participating queue. Only share accounts whose fair share load entries are not all zero are shown.

The POLICY_NAME is the name of the global fair share policy. The following information is displayed for fair share load:

SHARE_INFO_FOR: The sum of the fair share load information from all participating queues, users, or user groups in the global fair share policy.
USER/GROUP: Names of users or user groups who have access to the global fair share policy.
STARTED: Number of job slots that are used by running or suspended jobs from users or user groups that participate in the global fair share policy.
RESERVED: Number of job slots that are reserved by jobs from users or user groups that participate in the global fair share policy.
CPU_TIME: Cumulative CPU time that is used by jobs from users or user groups that participate in the global fair share policy.
RUN_TIME: Total run time of all participants in the global fair share policy.
HIST_RUN_TIME: Total historical run time of all participants in the global fair share policy.
ADJUST: Total dynamic priority calculation adjustment for all participants in the global fair share policy.
STARTED_JOBS: The number of started jobs and suspended jobs as used by the fair share scheduling algorithm. This field only displays if fair share_JOB_COUNT=Y is enabled in the lsb.params file.
RESERVED_JOBS: The number of reserved jobs as used by the fair share scheduling algorithm. This field only displays if fair share_JOB_COUNT=Y is enabled in the lsb.params file.

-l

In addition to default output, shows fair share load information for each participant.

The PROVIDER and SHARE_INFO_FOR show fair share load information that is provided by a specific participant:

USER/GROUP: Name of users or user groups who have access to the global fair share policy.

STARTED: Number of job slots that are used by running or suspended jobs from users or user groups for the specific participant.
RESERVED: Number of job slots that are reserved by jobs from users or user groups for the specific participant.
CPU_TIME: Cumulative CPU time that is used by jobs from users or user groups for the specific participant.
RUN_TIME: Run time for the specific participant.
ADJUST: Dynamic priority calculation adjustment for the specific participant.

-c cluster_name

Filter for the -l option. It shows fair share load for the specified participating cluster. Only one cluster name can be specified with the -c option.

$ bgpinfo fsload -l -c c1 admin
POLICY_NAME: admin

  SHARE_INFO_FOR: /
  USER/GROUP   STARTED  RESERVED  CPU_TIME  RUN_TIME  HIST_RUN_TIME   ADJUST
  ugroup1            27        0       2.9    262464              0    0.000

    PROVIDER: admin@c1
    USER/GROUP   STARTED  RESERVED  CPU_TIME  RUN_TIME  HIST_RUN_TIME   ADJUST
    ugroup1           18         0       2.9     92129              0    0.000

  SHARE_INFO_FOR: /ugroup1/
  USER/GROUP   STARTED  RESERVED  CPU_TIME  RUN_TIME  HIST_RUN_TIME   ADJUST
  user1              9         0       1.0     87490              0     0.000
  user2              9         0       0.0     87488              0     0.000
  user3              9         0       1.0     87486              0     0.000

    PROVIDER: admin@c1
    USER/GROUP   STARTED  RESERVED  CPU_TIME  RUN_TIME  HIST_RUN_TIME   ADJUST
    user1              6         0       1.0     30711              0    0.000
    user2              6         0       0.9     30709              0    0.000
    user3              6         0       1.0     30709              0    0.000

policy

Shows distribution policies for global resources and global limits.

resource [-c] [-l] [-s] [-w]

Shows usage information on global resources.

-c: Shows the global resource configuration information instead of usage information.
-l: Shows detailed usage information on global resources for all clusters.
-s: Shows filtered usage information on global resources.
-w: Shows usage information on global resources in wide format.

status [-l [global_policy_name ...]]

Shows the status of the gpolicyd daemon and global fair share policies. By default, the following information is shown:

GPOLICYD CLUSTER: The cluster where gpolicyd is running.
GPOLICYD HOST: The host where gpolicyd is running.

-l

In addition to the default output for daemon gpolicyd status, shows the status of specified global fair share policies. By default, shows status of all global fair share policies.

GLOBAL fair share POLICY shows the status of a global fair share policy:

POLICY NAME

Name of the global fair share policy.

PARTICIPANTS

Name of participants of the global fair share policy.

STATUS

Status of the participant.

Disconnected - The cluster of the participant is disconnected from gpolicyd
Rejected - Registration rejected. The participant does not exist or the participant is not a fair share queue.
ok - The cluster for the participant is connected to gpolicyd and the queue for the participant is successfully registered with gpolicyd.

$ bgpinfo status 
GPOLICYD HOST: userA
GPOLICYD CLUSTER: c1 

$ bgpinfo status -l 
GPOLICYD HOST: userA
GPOLICYD CLUSTER: c1 

GLOBAL fair share POLICY 

POLICY NAME: low 
  PARTICIPANTS         STATUS 
  low@c1               ok     
  low@c2               rejected   

POLICY NAME: admin 
  PARTICIPANTS         STATUS 
  admin@c1             ok
  admin@c2             ok