bdc

Synopsis

bdc subcommand
bdc [-h | -V]

Description

bdc provides a set of subcommands to monitor Dynamic Cluster. If there are no specified subcommands, bdc prompts for a subcommand from standard input.

Information about each subcommand is available through the help command.

Subcommand synopsis

The following subcommands are supported:

action
hist
param
tmpl
vm
host
help [subcommand ...] | ? [subcommand ...]
quit

Options

subcommand

Executes the specified subcommand. See Usage section.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Usage

action [-l] [-w] [-p req_id...|-j job_id...]

Show information about provision actions. This subcommand shows information from memory. For information about older jobs, use bdc hist.

By default, only shows the following information:

REQ_ID - provision request ID. There is one provision request per job. (numeric)

JOB_ID - LSF job ID (numeric)

STATUS - status of the job’s provisioning request:

  • active = one or more actions in the request are in progress

  • done = all actions in the request are done

  • failed = the request failed to complete

BEGIN - date and time the request was made (Weekday Month dd hh:mm:ss)

END - date and time the request finished (Weekday Month dd hh:mm:ss)

NACTS - number of provision actions in the request (numeric)

-l

Long format. Shows the following additional information:

HOSTS - host names

ACTIONID - provision action ID (req_ID.subreq_ID.step_ID)

ACTION - provision action

TARGET - VM or PM machine ID

HOSTNAME - VM or PM machine name

HYPERVISOR - host name. Shows a dash "-" if the job is a PM job.

DC_TEMPLATE - Dynamic Cluster machine template used. Shows a dash "-" if not required.

STATUS - status of the provisioning action:

  • active = the action is in progress

  • done = the action is complete

  • wait = the action is not started, it may be dependent on another action in the same provision request

  • failed = the action failed to complete

-w

Wide format. Displays information without truncating it.

-p req_ID

Provision request ID.

Cannot be used with -j.

-j job_ID

Job ID.

Cannot be used with -p.

Example output
# bdc action
REQ_ID  JOB_ID       STATUS  BEGIN                     END                       NACT
235     1[24]        done    Tue Nov 20 11:43:46 2012  Tue Nov 20 11:43:46 2012  1

# bdc action -l
REQ_ID<235>
JOB_ID       STATUS  BEGIN                     END                       NACT
1[24]        done    Tue Nov 20 11:43:46 2012  Tue Nov 20 11:43:46 2012  1

HOSTS           ac-kvm1

<Action details>
ACTIONID       1.1.1
ACTION         IDLE_VM
STATUS         done
TARGET         4c136d83-2639-4ca0-b1d4-fe3a85aa66fe
HOSTNAME       kvmvm6
DC_TEMPLATE    rh48
HYPERVISOR     dc-kvm1
hist [-a] [-l | -w] [-f event_file | -n num_event_files][-t begin_time[,end_time]] [-p req_ID... | -j job_ID | -j jobID[index]...]

Show historic information about provisioning requests. This subcommand shows information from the event log files. For more information about recent jobs, use bdc -action.

By default, show information about unfinished requests only (exclude failed and done status).

By default, show information from the current event log file only.

By default, show the following information:

REQ_ID - provision request ID (numeric)

STATUS - status of the job’s provision request (wait, active, failed, done ...)

JOB_ID - LSF job ID (numeric)

BEGIN - date and time the request was made (Weekday Month dd hh:mm:ss)

END - date and time the request finished (Weekday Month dd hh:mm:ss)

-a

Show information about all provision requests (both finished and unfinished).

-l

Long format.

-w

Wide format. Displays information without truncating it.

-f event_file

Show information from the specified event log file. Specify the event log file name. Specify either an absolute or a relative path.

The specified file path can contain up to 4094 characters for UNIX.

-n num_event_files | -n 0

Show information from the specified number of event log files. Specify an integer up to 100.

Searches the specified number of event logs, starting with the current event log and working through the most recent consecutively numbered logs. Specify 0 to specify all the event log files, up to a maximum of 100.

If you delete a file, you break the consecutive numbering, and older files are inaccessible to bdc hist. For example, if you specify 3, LSF searches:

dc.events

dc.events.1

