lsplace
Displays hosts available to run tasks.
Synopsis
lsplace [-L] [-n minimum | -n 0] [-R res_req] [-w maximum | -w 0] [host_name ...]Description
Displays hosts available for the execution of tasks, and temporarily increases the load on these hosts (to avoid sending too many jobs to the same host in quick succession). The inflated load decays slowly over time before the real load that is produced by the dispatched task is reflected in the LIM’s load information. Host names might be duplicated for multiprocessor hosts to indicate that multiple tasks can be placed on a single host.
By default, displays only one host name.
By default, uses LSF default resource requirements.
Options
- -L
- Attempts to place tasks on as few hosts as possible. Use the -L option for distributed parallel applications to minimize communication costs between tasks.
- -n minimum | -n 0
- Displays at least the specified number of hosts. Specify 0 to display as many hosts as possible.
Prints Not enough host(s) currently eligible and exits with status 1 if the required number of hosts with the required resources cannot be found.
- -R res_req
- Displays only hosts with the specified resource requirements. LSF rejects resource requirement strings where an rusage section contains a non-consumable resource.
- -w maximum | -w 0
- Displays no more than the specified number of hosts. Specify 0 to display as many hosts as possible.
- host_name ...
- Displays only hosts that are among the specified hosts.
- -h
- Prints command usage to stderr and exits.
- -V
- Prints LSF release version to stderr and exits.
Examples
lsrun -m ‘lsplace -R hppa‘ myprogram
In order for a job to land on a host with an exclusive resource, you need to explicitly specify that resource for the resource requirements. The following example issues a command to display the host with the bigmem exclusive resource for your program to run on:
lsrun -m ‘lsplace -R "bigmem"‘ myprogram
lsplace -n 3 -w 5
Diagnostics
The lsplace command returns 1 if not enough hosts are available. The exit status is -10 if a problem is detected in LSF. Exit status is -1 for other errors. Normal exit status is 0.