IBM Platform LSF 9.1.3 Fix LSF Readme File

Abstract

P100805. Fix to avoid having a job with an exit dependancy specifying an exit value running when the dependant job is killed while pending.

Description

Readme documentation for IBM Platform LSF 9.1.3 Fix LSF including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issue:

Avoid having a job with an exit dependancy specifying an exit value running when the dependant job is killed while pending.

Consider the following when the orphan job detection feature is enabled. Three job are submitted J1, J2, and J3. J2 has an exit dependancy on J1, and J3 has an exit dependancy on J2.

user@host ~: bsub sleep 9999
Job <1> is submitted to default queue <normal>.
user@host ~: bsub -w "exit(1,<10)" sleep 8888
Job <2> is submitted to default queue <normal>.
user@host ~: bsub -w "exit(2,<10)" sleep 7777
Job <3> is submitted to default queue <normal>.

Job J1 will run, and jobs J2 and J3 will pend.

Before this fix if J1 were killed by the user (bkill) it would have an exit value of 130, job J2 would be killed by LSF (with TERM_ORPHAN_SYSTEM) becuase its dependancy could never be realized. Job J3 would run because J2's status is now exit. In this scenario job J2 never ran, but after LSF kills the pending job J2, job J3 runs. This is not what is usually wanted. When a job exit dependancy also includes an exit value LSF now ensures that the dependant job actually ran (which means a starting PID has been reported for the job, excluding pre-exec commands). After this fix, job J3 would also be killed by LSF (with TERM_ORPHAN_SYSTEM) becuase its dependancy could never be realized.

Readme file for: IBM® Platform LSF

Product/Component Release: 9.1.3

Update Name: Fix LSF

Fix ID: LSF-9.1.3-buildLSF

Publication date: 25 March 2015

Last modified date: 25 March 2015

Contents:

1. List of fixes

2. Download location

3. Products or components affected

4. System requirements

5. Installation and configuration

6. List of files

7. Product notifications

8. Copyright and trademark information

1. List of fixes

P100805

2. Download Location

Download Fix LSF from the following location: http://www.ibm.com/eserver/support/fixes/

3. Products or components affected

Affected components include: LSF/mbatchd

4. System requirements

Linux2.6-glibc2.3-x86_64

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

1)    Log on to the LSF master host as root

2)    Run badmin mbdrestart

5.4 Uninstallation

To roll back a patch:

1)    Log on to the LSF master host as root

2)    Run ./patchinstall -r <patch>

3)    Run badmin mbdrestart

6. List of files

mbatchd

7. Product notifications

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My notifications page (www.ibm.com/support/mynotifications) on the IBM Support website (support.ibm.com). You can edit your subscription settings to choose the types of information you want to get notification about, for example, security bulletins, fixes, troubleshooting, and product enhancements or documentation changes.

8. Copyright and trademark information

© Copyright IBM Corporation 2015

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.