dc.events.2

If you specify 4, LSF searches:

dc.events

dc.events.1

dc.events.2

dc.events.3

However, if dc.events.2 is missing, both searches include only dc.events and dc.events.1.

[-t begin_time[,end_time]]

Show information about events in the specified time frame. If you do not specify the end time, the end time is the current time.

Specify time in the format yyyy/mm/dd/HH:MM. Do not include spaces in the time interval string.

For more information about the syntax, see "Time interval format" at the end of the LSF bhist command reference.

[-j job_ID | -j jobID[index]...]

Show information about the specified jobs. Specify the job ID or job array ID.

To search multiple files, use -j with -f or -n.

-l

Long format. For each request, shows detailed information about the actions in the request and their progress.

-p req_ID...

Show information about the specified provision requests only.

To search multiple files, use -p with -f or -n.

Example output
# bdc hist -l -p 1
Provision request <1> for Job <1936>
Thu Jun  9 00:28:14: Requested on 1 Hosts <host003>; 
Thu Jun  9 00:28:14: Requested 1 idle Machine <d22c1e89-2fa5-4b24-9f25-f278469d915b>
Thu Jun  9 00:28:14: Request completed
host [-l | -w] [host_name...]

Show information about physical machines or hypervisors.

By default, only shows the following information:

NAME - host name

STATUS - host status (for example, on, off)

TYPE - machine type (for example, HV_PM)

TEMPLATE - Dynamic Cluster machine template name

CPUS - number of CPUs on the host (numeric)

MAXMEM - maximum memory on the host, in MB (numeric)

RESGROUP - resource group that the host belongs to

NPMJOBS - number of physical machine jobs on the host (numeric) directly

-l

Long format. Shows the following additional information:

PCMAE_TMPL_NAME - Platform Cluster Manager Advanced Edition template name

PPS_NAME - post-provisioning script

PPS_ARGUMENTS - arguments to the post-provisioning script

JOBIDS - job ID of jobs running on the host

MIN_TTL - minimum time to live, in seconds (numeric)

CREATION_TIME - creation time

POWER_ON_TIME - time the host powered on

POWER_OFF_TIME - time the host powered off

-w

Wide format. Displays information without truncating it.

Example output
# bdc host
NAME         STATUS       TYPE    TEMPLATE  CPUS  MAXMEM    RESGROUP  NPMJOBS   
host000      on           PM      DC_PM_T   4     7985 MB   PCM_172_  2
host003      on           HV_PM   KVM_HV    4     7729 MB   KVMRedHa  0

# bdc host -l
NAME            host000
STATUS          on
TYPE            PM
MAXMEM          7985 MB
CPUS            4
RESGROUP        PCM_172_17_1_153-2c918127-3069788a-0130-69827ade-0027
TEMPLATE        DC1_PM
PCMAE_TMPL_NAME DC1
PPS_NAME        setup_lsf.sh
PPS_ARGUMENTS   -
JOBIDS          -
MIN_TTL         -
CREATION_TIME   Tue Jun  7 07:11:26 2011
POWER_ON_TIME   Tue Jun  7 07:11:26 2011
POWER_OFF_TIME  Tue Jun  7 07:11:26 2011

NAME            host003
STATUS          on
TYPE            HV_PM
MAXMEM          7729 MB
CPUS            4
RESGROUP        KVMRedHat_Hosts
TEMPLATE        KVM_HV
PCMAE_TMPL_NAME -
PPS_NAME        -
PPS_ARGUMENTS   -
JOBIDS          -
MIN_TTL         -
CREATION_TIME   -
POWER_ON_TIME   -
POWER_OFF_TIME  -
param [-l]

Show information about Dynamic Cluster configuration parameters.

By default, shows parameter name and value.

-l

Long format. Shows a description of each parameter displayed.

tmpl [-l | -w] [-i template_ID] [-n template_name][-g resource_group]

Show information about Dynamic Cluster machine templates.

By default, only shows the following information:

NAME = template name

MACHINE_TYPE = PM or VM

RESGROUP = resource group name (if type is shared).

-l

Long format. Shows the following additional information:

HV_TYPE = technical type of template hypervisor

