IBM® Spectrum LSF 10.1 Fix 555171 Readme File 

Abstract


P103804. Fix to ensure that the Docker image information can be transferred successfully and enhancement to enable Docker image affinity.

Description


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

This fix addresses the following issue:

1. Change LSF to use the TCP protocol for the Docker image information transformation between the master LIM and the mbatchd daemon, and between the slave LIM and master LIM, to avoid failure when using the UDP protocol if the message size is large.

2. Introduce a new parameter "LSF_DOCKER_IMAGE_UPDATE_INTERVAL" to the lsf.conf file to enable the Docker image affinity feature. The following is a description of this parameter:


Syntax


       LSF_DOCKER_IMAGE_UPDATE_INTERVAL= 0 | time_in_seconds


Description


       - If LSF_DOCKER_IMAGE_UPDATE_INTERVAL is not defined or is set to 0, Docker image affinity related functions are disabled. In this case, the LSB_DOCKER_IMAGE_AFFINITY environment variable in the job submission environment and the DOCKER_IMAGE_AFFINITY parameter value in the lsb.applications, lsb.queues, and lsb.params files are ignored.


       - If LSF_DOCKER_IMAGE_UPDATE_INTERVAL is set to a positive integer, users can enable Docker image affinity features at the job, application, queue, or cluster level by setting the LSB_DOCKER_IMAGE_AFFINITY environment variable in the job submission environment or setting the DOCKER_IMAGE_AFFINITY parameter in the lsb.applications, lsb.queues, or lsb.params file. The defined value determines the interval of the mbatchd daemon getting the Docker image affinity information from the master LIM, and the interval of the slave LIMs checking whether the Docker image information changes and whether this information needs to be sent to the master LIM.


Default


       0. Docker image affinity feature is disabled.


Readme File for: IBM® Spectrum LSF

Product/Component Release: 10.1

Update Name: Fix 555171

Fix ID: LSF-10.1-build555171

Publication Date: Aug 17, 2020

Last Modified Date: Aug 17, 2020

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

P103804


2. Download Locations

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


3. Product or Components Affected

Affected product or components include:

LSF/lim

LSF/mbatchd

LSF/mbschd

LSF/bsub


4. System Requirements

linux2.6-glibc2.3-x86_64

linux3.10-glibc2.17-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 the LSF cluster 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/../10.1/install/ 

2) Copy the patch file to the install directory $LSF_ENVDIR/../10.1/install/ 

3) Run patchinstall: ./patchinstall <patch> 


5.3 After installation

1) Log on to the LSF master host as the LSF cluster primary administrator and set the LSF cluster environment 

2) Run lsadmin limrestart all

3) Run badmin mbdrestart 


5.4 Uninstallation

1) Log on to the LSF master host as root and set the LSF cluster environment: 

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

3) Run ./patchinstall -r <patch> 

4) Log on to the LSF master host as the LSF cluster primary administrator and set the LSF cluster environment 

5) Run lsadmin limrestart all

6) Run badmin mbdrestart 



6. List of Files

lim

mbatchd

mbschd

bsub


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 2020


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.