IBM Platform LSF 9.1.2 Fix 354624 Readme File

Abstract

P101220. Provides a job level energy usage data collection option that overrides cluster level energy usage data collection.

Description

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

This fix addresses the following issue:

The Performance Application Programming Interface (PAPI) conflicts with hardware counter data collection in LSF. When LSF_COLLECT_ENERGY_USAGE in lsf.conf is set to "Y", jobs submitted with energy aware scheduling options and using PAPI do not trigger hardware counters correctly.

This fix introduces the esub environment variable LSB_SUB4_COLLECT_ENERGY_USAGE that allows LSF to collect energy-related usage data at the job level, narrowing down the cluster level energy usage data collection.

Syntax
LSB_SUB4_COLLECT_ENERGY_USAGE=Y|N|ENERGY

Description
Specifies whether LSF collects energy-related usage information at the job level and narrows down the value of LSF_COLLECT_ENERGY_USAGE in lsf.conf.

Valid values
- Y: LSF collects both energy and hardware usage information at the job level.
- N: LSF does not collect energy or hardware usage information at the job level.
- ENERGY: LSF only collects energy usage information at the job level.

Default
Not defined

Readme file for: IBM® Platform LSF

Product/Component Release: 9.1.2

Update Name: Fix 354624

Fix ID: LSF-9.1.2-build354624

Publication date: 17 August 2015

Last modified date: 17 August 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

P101220

2. Download Location

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

3. Products or components affected

Affected components include: LSF/bsub 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

bsub 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.