Platform LSF

Version 9 Release 1.3

Quick Reference



GC27-5309-03
Platform LSF
Version 9 Release 1.3

Quick Reference



GC27-5309-03
 Note
Before using this information and the product it supports, read the information in “Notices” on page 9.

First edition
This edition applies to version 9, release 1 of IBM Platform LSF (product number 5725G82) and to all subsequent
releases and modifications until otherwise indicated in new editions.
Significant changes or additions to the text and illustrations are indicated by a vertical line (|) to the left of the
change.
If you find an error in any Platform Computing documentation, or you have a suggestion for improving it, please
let us know.
In the IBM Knowledge Center, add your comments and feedback to any topic.
You can also send your suggestions, comments and questions to the following email address:
pccdoc@ca.ibm.com
Be sure include the publication title and order number, and, if applicable, the specific location of the information
about which you have comments (for example, a page number or a browser URL). When you send information to
IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate
without incurring any obligation to you.
© Copyright IBM Corporation 1992, 2014.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . 9 Privacy policy considerations . . . . . . . . 11
Trademarks . . . . . . . . . . . . . . 11

© Copyright IBM Corp. 1992, 2014 iii

iv Platform LSF Quick Reference
IBM Platform LSF 9.1.3 Quick Reference
Sample UNIX installation directories

Daemon error log files

Daemon error log files are stored in the directory defined by LSF_LOGDIR in
lsf.conf.

© Copyright IBM Corp. 1992, 2014 1

 LSF base system daemon log files LSF batch system daemon log files

pim.log.host_name mbatchd.log.host_name

res.log.host_name sbatchd.log.host_name

lim.log.host_name mbschd.log.host_name

If EGO_LOGDIR is defined in ego.conf, file lim.log.host_name is stored in the

directory defined by EGO_LOGDIR.

Configuration files

lsf.conf, lsf.shared, and lsf.cluster.cluster_name are located in LSF_CONFDIR.

lsb.params, lsb.queues, lsb.modules, and lsb.resources are located in

LSB_CONFDIR/cluster_name/configdir/.

File Description

install.config Options for LSF installation and

configuration

lsf.conf Generic environment configuration file

describing the configuration and operation of
the cluster

lsf.shared Definition file shared by all clusters. Used to

define cluster name, host types, host models
and site-defined resources

lsf.cluster.cluster_name Cluster configuration files used to define

hosts, administrators, and locality of
site-defined shared resources

lsb.applications Defines application profiles to define

common parameters for the same types of
jobs

lsb.params Configures LSF batch parameters

lsb.queues Batch queue configuration file

lsb.resources Configures resource allocation limits, exports,

and resource usage limits

lsb.serviceclasses Defines service-level agreements (SLAs) in an

LSF cluster as service classes, which define
the properties of the SLA

lsb.users Configures user groups, hierarchical fairshare

for users and user groups, and job slot limits
for users and user groups

Cluster configuration parameters (lsf.conf)

Variable Description UNIX Default

LSF_BINDIR Directory containing LSF user LSF_TOP/version/platform/

commands, shared by all bin
hosts of the same type

2 Platform LSF Quick Reference

Variable Description UNIX Default

LSF_CONFDIR Directory for all LSF LSF_TOP/conf

configuration files

LSF_ENVDIR Directory containing the /etc (if LSF_CONFDIR is not

lsf.conf file. Must be owned defined)
by root.

LSF_INCLUDEDIR Directory containing LSF API LSF_TOP/version/include

header files lsf.h and
lsbatch.h

LSF_LIBDIR LSF libraries, shared by all LSF_TOP/version/platform/

hosts of the same type lib

LSF_LOGDIR (Optional) Directory for LSF /tmp

daemon logs. Must be owned
by root.

LSF_LOG_MASK Specifies the logging level of LOG_WARNING

error messages from LSF
commands

LSF_MANDIR Directory containing LSF man LSF_TOP/version/man

pages

LSF_MISC Help files for the LSF GUI LSF_TOP/version/misc

tools, sample C programs
and shell scripts, and a
template for an external LIM
(elim)

LSF_SERVERDIR Directory for all server LSF_TOP/version/platform/

binaries and shell scripts, and etc
external executables invoked
by LSF daemons, must be
owned by root, and shared
by all hosts of the same type

LSF_TOP Top-level installation Not defined

directory. The path to
LSF_TOP must be shared and Required for installation
accessible to all hosts in the
cluster. It cannot be the root
directory (/).

LSB_CONFDIR Directory for LSF Batch LSF_CONFDIR/lsbatch

configuration directories,
containing user and host lists,
operation parameters, and
batch queues

LSF_LIVE_CONFDIR Directory for LSF live LSB_SHAREDIR/cluster_name/

reconfiguration directories live_confdir
written by the bconf
command.

