IBM Platform LSF 9.1.2 Fix 244172 Readme File

Abstract

APAR P100694: Fix to address the failed execution of jobs that use PAPI to access hardware counters when energy accounting is enabled.

Description

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

This fix addresses the following issue:

Performance Application Programming Interface (PAPI) conflicts with the hardware counters collection functionality in LSF.
When LSF_COLLECT_ENERGY_USAGE is set to "Y", energy jobs using PAPI cannot access hardware counters correctly.

This fix updates the configuration syntax of LSF_COLLECT_ENERGY_USAGE as:

LSF_COLLECT_ENERGY_USAGE=Y|N|ENERGY

When set to "Y", LSF collects both energy consumption and hardware counters for jobs. The default value "N" disables those collections for jobs.
When set to "ENERGY", LSF only collects energy consumption for jobs. Energy jobs using PAPI can run correctly with this option.

Readme file for: IBM® Platform LSF

Product/Component Release: 9.1.2

Update Name: Fix 244172

Fix ID: LSF-9.1.2-build244172

Publication date: 16 October 2014

Last modified date: 16 October 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

P100694

2. Download Location

Download Fix 244172 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)    Set LSF_COLLECT_ENERGY_USAGE=ENERGY in lsf.conf

3)    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)    Set LSF_COLLECT_ENERGY_USAGE=Y|N in lsf.conf

4)    Run badmin mbdrestart

6. List of files

mbatchd

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.