Control hosts

About this task

Hosts are opened and closed by:

Procedure

an LSF Administrator or root issuing a command
configured dispatch windows

Close a host

Procedure

Run badmin hclose:

badmin hclose hostB
Close <hostB> ...... done

If the command fails, it might be because the host is unreachable through network problems, or because the daemons on the host are not running.

Open a host

Procedure

Run badmin hopen:

badmin hopen hostB
Open <hostB> ...... done

Configure dispatch windows

About this task

A dispatch window specifies one or more time periods during which a host receive new jobs. The host does not receive jobs outside of the configured windows. Dispatch windows do not affect job submission and running jobs (they are allowed to run until completion). By default, dispatch windows are not configured.

To configure dispatch windows:

Procedure

Edit lsb.hosts.

Specify one or more time windows in the DISPATCH_WINDOW column:

Begin Host
HOST_NAME     r1m      pg    ls     tmp    DISPATCH_WINDOW
...
hostB         3.5/4.5  15/   12/15  0      (4:30-12:00)
...
End Host

Reconfigure the cluster:
1. Run lsadmin reconfig to reconfigure LIM.
2. Run badmin reconfig to reconfigure mbatchd.
Run bhosts -l to display the dispatch windows.

Log a comment when closing or opening a host

Procedure

Use the -C option of badmin hclose and badmin hopen to log an administrator comment in lsb.events:
```
badmin hclose -C "Weekly backup" hostB
```
The comment text Weekly backup is recorded in lsb.events. If you close or open a host group, each host group member displays with the same comment string.

A new event record is recorded for each host open or host close event. For example:
```
badmin hclose -C "backup" hostA
```
followed by
```
badmin hclose -C "Weekly backup" hostA
```
generates the following records in lsb.events:
```
"HOST_CTRL" "7.0 1050082346 1 "hostA" 32185 "lsfadmin" "backup"
"HOST_CTRL" "7.0 1050082373 1 "hostA" 32185 "lsfadmin" "Weekly backup"
```

Use badmin hist or badmin hhist to display administrator comments for closing and opening hosts:

badmin hhist
Fri Apr  4 10:35:31: Host <hostB> closed by administrator
<lsfadmin> Weekly backup.

bhosts -l also displays the comment text:

bhosts -l
 
HOST  hostA
STATUS     CPUF  JL/U    MAX  NJOBS    RUN  SSUSP  USUSP    RSV DISPATCH_WINDOW
closed_Adm 1.00     -      -      0      0      0      0      0      -
 
 CURRENT LOAD USED FOR SCHEDULING:
              r15s   r1m  r15m    ut    pg    io   ls    it   tmp   swp   mem   slots
 Total         0.0   0.0   0.0    2%   0.0    64    2    11 7117M  512M  432M       8
 Reserved      0.0   0.0   0.0    0%   0.0     0    0     0    0M    0M    0M       8
 
 LOAD THRESHOLD USED FOR SCHEDULING:
           r15s   r1m  r15m   ut      pg    io   ls    it    tmp    swp    mem
 loadSched   -     -     -     -       -     -    -     -     -      -      -
 loadStop    -     -     -     -       -     -    -     -     -      -      -
 
                cpuspeed    bandwidth
 loadSched          -            -
 loadStop           -            -
 
 THRESHOLD AND LOAD USED FOR EXCEPTIONS:
            JOB_EXIT_RATE
 Threshold    2.00
 Load         0.00
 ADMIN ACTION COMMENT: "Weekly backup"

How events are displayed and recorded in MultiCluster lease model

In the MultiCluster resource lease model, host control administrator comments are recorded only in the lsb.events file on the local cluster. badmin hist and badmin hhist display only events that are recorded locally. Host control messages are not passed between clusters in the MultiCluster lease model. For example. if you close an exported host in both the consumer and the provider cluster, the host close events are recorded separately in their local lsb.events.