LSF_SHAREDIR Directory for LSF Batch job LSF_TOP/work

history and accounting log
files for each cluster, must be
owned by primary LSF
administrator

IBM Platform LSF 9.1.3 Quick Reference 3

 Variable Description UNIX Default

LSF_LIM_PORT TCP service port used for 7879

communication with lim

LSF_RES_PORT TCP service port used for 6878

communication with res

LSF_MBD_PORT TCP service port used for 6881

communication with mbatchd

LSF_SBD_PORT TCP service port used for 6882

communication with sbatchd

Administration and accounting commands

Only LSF administrators and root users can use these commands.

Command Description

lsadmin LSF administrative tool to control the

operation of the LIM and RES daemons in an
LSF cluster, lsadmin help shows all
subcommands

lsfinstall Install LSF using install.config input file

lsfrestart Restart the LSF daemons on all hosts in the

local cluster

lsfshutdown Shut down the LSF daemons on all hosts in

the local cluster

lsfstartup Start the LSF daemons on all hosts in the

local cluster

badmin LSF administrative tool to control the

operation of the LSF Batch system including
sbatchd, mbatchd, hosts and queues, badmin
help shows all subcommands

bconf Changes LSF configuration in active memory

Daemons
Executable Name Description

lim Load Information Manager (LIM) — collects

load and resource information about all
server hosts in the cluster and provides host
selection services to applications through
LSLIB. LIM maintains information on static
system resources and dynamic load indices

mbatchd Master Batch Daemon (MBD) — accepts and

holds all batch jobs. MBD periodically checks
load indices on all server hosts by contacting
the Master LIM.

4 Platform LSF Quick Reference

Executable Name Description

mbschd Master Batch Scheduler Daemon — performs

the scheduling functions of LSF and sends
job scheduling decisions to MBD for
dispatch. Runs on the LSF master server host

sbatchd Slave Batch Daemon (SBD) — accepts job

execution requests from MBD, and monitors
the progress of jobs. Controls job execution,
enforces batch policies, reports job status to
MBD, and launches MBD.

pim Process Information Manager (PIM) —

monitors resources used by submitted jobs
while they are running. PIM is used to
enforce resource limits and load thresholds,
and for fairshare scheduling

res Remote Execution Server (RES) — accepts

remote execution requests from all load
sharing applications and handles I/O on the
remote host for load sharing processes.

User commands

Viewing information about your cluster.

Command Description

bhosts Displays hosts and their static and dynamic

resources

blimits Displays information about resource

allocation limits of running jobs

bparams Displays information about tunable batch

system parameters

bqueues Displays information about batch queues

busers Displays information about users and user

groups

lshosts Displays hosts and their static resource

information

lsid Displays the current LSF version number,

cluster name and master host name

lsinfo Displays load sharing configuration

information

lsload Displays dynamic load indices for hosts

Monitoring jobs and tasks.

Command Description

bacct Reports accounting statistics on completed

LSF jobs

IBM Platform LSF 9.1.3 Quick Reference 5

 Command Description

bapp Displays information about jobs attached to

application profiles

bhist Displays historical information about jobs

bjobs Displays information about jobs

bpeek Displays stdout and stderr of unfinished jobs

bsla Displays information about service class

configuration for goal-oriented service-level
agreement scheduling

bstatus Reads or sets external job status messages

and data files

Submitting and controlling jobs.

Command Description

bbot Moves a pending job relative to the last job

in the queue

bchkpnt Checkpoints a checkpointable job

bkill Sends a signal to a job

bmig Migrates a checkpointable or rerunnable job

bmod Modifies job submission options

brequeue Kills and requeues a job

bresize Releases slots and cancels pending job resize

allocation requests

brestart Restarts a checkpointed job

bresume Resumes a suspended job

bstop Suspends a job

bsub Submits a job

bswitch Moves unfinished jobs from one queue to

another

btop Moves a pending job relative to the first job

in the queue

bsub command

Selected options for bsub [options] command[arguments]

Option Description

-ar Specifies the job is autoresizable

-H Holds the job in the PSUSP state at

submission

6 Platform LSF Quick Reference

Option Description

-I|-Ip|-Is Submits a batch interactive job. -Ip creates a

pseudo-terminal. -Is creates a
pseudo-terminal in shell mode.

-K Submits a job and waits for the job to finish

-r Makes a job rerunnable

-x Exclusive execution

-app application_profile_name Submits the job to the specified application

profile

-b begin_time Dispatches the job on or after the specified

date and time in the form
[[month:]day:]:minute

-C core_limit Sets a per-process (soft) core file size limit

(KB) for all the processes that belong to this
job

-c cpu_time[/host_name | /host_model] Limits the total CPU time the job can use.
CPU time is in the form [hour:]minutes

-cwd "current_working_directory" Specifies the current working directory for

the job

-D data_limit Sets the per-process (soft) data segment size

