IBM Spectrum LSF 10.1 Fix BUILD 433830 Readme File
Abstract
RFE #77813. This fix enables LSF_UNIT_FOR_LIMITS to define a unit for "tmp", and also supports the specified unit in resource requirements and limits on the command line.
Description
Readme documentation for IBM Spectrum LSF 10.1 Fix 433830 including installation-related instructions, prerequisites and corequisites, and list of fixes.
This fix addresses the following issue:
The "tmp" resource is not supported by the LSF_UNIT_FOR_LIMITS parameter. Specifying a unit for resource requirements and limits on the command line is also not supported.
A new parameter LSF_ENABLE_TMP_UNIT in lsf.conf enables LSF_UNIT_FOR_LIMITS to support limits on "tmp". Users can also specify units for the resource requirement (-R option) and limits (-C, -D, -F, -M, -S, -v options) for the bsub, bmod, and brestart commands.
1 Support LSF_UNIT_FOR_LIMITS for TMP
LSF_ENABLE_TMP_UNIT is a new parameter introduced in lsf.conf, which applies to "tmp" for the LSF_UNIT_FOR_LIMITS. The display of "tmp" in query commands (bjobs, bqueues, bhosts, lsload, lshosts, lsmon) will also be affected.
LSF_ENABLE_TMP_UNIT
Syntax
LSF_ENABLE_TMP_UNIT=Y|y|N|n
Description
The default value is LSF_ENABLE_TMP_UNIT=N|n. By default, the LSF_UNIT_FOR_LIMITS parameter does not affect "tmp", and the unit of "tmp" for limits and resource requirements is MB.
When LSF_ENABLE_TMP_UNIT=Y|y, the units defined by the LSF_UNIT_FOR_LIMITS parameter applies cluster-wide to "tmp":
- Resource requirements at the job-level (bsub), queue-level (lsb.queues), and application-level (lsb.applications).
- TMP in Limit section, RES_SELECT in GuaranteedResourcePool Section and HostExport Section in lsb.resources.
- Load_index threshold in lsb.queues, lsb.hosts.
Example
When LSF_ENABLE_TMP_UNIT=Y|y is set, and LSF_UNIT_FOR_LIMIT=GB, the following job submission means "mem=1GB, swp=2GB, tmp=3GB and tmp>3GB":
bsub -R "rusage[mem=1,swp=2,tmp=3] select[tmp>3]"
Important
Before you enable the feature, completely drain the cluster of all workload so that no running, pending, or finished jobs are in the system.
In the LSF multi-cluster environment, you should configure the same unit for all clusters.
Default
N|n.
2 Specify customized unit
For the bsub, bmod, and brestart commands, you can use the following units for resource requirements and limits: KB (or K), MB (or M), GB (or G), TB (or T), PB (or P), EB (or E), ZB (or Z). The specified unit is converted to the appropriate value specified by the LSF_UNIT_FOR_LIMITS parameter. For the file size limit specified by the bsub -F option, LSF always converts to unit KB. The converted limit values round up to a positive integer. For resource requirements, you can specify unit for mem, swp and tmp in select and rusage section.
For example, if LSF_ENABLE_TMP_UNIT=Y and LSF_UNIT_FOR_LIMIT=GB are set, the following conversion happens:
bsub -C 500MB -M 1G -S 1TB -F 1M -R "rusage[mem=512MB:swp=1GB:tmp=1TB]" sleep 100
is converted inside bsub to:
bsub -C 1 -M 1 -S 1024 -F 1024 -R "rusage[mem=0.5:swp=1:tmp=1024]" sleep 100
3 Limitation
When LSF_ENABLE_TMP_UNIT = Y|y and LSF_UNIT_FOR_LIMITS is not MB, new lim and old query commands have compatibility issues. The unit for "tmp" changes with LSF_UNIT_FOR_LIMITS in lim, but query commands still display the unit for "tmp" as MB.
Readme file for: IBM® Spectrum LSF
Product/Component Release: 10.1
Update Name: Fix 433830
Fix ID: LSF-10.1-build433830
Publication date: 5 December 2016
Last modified date: 5 December 2016
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. Product notifications
8. Copyright and trademark information
1. List of fixes
RFE #77813
2. Download Location
Download Fix 433830 from the following location: http://www.ibm.com/eserver/support/fixes/
3. Products or components affected
Affected components include: LSF/lim, LSF/bsub, LSF/bmod, LSF/brestart, LSF/bjobs, LSF/bqueues, LSF/bhosts, LSF/lsload, LSF/lshosts, LSF/lsmon
4. System requirements
linux2.6-glibc2.3-x86_64
linux3.10-glibc2.17-x86_64
sparc-sol10-64
x86-64-sol10
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/../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 root
2) lsadmin limrestart -f all
3) 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) lsadmin limrestart -f all
4) badmin mbdrestart
6. List of files
lim
bsub
bmod
brestart
bjobs
bqueues
bhosts
lsload
lshosts
lsmon
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 2016
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.