Readme File for IBM® Spectrum Symphony Interim Fix 523655

Readme file for: IBM Spectrum Symphony

Product/Component Release: 7.2.1.1

Fix ID: sym-7.2.1.1-build523655-pimco

Publication date: July 8, 2019

When RFE 133602 (which supports fractional number of cores and RAM per slot) is applied to your IBM Spectrum Symphony 7.2.1.1 cluster, and you use the symA requestor to provision hosts through HostFactory, this interim fix provides a resolution for overprovisioning of hosts from the AWS cloud.

Contents

1. List of fixes

2. Download location

3. Product and components affected

4. Installation and configuration

5. Uninstallation

6. List of files

7. Product notifications

8. Copyright and trademark information

 

1.    List of fixes

APAR: P103094

2.    Download location

Download interim fix 523655 from the following location: https://www.ibm.com/eserver/support/fixes/

3.    Product and components affected

Component name, Platform, Fix ID:

EGO, Linux x86_64, sym-7.2.1.1-build523655-pimco

4.    Installation and configuration

Follow these instructions to download and install this enhancement on Linux x86_64 management hosts in your cluster.

a.      Log on to the master host as the cluster administrator:

> egosh user logon -u Admin

b.      Source the host environment:

(bash) > . $EGO_TOP/profile.platform

(csh) > source $EGO_TOP/cshrc.platform

c.      Stop the HostFactory service:

> egosh service stop HostFactory

d.      Back up your symAreq_config.json configuration file, for example:

> mkdir -p /tmp/backup_523655

> cp $EGO_CONFDIR/../../eservice/hostfactory/conf/requestors/symA/conf/symAreq_config.json /tmp/backup_523655/

e.      On each management host, create a directory (for example, /symfixes) and download the egocore-3.7.0_x86_64_build523655.tar.gz package to the directory.

f.       Use the egoinstallfixes command to install the egocore-3.7.0_x86_64_build523655.tar.gz package:

> egoinstallfixes /symfixes/egocore-3.7.0_x86_64_build523655.tar.gz --silent

NOTE: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory for recovery purposes. Do not delete this backup directory; you will need it if you want to recover the original files.

g.      Launch your web browser, clear the browser cache, and log in to the cluster management console as usual.

h.      Use the pversions command to verify the installation:

> pversions -b 523655

i.        Start the HostFactory service:

> egosh service start HostFactory

j.        Log on to the cluster management console as the cluster administrator and ensure that no provisioning requests or provisioning tasks are in progress for the symA requestor:

·        Go to Resources > Cloud > Hosts and make sure that no hosts in the Provisioned status show for the symA requestor.

·        Go to Resources > Cloud > Requests and make sure that no requests in the Created or Running status show for the symA requestor.

k.      Edit the symAreq_config.json file at $EGO_CONFDIR/../../eservice/hostfactory/conf/requestors/symA/conf/ and update the ncores and nram parameters to use fractional values:

·        ncores: Number of cores per slot. Valid value is a float, up to two decimal places that cannot be lower than 0.01. Default is 1.

·        nram: RAM per slot, in MB. Valid value is a float, up to two decimal places that cannot be lower than 0.01. Default is 256.

To arrive at your slot_mapping configuration, divide the instance type’s CPU and memory by the number of tasks you want to run on the instance. For example, to provision instance type r5d.12xlarge, with 48 vCPUs (i.e., 24 CPUs with hyperthreading enabled) and 384 GB, the symAreq_config.json configuration must be as follows:

If you run 10 tasks on the instance, divide 24CPUs by 10 and 384GB by 10 (384*1024/10):

{

    "scaling_policy": "throughput",

    "slot_mapping":

        {

            "ncores": 2.4,

            "nram": 39321.6

        },

       

}

            If you run 40 tasks on the instance, divide 24CPUs by 40 and 384GB by 40 (384*1024/40):

             {

    "scaling_policy": "throughput",

    "slot_mapping":

        {

            "ncores": 0.6,

            "nram": 9830.4

        },

       

}

 

While ncores and nram are required parameters, setting fractional values for them is optional. If you don’t specify a value or the value specified is not valid, the default configuration is used.

5.    Uninstallation

If required, follow these instructions to uninstall this enhancement on Linux management hosts in your cluster.

a.      Log on to the cluster management console as the cluster administrator and ensure that no provisioning requests or provisioning tasks are in progress for the symA requestor:

·        Go to Resources > Cloud > Hosts and make sure that no hosts in the Provisioned status show for the symA requestor.

·        Go to Resources > Cloud > Requests and make sure that no requests in the Created or Running status show for the symA requestor.

b.      Log on to the master host as the cluster administrator:

> egosh user logon -u Admin -x Admin

c.      Source the host environment:

(bash) > . $EGO_TOP/profile.platform

(csh) > source $EGO_TOP/cshrc.platform

d.      Stop the HostFactory service:

> egosh service stop HostFactory

e.      Log on to each management host and roll back this enhancement:

> egoinstallfixes -r 523655

f.       Restore your original symAreq_config.json configuration file (which used integers, instead of fractions for the ncores and nram parameters). For example:

> cp /tmp/backup_523655/symAreq_config.json $EGO_CONFDIR/../../eservice/hostfactory/conf/requestors/symA/symAreq_config.json

g.      Launch your web browser and clear the browser cache.

h.      From the master host, start the HostFactory service:

> egosh service start HostFactory

6.    List of files

$EGO_TOP/3.7/hostfactory/requestors/symA/scripts/Main.py

7.    Product notifications

To receive information about product solution and patch updates automatically, subscribe to product notifications on the My Notifications page http://www.ibm.com/support/mynotifications/ on the IBM Support website (http://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 2019

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.