Platform LSF Reference Version 6.2

bsub
Platform LSF Reference
161
When a job is checkpointed, the checkpoint information is stored in
checkpoint_dir/job_ID/file_name. Multiple jobs can checkpoint into the same directory.
The system can create multiple files.
The checkpoint directory is used for restarting the job (see
brestart(1)).
Optionally, specifies a checkpoint period in minutes. Specify a positive integer. The
running job is checkpointed automatically every checkpoint period. The checkpoint
period can be changed using
bchkpnt(1). Because checkpointing is a heavyweight
operation, you should choose a checkpoint period greater than half an hour.
Optionally, specifies a custom checkpoint and restart method to use with the job. Use
method=default to indicate to use the default LSF checkpoint and restart programs
for the job,
echkpnt.default and erestart.default.
The
echkpnt.method_name and erestart.method_name programs must be in
LSF_SERVERDIR or in the directory specified by LSB_ECHKPNT_METHOD_DIR
(environment variable or set in
lsf.conf).
If a custom checkpoint and restart method is already specified with
LSB_ECHKPNT_METHOD (environment variable or in
lsf.conf), the method
you specify with
bsub -k overrides this.
Process checkpointing is not available on all host types, and may require linking
programs with a special libraries (see
libckpt.a(3)). LSF invokes echkpnt (see
echkpnt(8)) found in LSF_SERVERDIR to checkpoint the job. You can override the
default
echkpnt for the job by defining as environment variables or in lsf.conf
LSB_ECHKPNT_METHOD and LSB_ECHKPNT_METHOD_DIR to point to
your own
echkpnt. This allows you to use other checkpointing facilities, including
application-level checkpointing.
The checkpoint method directory should be accessible by all users who need to run the
custom
echkpnt and erestart programs.
Only running members of a chunk job can be checkpointed.
-L login_shell
Initializes the execution environment using the specified login shell. The specified login
shell must be an absolute path. This is not necessarily the shell under which the job will
be executed.
Login shell is not supported on Windows.
-Lp ls_project_name
Assigns the job to the specified License Scheduler project.
-m "host_name[@cluster_name][+[pref_level]] | host_group[+[pref_level]]
..."
Runs the job on one of the specified hosts.
By default, if multiple hosts are candidates, runs the job on the least-loaded host.
To change the order of preference, put a plus (+) after the names of hosts or host groups
that you would prefer to use, optionally followed by a preference level. For preference
level, specify a positive integer, with higher numbers indicating greater preferences for
those hosts. For example,
-m "hostA groupB+2 hostC+1" indicates that groupB
is the most preferred and
hostA is the least preferred.