limit (KB) for each process that belongs to
the job

-E "pre_exec_command [arguments]" Runs the specified pre-exec command on the

execution host before running the job

-Ep "post_exec_command [arguments]" Runs the specified post-exec command on

the execution host after the job finishes

-e error_file Appends the standard error output to a file

-eo error_file Overwrites the standard error output of the

job to the specified file

-F file_limit Sets per-process (soft) file size limit (KB) for

each process that belongs to the job

-f "local_file op[remote_file]" ... Copies a file between the local (submission)

host and remote (execution) host. op is one of
>, <, <<, ><, <>

-i input_file | -is input_file Gets the the standard input for the job from
specified file

-J "job_name[index_list]%job_slot_limit" Assigns the specified name to the job. Job

array index_list has the form start[-end[:step]],
and %job_slot_limit is the maximum number
of jobs that can run at any given time.

-k "chkpnt_dir Makes a job checkpointable and specifies the

[chkpnt_period][method=method_name]" checkpoint directory, period in minutes, and
method

-M mem_limit Sets the per-process (soft) memory limit (KB)

IBM Platform LSF 9.1.3 Quick Reference 7

 Option Description

-m "host_name [@cluster_name][[!] | Runs job on one of the specified hosts. Plus

+[pref_level]] | host_group[[!] |+[pref_level]] | (+) after the names of a host or group
compute_unit[[!] |+[pref_level]]..." indicates a preference. Optionally, a positive
integer indicates a preference level with
higher numbers indicating a greater
preference.

-n min_proc[,max_proc] Specifies the minimum and maximum

numbers of processors required for a parallel
job

-o output_file Appends the standard output to a file

-oo output_file Overwrites the standard output of the job to

the specified file

-p process_limit Limit the number of processes for the whole

job

-q "queue_name ..." Submits job to one of the specified queues

-R "res_req" [-R "res_req" ...] Specifies host resource requirements

-S stack_limit Sets a per-process (soft) stack segment size

limit (KB) for each process that belongs to
the job

-sla service_class_name Specifies the service class where the job is to

run

-T thread_limit Sets the limit of the number of concurrent

threads for the whole job

-t term_time Specifies the job termination deadline in the

form [[month:]day:]hour:minute

-v swap_limit Sets the total process virtual memory limit

(KB) for the whole job

-W run_time[/host_name | /host_model] Sets the run time limit of the job in the form
[hour:]minute

-h Prints command usage to stderr and exitse

-V Prints LSF release version to stderr and exits

8 Platform LSF Quick Reference

Notices
This information was developed for products and services offered in the U.S.A.

IBM® may not offer the products, services, or features discussed in this document
in other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte character set (DBCS) information,

contact the IBM Intellectual Property Department in your country or send
inquiries, in writing, to:

Intellectual Property Licensing

Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS

PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web

© Copyright IBM Corp. 1992, 2014 9

 sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:

IBM Corporation
Intellectual Property Law
Mail Station P300
2455 South Road,
Poughkeepsie, NY 12601-5400
USA

Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.

The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.

Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which

illustrates programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application

10 Platform LSF Quick Reference

 programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. The sample
programs are provided "AS IS", without warranty of any kind. IBM shall not be
liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. _enter the year or years_.

If you are viewing this information softcopy, the photographs and color
illustrations may not appear.

Trademarks
IBM, the IBM logo, and ibm.com® are trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and
service names might be trademarks of IBM or other companies. A current list of
IBM trademarks is available on the Web at "Copyright and trademark information"
at http://www.ibm.com/legal/copytrade.shtml.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.

Java™ and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.

Linux is a trademark of Linus Torvalds in the United States, other countries, or

both.

LSF®, Platform, and Platform Computing are trademarks or registered trademarks

of International Business Machines Corp., registered in many jurisdictions
worldwide.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of

others.

Privacy policy considerations

IBM Software products, including software as a service solutions, (“Software
Offerings”) may use cookies or other technologies to collect product usage
information, to help improve the end user experience, to tailor interactions with
the end user or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings
can help enable you to collect personally identifiable information. If this Software

Notices 11
 Offering uses cookies to collect personally identifiable information, specific
information about this offering’s use of cookies is set forth below.

This Software Offering does not use cookies or other technologies to collect
personally identifiable information.

If the configurations deployed for this Software Offering provide you as customer
the ability to collect personally identifiable information from end users via cookies
and other technologies, you should seek your own legal advice about any laws
applicable to such data collection, including any requirements for notice and
consent.

For more information about the use of various technologies, including cookies, for
these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and
IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the
section entitled “Cookies, Web Beacons and Other Technologies” and the “IBM
Software Products and Software-as-a-Service Privacy Statement” at
http://www.ibm.com/software/info/product-privacy.

12 Platform LSF Quick Reference




Printed in USA

GC27-5309-03