IBM Spectrum LSF 10.1 Fix 541076 Readme File

Abstract 

This fix supports EFA-enabled EC2 instances and AWS launch templates in the LSF resource connector plug-in. This fix provides flexibility to add additional AWS attributes, including EFA, to the current RC template supported features.

This fix requires LSF 10.1 Fix Pack 8 or above.  

Description

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

This fix includes the following issue:
The existing LSF resource connector (RC) plug-in for AWS does not have support for EFA-enabled instances. The EFA feature has to be explicitly enabled via command-line arguments or flags to the EC2 API.

This fix introduces the interfaceType attribute to the AWS RC template to enable EFA instances. Additionally, AWS RC templates also have the new launchTemplateId and launchTemplateVersion attributes to launch on-demand and spot instances from AWS templates. This provides flexibilty to include additional AWS attributes, including EFA, to the current RC template supported features.

An example to specify interfaceType in the RC template
{
   "templateId": "aws-vm-1",
   "maxNumber": 2,
   "attributes": {
      "type": ["String", "X86_64"],
      "ncores": ["Numeric", "1"],
      "ncpus": ["Numeric", "1"],
      "mem": ["Numeric", "512"],
      "awshost": ["Boolean", "1"],
      "zone": ["String", "us_west_2a"],
      "pricing": ["String", "spot"]
   },
   "imageId": "ami-07e3bcfe7a2a2fbb8",
   "vmType": "c5n.18xlarge",
   "keyName": "ib19b07",
   "interfaceType" : "efa",
   "placementGroupName": "pg_1",
   "tenancy": "default",
   "securityGroupIds": ["sg-08f1a36be62fe02a4"],
   "subnetId": "subnet-0fe69d290ae026155",
   "fleetRole": "arn:aws:iam::700071821657:role/EC2-Spot-Fleet-role",
   "allocationStrategy":"lowestPrice",
   "spotPrice": "1.16",
   "userData": "zone=us_west_2a;pricing=spot"
}

An example to specify launchTemplateId and launchTemplateVersion in the RC template
{
   "templateId": "aws-vm-1",
   "maxNumber": 6,
   "priority" : 80,
   "attributes": {
      "type": ["String", "X86_64"],
      "ncores": ["Numeric", "1"],
      "ncpus": ["Numeric", "1"],
      "mem": ["Numeric", "512"],
      "awshost": ["Boolean", "1"],
      "zone": ["String", "us_west_2b"],
      "pricing": ["String", "spot"]
   },
   "launchTemplateId" : "lt-007f0f860d19c8848",
   "launchTemplateVersion" : "$Latest",
   "fleetRole": "arn:aws:iam::700071821657:role/aws-ec2-spot-fleet-tagging-role",
   "allocationStrategy":"lowestPrice",
    "spotPrice": "1.16"
}

Readme file for: IBM® Spectrum LSF

Product/Component Release: 10.1 

Update Name: Fix 541076 

Fix ID:LSF-10.1-build541076  

Publication date: 25 Febuary 2020 

Last modified date: 25 Febuary 2020 

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 135253

2.   Download Location

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

3.   Products or components affected

Components affected by the new issues addressed in LSF Version 10.1 Fix 541076 include:

LSF/AwsTool.jar
LSF/aws-java-sdk-1.11.699.jar
LSF/ebrokerd

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 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)    Run
badmin mbdrestart

5.4          Uninstallation

To roll back a patch:

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

3)    Run ./patchinstall -r <patch>

4)    Run
badmin mbdrestart

6.   List of files in package 

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.