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
3. Product and components affected
4. Installation and configuration
8. Copyright and trademark information
APAR: P103094
Download interim fix 523655 from the following location:
https://www.ibm.com/eserver/support/fixes/
Component name, Platform, Fix ID:
EGO, Linux x86_64,
sym-7.2.1.1-build523655-pimco
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:
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:
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
},
…
}
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
$EGO_TOP/3.7/hostfactory/requestors/symA/scripts/Main.py
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.
© 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.