Solution Readme

===============================================================================
Readme file for: LSF
Product/Component Release: 9.1.2
Update name: MultiCluster support for application level PROCLIMIT
Publication date: 26 March 2014
Last modified: 26 March 2014

Abstract: This enhancement enables IBM Platform MultiCluster ("MultiCluster") to consider the remote
application level PROCLIMIT configuration before forwarding jobs to the execution cluster. This enhancement
is for the MultiCluster job forwarding model only.

===============================================================================

=========================
CONTENTS
=========================
1. Abbreviations
2. About MultiCluster support for application level PROCLIMIT
3. Supported operating systems
4. Products or components affected
5. Installation and Configuration
6. Copyright

=========================
1. Abbreviations
=========================
PROCLIMIT - Maximum number of slots that can be allocated to a job

=========================
2. About MultiCluster support for application level PROCLIMIT
=========================
LSF does not consider the remote PROCLIMIT configuration of application profiles before forwarding jobs to
the execution cluster. When execution clusters configure different PROCLIMIT parameters to suit application
execution, LSF rejects and returns the jobs to the submission cluster if the jobs cannot be executed in the
execution cluster. The jobs may become suspended in the submission cluster.

This enhancement provides the following functions in the MultiCluster job forwarding model:
- Submission clusters support the use of PROCLIMIT in the application profile on execution clusters.
- LSF considers the PROCLIMIT in the remote application profile before forwarding jobs to the execution
cluster. If the execution cluster's application profile PROCLIMIT cannot satisfy the job slots requirement, LSF
does not forward the job to the execution cluster. This reduces the number of jobs that LSF rejects and returns
to the submission cluster after the job is first forwarded to the execution cluster.

=========================
3. Supported operating systems
=========================
linux2.6-glibc2.3-x86_64

=========================
4. Products or components affected
=========================
LSF/mbatchd
LSF/mbschd
LSF/schmod_mc.so

=========================
5. Installation and Configuration
=========================
5.1 Before installation

(LSF_TOP: Full path to the top-level installation directory of LSF.)
1. Log on to the LSF master host as root.
2. Set your environment:
- For csh or tcsh: % source LSF_TOP/conf/cshrc.lsf
- For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

5.2 Installation steps

1. Go to the patch install directory: cd $LSF_ENVDIR/../9.1/install/
2. Copy the patch file to the install directory $LSF_ENVDIR/../9.1/install/
3. Run patchinstall: ./patchinstall <patch>

5.3 After installation

Run badmin mbdrestart

5.4 Uninstalling

To roll back a patch:
1. Run as root
2. Run ./patchinstall -r <patch>
3. Run badmin mbdrestart

=========================
6. Copyright
=========================

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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 www.ibm.com/legal/copytrade.shtml