Readme for IBM Platform LSF 9.1.2 Fix Pack Build 229602

Description

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

Readme File for: IBM® Platform™ LSF

Product/Component Release: LSF 9.1.2

Update Name: Fix Pack

Fix ID: LSF-9.1.2-build229602

Publication date: 12 Feb 2014

Last modified date: 12 Feb 2014

Contents:

1. Download location

2. Products or components affected

3. System requirements

4. Installation and configuration

5. List of fixes

6. List of files

7. Copyright and trademark information

1. Download location

http://www.ibm.com/eserver/support/fixes/

2. Products or components affected

Product/Component Name, Platform, Fix ID:

LSF/sbatchd, linux2.6-glibc2.3-x86_64, LSF-9.1.2-build229602

LSF/sbatchd, aix-64, LSF-9.1.2-build229602

3. System requirements

This enhancement applies to the systems that LSF currently supports.

4. Installation and configuration

4.1 Before installing this Fix Pack, install IBM Platform LSF 9.1.2.

4.2 Installation steps

1. Set the LSF environment:

For csh or tcsh: source LSF_TOP/conf/cshrc.lsf

For sh, ksh, or bash: LSF_TOP/conf/profile.lsf

2. Shut down the cluster:

lsfshutdown

3. Navigate to the patch install directory:

cd $LSF_ENVDIR/../9.1/install/

4. Run the patch installer to install the Fix Pack:

sudo ./patchinstall lsf9.1.2_linux2.6-glibc2.3-x86_64-229602.tar.Z

sudo ./patchinstall lsf9.1.2_aix-64-229602.tar.Z

5. Define LSB_MEMLIMIT_SWP_PERCENT in lsf.conf:

LSB_MEMLIMIT_SWP_PERCENT=<threshold>[:all]

6. Start the cluster:

sudo lsfstartup

4.3 Uninstalling

To roll back a patch, use patchinstall –r:

sudo ./patchinstall –r lsf9.1.2_linux2.6-glibc2.3-x86_64-229602.tar.Z

sudo ./patchinstall –r lsf9.1.2_aix-64-229602.tar.Z

4.4 Manual Installation

1. Rename the current $LSF_SERVERDIR/sbatchd to $LSF_SERVERDIR/sbatchd.orig.

2. Install the sbatchd patch to $LSF_SERVERDIR.

3. Set LSB_MEMLIMIT_SWP_PERCENT=<threshold>[:all] in the lsf.conf configuration file.

4. Choose one host and then run “badmin hrestart”. You can test the feature on this host.

5. To enable the feature on all hosts, restart sbatchd on all the other hosts.

5. List of fixes

Enable Smart Memory Limit Enforcement by setting the following parameter in lsf.conf:

LSB_MEMLIMIT_SWP_PERCENT=<threshold>[:all]

Description:

<threshold > represents the ratio of used swap space to total swap space on a node. If this threshold is reached on any node, smart memory limit enforcement will be applied to single host jobs. By default, only the worst offending job will be terminated. A job is selected as the worst offending job on that host if it has the most over use of memory (actual memory rusage minus memory limit of the job). LSF will repeat the checking and job termination process at a maximum frequency of SBD_SLEEP TIME.

Threshold must be an integer greater than 0 and less than 100. It will be used in LSF as a percentage.

“:all” means terminate all single host jobs that are over the memory limit.

If the cgroup memory enforcement feature is enabled, LSB_MEMLIMIT_SWP_PERCENT will be ignored.

This parameter does not have any effect on jobs running across multiple hosts. They will be terminated if they are over the memory limit, regardless of swap usage on the execution host.

Default:

Not enabled. All jobs over the memory limit will be terminated.

6. List of files

sbatchd

7. Copyright and trademark information

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.