Command Reference Guide

Options
192 Platform LSF Command Reference
If LSB_MEMLIMIT_ENFORCE or LSB_JOB_MEMLIMIT are set to y in
lsf.conf, LSF kills the job when it exceeds the memory limit. Otherwise, LSF
passes the memory limit to the operating system. UNIX operating systems that
support RUSAGE_RSS for
setrlimit() can apply the memory limit to each
process.
The following operating systems do not support the memory limit at the OS level:
- Windows
- Sun Solaris 2.x
-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.
The keyword
others can be specified with or without a preference level to refer to
other hosts not otherwise listed. The keyword
others must be specified with at
least one host name or host group, it cannot be specified by itself. For example,
-m
"hostA+ others" means that hostA is preferred over all other hosts.
If you also use
-q, the specified queue must be configured to include all the hosts in
the your host list. Otherwise, the job is not submitted. To find out what hosts are
configured for the queue, use
bqueues -l.
If the host group contains the keyword
all, LSF dispatches the job to any available
host, even if the host is not defined for the specified queue.
To display configured host groups, use
bmgroup.
For the MultiCluster job forwarding model, you cannot specify a remote host by
name.
For parallel jobs, specify first execution host candidates when you want to ensure
that a host has the required resources or runtime environment to handle processes
that run on the first execution host.
To specify one or more hosts or host groups as first execution host candidates, add
the (!) symbol after the host name, as shown in the following example:
bsub -n 2 -m "host1 host2! hostgroupA! host3 host4" my_parallel_job
LSF runs my_parallel_job according to the following steps:
1 LSF selects either host2 or a host defined in hostgroupA as the first execution
host for the parallel job.
NOTE: First execution host candidates specified at the job-level (command line) override
candidates defined at the queue level (in lsb.queues).
2 If any of the first execution host candidates have enough processors to run the
job, the entire job runs on the first execution host, and not on any other hosts.