PCMAE_TMPL_NAME = name of Platform Cluster Manager Advanced Edition template associated to this Dynamic Cluster template

PCMAE_TMPL_ID = unique template ID

PPS_NAME = name of the post-provisioning script associated to this template

PPS_ARGUMENTS = arguments of the post-provisioning script associated to this template

DESCRIPTION = description string

Cannot be used with -w.

-w

Wide format. Displays information without truncating it.

Cannot be used with -l.

-g resource_group

Show information for templates in the specified resource group.

-n template_name

Show information for the specified templates. Specify the template name.

-i template_ID

Show information for the specified templates. Specify the template ID.

Example output
# bdc tmpl
NAME                MACHINE_TYPE       RESGROUP
vm1                 VM                 KVMRedHat_Hosts
DC1_PM              PM                 PCM_172_17_1_153-2c918
KVM_HV              PM                 PCM_172_17_1_153-2c918

# bdc tmpl -l
NAME               vm1
HV_TYPE            KVM
MACHINE_TYPE       VM
RESGROUP           KVMRedHat_Hosts
PCMAE_TMPL_NAME    my_tmpl1
PCMAE_TMPL_ID      de2d35bc-dba7-ddf2-5e34-3d53323d2d48
PPS_NAME           setup.sh
PPS_ARGUMENTS      -
DESCRIPTION           Dynamic Cluster template for VM
vm [-l | -w] [-a] [vm_host_name ...]

Show information about VMs.

By default, only shows information for VMs that have a job associated, or are in the following states:

on

saving

saved

starting

shuttingdown

installing

uninstalling

bdc vm -a shows the following extra states:

unknown

off

By default, only shows the following information:

HOST_NAME

STATUS

HYPERVISOR

TEMPLATE

MAXMEM

VCPUS

JOB_ID

-a

Show information about VMs in all states.

-l

Long format. Shows the following additional information:

UUID

VM_NAME

PCMAE_TMPL_NAME

PPS_NAME

PPS_ARGUMENTS

RESGROUP

MIN_TTL

MAX_TTL

CREATION_TIME

POWER_ON_TIME

POWER_OFF_TIME

-w

Wide format. Displays information without truncating it.

vm_host_name ...

Show information about the specified VMs only. Specify the VM host name. Use space to separate names in a list.

Example output
# bdc vm
HOSTNAME     STATUS       HYPERVISOR TEMPLATE  MAXMEM    VCPUS JOB_ID
vm4          on           host003    DC_VM_T   1024 MB   2     1733  
vm0          on           host003    DC_VM_T   1024 MB   1     -     

# bdc vm -l
HOSTNAME        vm4
UUID            4e9f9549-59b7-4e99-ba83-788808dfb2eb
STATUS          on
TEMPLATE        DC_VM_TMPL
PCMAE_TMPL_NAME isftmpl1
PPS_NAME        setup.sh
PPS_ARGUMENTS   -
HYPERVISOR      host003
MAXMEM          1024 MB
VM_NAME         _dyn_dc_2
JOB_ID          1733
VCPUS           2
RESGROUP        KVMRedHat_Hosts
MIN_TTL         0
MAX_TTL         -
CREATION_TIME   Wed Jun  8 06:05:18 2011
POWER_ON_TIME   Wed Jun  8 06:18:24 2011
POWER_OFF_TIME  Wed Jun  8 06:09:41 2011

HOSTNAME        vm0
UUID            d22c1e89-2fa5-4b24-9f25-f278469d915b
STATUS          on
TEMPLATE        DC_VM_TMPL
PCMAE_TMPL_NAME isftmpl1
PPS_NAME        setup.sh
PPS_ARGUMENTS   -
HYPERVISOR      host003
MAXMEM          1024 MB
VM_NAME         _dyn_dc_1
JOB_ID          -
VCPUS           1
RESGROUP        KVMRedHat_Hosts
MIN_TTL         0
MAX_TTL         -
CREATION_TIME   Wed Jun  8 23:17:41 2011
POWER_ON_TIME   Wed Jun  8 23:18:07 2011
POWER_OFF_TIME  Wed Jun  8 23:17:41 2011
Parent topic: Commands