Administering Platform LSF - SAS

Running Remote Tasks
Running Remote Tasks
lsrun is a non-batch utility to run tasks on a remote host. lsgrun is a nonbatch
utility to run the same task on many hosts, in sequence one after the
other, or in parallel.
The default for lsrun is to run the job on the host with the least CPU load
(represented by the lowest normalized CPU run queue length) and the most
available memory. Command-line arguments can be used to select other
resource requirements or to specify the execution host.
To avoid typing in the lsrun command every time you want to execute a
remote job, you can also use a shell alias or script to run your job.
For a complete description of lsrun and lsgrun options, see the lsrun(1)
and lsgrun(1) man pages.
In this section ◆ “Running a task on the best available host” on page 416
◆ “Running a task on a host with specific resources” on page 416
◆ “Running a task on a specific host” on page 417
◆ “Running a task by using a pseudo-terminal” on page 417
◆ “Running the same task on many hosts in sequence” on page 417
◆ “Running parallel tasks” on page 417
◆ “Running tasks on hosts specified by a file” on page 418
Running a task on the best available host
To run mytask on the best available host, enter:
% lsrun mytask
LSF automatically selects a host of the same type as the local host, if one is
available. By default the host with the lowest CPU and memory load is
selected.
Running a task on a host with specific resources
If you want to run mytask on a host that meets specific resource requirements,
you can specify the resource requirements using the -R res_req option of
lsrun.
For example:
% lsrun -R 'cserver && swp>100' mytask
In this example mytask must be run on a host that has the resource cserver
and at least 100 MB of virtual memory available.
You can also configure LSF to store the resource requirements of specific tasks.
If you configure LSF with the resource requirements of your task, you do not
need to specify the -R res_req option of lsrun on the command-line. If you
do specify resource requirements on the command line, they override the
configured resource requirements.
See the Platform LSF Reference for information about configuring resource
requirements in the lsf.task file.
416
Administering Platform LSF