Readme file for IBM® Spectrum LSF 10.1 Fix 601821

Abstract

P105008. When ALLOCATION_PLANNER is enabled in lsb.params, this patch addresses the following problems: 1) Allocation plans are cancelled unexpectedly for jobs that request memory in their rusage strings; and, 2) LSF does not reserve sufficient resources to ensure that an allocation plan is carried out.

 

Description

Readme documentation for IBM Spectrum LSF 10.1 Fix 601821, including installation-related instructions, prerequisites and co-requisites, and list of fixes.

This fix addresses the following issues with plan-based allocation, which is enabled using the parameter  ALLOCATION_PLANNER in lsb.params:

1.     For jobs that specify memory in their rusage strings, allocation plans can be cancelled unexpectedly in certain cases. The result is that these jobs are delayed from dispatching.

2.     Once LSF creates an allocation plan, it must reserve sufficient resources to ensure that the plan is carried out.  In some cases, LSF will not reserve sufficient resources. As a result, jobs without allocation plans are able to dispatch on resources needed for planned jobs, and delaying dispatch of the planned jobs. This fix ensures that sufficient resources are reserved for planned jobs.

 

Readme file for: IBM® Spectrum LSF

Product or component release: 10.1

Update name: Fix 601821

Fix ID: LSF-10.1-build601821

Publication date: 1 December 2023

 

Contents

1. List of fixes

2. Download location

3. Product 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

P105008

 

2. Download locations

Download Fix 601821 from the following location: https://www.ibm.com/support/fixcentral

 

3. Product or components affected

Affected product or components include:

LSF/mbatchd

LSF/mbschd

LSF/ebrokerd

LSF/bjobs

LSF/bhosts

 

4. System requirements

linux2.6-glibc2.3-x86_64

linux3.10-glibc2.17-x86_64

 

5. Installation and configuration

Before you install

LSF_TOP is the full path to the top-level installation directory of LSF.

1.      Before you apply this fix, ensure that you installed LSF 10.1 Fix Pack 12 or later.

2.      Starting in LSF 10.1 Fix Pack 13, the default values of the following three GPU parameters are changed to:
LSF_GPU_AUTOCONFIG=Y
LSB_GPU_NEW_SYNTAX=extend
LSF_GPU_RESOURCE_IGNORE=Y

If you have Fix Pack 13 installed, these GPU parameters not configured in the lsf.conf configuration file will take the default values, and the parameters already configured in the lsf.conf file will not be affected.

If you want to keep the former GPU behavior, and if any of the three parameters are missing in the lsf.conf configuration file, you must explicitly configure the following default settings that are defined in Fix Pack 12 or earlier:
LSF_GPU_AUTOCONFIG=N
LSB_GPU_NEW_SYNTAX=N
LSF_GPU_RESOURCE_IGNORE=N

3.      Log on to the LSF management host as the LSF primary administrator.

4.      Set your environment:
-For csh or tcsh
: % source LSF_TOP/conf/cshrc.lsf
-For sh, ksh, or bash: $ . LSF_TOP/conf/profile.lsf

Installation steps

1.      Log on to the LSF management host as the root user and set your environment:
-For csh or tcsh:
% source LSF_TOP/conf/cshrc.lsf

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

2.      Go to the install directory: cd $LSF_ENVDIR/../10.1/install/

3.      Copy the fix file to the install directory: $LSF_ENVDIR/../10.1/install/

4.      Run patchinstall: ./patchinstall <fix>

After you install

1.      Log on to the LSF management host as the LSF primary administrator and set your environment:

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

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

2.      Run badmin mbdrestart -s

Uninstallation

1.      Log on to the LSF management host as the root user and set your environment:

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

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

2.      Go to the install directory: cd $LSF_ENVDIR/../10.1/install/

3.      Run ./patchinstall -r <fix>

4.      Log on to the LSF management host as the LSF primary administrator and set your environment:

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

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

5.      Run badmin mbdrestart -s

 

6. List of files

The following components in all Linux and UNIX packages:

LSF/mbatchd

LSF/mbschd

LSF/ebrokerd

LSF/bjobs

LSF/bhosts

 

 7. Product Notifications

To receive information about product solution and fix 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 2023

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.