IBM Platform LSF 9.1.1 Fix 340749 Readme File

Abstract

P101083. Fix to prevent a performance issue caused by the bjobs retry time after exceeding the query limit, and to allow error messages to be muted or customized in the bjobs command output.

Description

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

This fix addresses the following issue:

A performance issue occurs when bjobs attempts to query mbatchd every one second.

This fix makes the bjobs retry interval configurable by adding the following new parameter in lsf.conf:

Syntax
LSB_QUERY_RETRY_INTERVAL_STEP=seconds

Description
This parameter defines how often LSF libraries attempt to contact mbatchd or perform a concurrent jobs query. For each subsequent attempt to contact mbatchd or perform a concurrent jobs query, LSF increases the interval by this amount.

For example, if LSB_QUERY_RETRY_INTERVAL_STEP=2 and the initial attempt fails, LSF makes the first retry attempt two seconds after the initial attempt, and if this attempt fails, LSF makes the second retry four seconds after the last retry attempt, and continues until the attempt succeeds or the LSB_NTRIES value is reached.

Default
1 second.

This fix also makes the error message configurable by adding the following new parameter in lsf.conf:

LSB_MBD_QUERY_RETRY_MSG

Syntax

LSB_MBD_QUERY_RETRY_MSG="message_string"

Description

Specifies the message displayed by the bjobs command when the number of concurrent bjobs queries exceeds the value of the MAX_CONCURRENT_JOB_QUERY parameter specified in lsb.params.

Define this parameter if you want to customize the message.

Valid values
String, either non-empty or empty.

Default
Not defined. By default, LSF displays the message "Batch system concurrent job query limit exceeded. LSF is retrying. Please wait ..."

Readme file for: IBM® Platform LSF

Product/Component Release: 9.1.1

Update Name: Fix 340749

Fix ID: LSF-9.1.1-build340749

Publication date: 13 May 2015

Last modified date: 13 May 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

P101083

2. Download Location

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

3. Products or components affected

Affected components include: LSF/bjobs

4. System requirements

Linux2.6-glibc2.3-x86_64
Solaris 10 x86_64
Solaris 10 Sparc_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

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

bjobs

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.