IBM Platform LSF 8.3 Fix 247113 Readme File

Abstract

APAR P100815: Fix to use LSF_NIOS_DIE_CMD to customize the command and output for interactive jobs that cannot be executed when the LSF_NIOS_PEND_TIMEOUT value expires.

Description

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

This fix addresses the following issue:

When the LSF_NIOS_PEND_TIMEOUT environment variable is set, interactive jobs cannot be executed after the LSF_NIOS_PEND_TIMEOUT value expires. The job is killed and returns a message such as "Job <xxx> is being terminated". You can use the LSF_NIOS_DIE_CMD environment variable to specify a customized command and output message when the LSF_NIOS_PEND_TIMEOUT value expires. See the following example:

user@host1: setenv LSF_NIOS_PEND_TIMEOUT 1
user@host1: setenv LSF_NIOS_DIE_CMD "bkill %J > /dev/null; echo job %J is terminated by bkill;"
user@host1: echo $LSF_NIOS_DIE_CMD
bkill %J > /dev/null; echo job %J is terminated by bkill;
user@host1: bsub -I "echo test"
Job <16> is submitted to default queue <normal>.
<<Waiting for dispatch ...>>
job 16 is terminated by bkill

About the LSF_NIOS_DIE_CMD environment variable:
1.The default value is "bkill jobid"
2.LSF_NIOS_DIE_CMD supports the %J variable, so you can use the job ID when you specify the custom command for LSF_NIOS_DIE_CMD.

Readme file for: IBM® Platform LSF

Product/Component Release: 8.3

Update Name: Fix 247113

Fix ID: LSF-8.3-build247113

Publication date: 18 November 2014

Last modified date: 18 November 2014

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. Copyright and trademark information

1. List of fixes

P100815

2. Download Location

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

3. Products or components affected

Affected components include: LSF/bsub

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/../8.3/install/

2)    Copy the patch file to the install directory $LSF_ENVDIR/../8.3/install/

3)    Run patchinstall: ./patchinstall <patch>

5.3 After installation

None

5.4 Uninstallation

To roll back a patch:

1)    Log on to the LSF master host as root

2)    Run ./patchinstall -r <patch>

6. List of files

bsub

7. Copyright and trademark information

© Copyright IBM Corporation 2014

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.