Readme file for IBM® Spectrum LSF 10.1 Fix 601752


Abstract

P104972.  Fix to allow dynamic servers to efficiently move to ok status after running the lsadmin reconfig command on IBM Cloud.


Description

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

This fix addresses the following issue:

Dynamic servers are very slow to move to ok status after running the  lsadmin reconfig command in an IBM Cloud environment. This fix introduces a new parameter to resolve this issue.

Syntax:

LSF_UDP_TO_TCP_THRESHOLD=integer

Configure LSF_UDP_TO_TCP_THRESHOLD in the lsf.conf file to the MTU size of your network. After the packet is compressed, if the packet size is still greater than this parameter, LSF will switch to use TCP. When not configured, LIM UDP communications will not be switched to TCP. If you configure this parameter too small, performance can decrease as many LIM communications will use TCP instead of UDP. If you configure the parameter too large, you can see dropping of packets depending on your network configuration. When not configured, LIM UDP communications will not be switched to TCP.

The minimum supported value for LSF_UDP_TO_TCP_THRESHOLD is 1500.

 

As a best practive, when using the LSF_UDP_TO_TCP_THRESHOLD parameter, also:

-        Set LSF_ANNOUNCE_MASTER_TCP_WAITTIME to be 600 seconds.

-        Do not use or remove LSF_SEND_CONFINFO_TCP_THRESHOLD  settings

-        Do not use or
remove LSF_CALL_LIM_WITH_TCP settings, or set it to N or n.

 

Readme file for: IBM® Spectrum LSF

Product or component release: 10.1

Update name: Fix 601752

Fix ID: LSF-10.1-build601752

Publication date: 17 November 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

P104972

 

2. Download locations

Download fix 601752 from the following location: https://www.ibm.com/support/fixcentral

 

3. Product or components affected

Affected product or components include:

LSF/lim
LSF/lsload
LSF/lshosts

 

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.     You must have LSF 10.1 Fix Pack 12 or above installed before installing this fix. Download this fix pack from IBM Fix Central (https://www.ibm.com/support/fixcentral) and search for build600488. Contact IBM LSF Support if you have any questions or problems with installing Fix Pack 12.

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, the above GPU parameters not configured in the lsf.conf configuration file will take the default values above, 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 cluster primary administrator and set the LSF cluster environment.

4.     Run lsadmin limshutdown all

 

Installation steps

1.     Log on to the LSF management 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

3.  Go to the install directory of the fix: cd $LSF_ENVDIR/../10.1/install/

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

5.     Run patchinstall: ./patchinstall <fix>

 

After you install

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

2.     Configure LSF_UDP_TO_TCP_THRESHOLD in the lsf.conf file to the MTU size of your network.
As a best practice, when using the
LSF_UDP_TO_TCP_THRESHOLD parameter, also:

·       Set LSF_ANNOUNCE_MASTER_TCP_WAITTIME to be 600 seconds.

·       Do not use or remove LSF_SEND_CONFINFO_TCP_THRESHOLD settings

·       Do not use or remove LSF_CALL_LIM_WITH_TCP settings, or set it to N or n.

3.     Run lsadmin limstartup all

Uninstallation

1.     Log on to the LSF management host as root and set the LSF cluster environment.

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

3.     Run ./patchinstall -r <fix>

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

5.     Run lsadmin limshutdown all

6.   Run lsadmin limstartup all

 

6. List of files

lim
lsload
lshosts

 

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.