Readme File
for IBM® Spectrum Symphony RFE 145296
Readme file for: IBM
Spectrum Symphony
Product release: 7.3
Fix ID:
symmc-7.3-build600073-ms
Publication date: January 12, 2021
Enhancement to the IBM Spectrum Symphony Multicluster feature so that IBM Spectrum Symphony and the
IBM Spectrum Symphony Multicluster client remember the original creation time
of a session, and use it as the time for sorting all subsequent new sessions in
a new cluster. This allows the session to execute before other new sessions
with the same session priority.
|
Operating system |
RHEL 6.4 to 8, 64-bit Windows 2012 to 2019, 64-bit |
|
Product version |
IBM Spectrum Symphony
Multicluster 7.3 IBM Spectrum Symphony
7.2.0.2 IBM Spectrum Symphony
Developer Edition 7.2.0.2 IBM Spectrum Symphony client 7.2.0.2 |
Fix sym-7.2.0.2-build552182-ms must be installed
on the IBM Spectrum Symphony 7.2.0.2 cluster.
Fix sym-7.3-build565921-ms must be
installed on the IBM Spectrum Symphony Multicluster 7.3 cluster.
a.
Source the host environment:
(BASH) >.
$EGO_TOP/profile.platform
(CSH) >source
$EGO_TOP/cshrc.platform
b.
Log on to the Multicluster primary host as the
cluster administrator:
>
egosh user logon -u Admin -x Admin
c.
Shut down the SMCM service:
>
egosh service stop SMCM
d.
Back up the following files:
$EGO_TOP/smc/7.3/schema/SmcPlacementPolicy.xsd
$EGO_TOP/smc/7.3/linux-x86_64/etc/smcmaster
e.
Download the symmc-7.3.0.0_x86_64_build600073.tar.gz package and
install the fix:
>
tar zxof symmc-7.3.0.0_x86_64_build600073.tar.gz -C $EGO_TOP
f.
Start the SMCM service:
>
egosh service start SMCM
a.
Source the host environment:
(BASH) >.
$EGO_TOP/profile.platform
(CSH) >source $EGO_TOP/cshrc.platform
b.
Log on to the cluster’s primary host as the
cluster administrator:
>
egosh user logon -u Admin -x Admin
c.
Disable all applications:
>
soamcontrol app disable all
d.
Back up the following file:
$EGO_TOP/soam/7.2/linux-x86_64/etc/ssm
$EGO_TOP/soam/7.2/linux-x86_64/lib64/libsoambase.so
$EGO_TOP/soam/7.2/linux-x86_64/lib/libsoambase.so
e.
Download the sym-7.2.0.2_x86_64_build600077.tar.gz
package and install the fix:
> tar zxof sym-7.2.0.2_x86_64_build600077.tar.gz
-C $EGO_TOP
f.
Enable your application:
> soamcontrol app enable
app_name
a. Disable all
workload in the cluster:
>
egosh user logon -u Admin -x Admin
>
soamcontrol app disable all
b.
Log on to each host in your cluster as the
cluster administrator. Ensure that no client processes are running, and backup
the following files for recovery purposes:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
c.
Download the sym-7.2.0.2_build600077.zip package
and extract its contents to the top-level installation directory.
d.
Check the modified time of the following
files to verify that the fix was installed correctly:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
e.
Enable the application in the cluster
> soamcontrol app enable app_name
a.
Log on to the IBM Spectrum Symphony Developer
Edition host and back up following files:
$SOAM_HOME/7.2/linux-x86_64/lib64/libsoambase.so
$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so
b.
Download the symde-7.2.0.2_x86_64_build600077.tar.gz
package and install the fix:
>
tar zxof symde-7.2.0.2_x86_64_build600077.tar.gz -C $SOAM_HOME
Install
this interim fix on all IBM Spectrum Symphony Developer Edition Windows hosts
in the cluster:
a.
Log on to each host in your cluster as the
cluster administrator. Ensure that no client processes are running, and backup
the following files for recovery purposes:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
b.
Download the symde-7.2.0.2_build600077.zip package and
extract its contents to the top-level installation directory.
c.
Check the modified time of the following
files to verify that the fix was installed correctly:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
a.
Log on to the IBM Spectrum Symphony client host
and back up following file:
$SOAM_HOME/lib64/libsoambase.so
$SOAM_HOME/lib/libsoambase.so
b.
Download the symclnt-7.2.0.2_x86_64_build600077.tar.gz package
and install the fix:
> tar zxof symclnt-7.2.0.2_x86_64_build600077.tar.gz
-C $SOAM_HOME
Install this interim fix on all IBM
Spectrum Symphony client Windows hosts in the cluster:
a.
Log on to each client host in your cluster as
the cluster administrator. Ensure that no client processes are running, and
backup the following files for recovery purposes:
%SOAM_HOME%\lib\soambase.dll
%SOAM_HOME%\lib\soambase.lib
%SOAM_HOME%\lib\soambase.pdb
%SOAM_HOME%\lib64\soambase.dll
%SOAM_HOME%\lib64\soambase.lib
%SOAM_HOME%\lib64\soambase.pdb
b.
Download the symclnt-7.2.0.2_build600077.zip package and
extract its contents to the top-level installation directory.
c.
Check the modified time of the following files
to verify that the fix was installed correctly:
%SOAM_HOME%\lib\soambase.dll
%SOAM_HOME%\lib\soambase.lib
%SOAM_HOME%\lib\soambase.pdb
%SOAM_HOME%\lib64\soambase.dll
%SOAM_HOME%\lib64\soambase.lib
%SOAM_HOME%\lib64\soambase.pdb
After applying this enhancement, configure your Multicluster workload
placement policy on the IBM Spectrum Symphony Multicluster primary
cluster to enable this feature.
a.
Source the environment:
(BASH) >.
$EGO_TOP/profile.platform
(CSH) > source
$EGO_TOP/cshrc.platform
b.
Log on to the Multicluster primary host as the
cluster administrator:
> egosh user logon -u Admin -x Admin
c.
Show the workload placement policy XML that you
want to update for this enhancement (in this example, the policy XML is called test.xml):
> smcadmin policy get -i policyID >test.xml
d. Edit the workload
placement policy XML file and add the useInitialSessionCreationTime="enabled"
setting to the Application section. For example:
<Application workloadRedirection="session"
workloadRedirectionFailover="enabled"
topNClusterForTaskRedirection="3"
topNClusterShareValues="5,3,2"
resubmitOnZeroResourcesTimeoutMinutes="3"
rerankIntervalMinutes="0"
useClusterMigrationRanks="disabled"
migrateToHigherRankClusterIntervalMinutes="0"
useInitialSessionCreationTime="enabled"/>
e.
Update the workload placement policy using the test.xml file:
> smcadmin policy
update -i policyID -r test.xml
f.
Assign applications to the policy using the
policy ID from the previous step if necessary:
> smcadmin app
addplacement –a appName –i policyID
Tip: Alternatively, you can enable
this feature by setting the SMC_USE_INITIAL_SESSION_CREATION_TIME client-side environment,
before submitting workload. For example:
> export SMC_USE_INITIAL_SESSION_CREATION_TIME=enabled
When the session failover happens for resource starvation, the session
will fail over from the original cluster to a new cluster, but the session
creation time is the original session creation time. This allows the session to
execute first, compared with other sessions with the same priority.
If required, follow
these instructions to uninstall this enhancement from hosts in your cluster.
a. Log
on to the Multicluster primary host as the cluster administrator and shut down
the SMCM service:
>
egosh user logon -u Admin -x Admin
>
egosh service stop SMCM
b.
Restore following files on the host:
$EGO_TOP/smc/7.3/schema/SmcPlacementPolicy.xsd
$EGO_TOP/smc/7.3/linux-x86_64/etc/smcmaster
c.
Disable this feature by removing
the useInitialSessionCreationTime parameter
from the workload placement policy configuration files, and
update placement policy with smcadmin command.
d. Start the SMCM
service:
> egosh service start SMCM
a. Log on to
each host as the cluster administrator:
>
egosh user logon -u Admin -x Admin
b.
Disable all applications:
>
soamcontrol app disable all
c.
Restore following files on all management
hosts:
$EGO_TOP/soam/7.2/linux-x86_64/etc/ssm
$EGO_TOP/soam/7.2/linux-x86_64/lib64/libsoambase.so
$EGO_TOP/soam/7.2/linux-x86_64/lib/libsoambase.so
d.
Enable all applications:
> soamcontrol app enable app_name
Log on to each host as the cluster administrator
and restore the following files from your backup:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
Log on to IBM Spectrum Symphony Developer
Edition Linux host and restore following files from your backup:
$SOAM_HOME/7.2/linux-x86_64/lib64/libsoambase.so
$SOAM_HOME/7.2/linux-x86_64/lib/libsoambase.so
Log on to IBM Spectrum Symphony
Developer Edition Windows host and restore following files from your backup:
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib\soambase.pdb
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.dll
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.lib
%SOAM_HOME%\7.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb
Log on to IBM
Spectrum Symphony client Linux host and restore the following files from your
backup:
$SOAM_HOME/lib64/libsoambase.so
$SOAM_HOME/lib/libsoambase.so
%SOAM_HOME%\lib\soambase.dll
%SOAM_HOME%\lib\soambase.lib
%SOAM_HOME%\lib\soambase.pdb
%SOAM_HOME%\lib64\soambase.dll
%SOAM_HOME%\lib64\soambase.lib
%SOAM_HOME%\lib64\soambase.pdb
symmc-7.3.0.0_x86_64_build600073.tar.gz
3fa33cda12113331b23c25c337258f7c
smc/7.3/linux-x86_64/etc/smcmaster
9e2f9c0416c204e1b16c94086a11d148
smc/7.3/schema/SmcPlacementPolicy.xsd
ed57e20913d11a4602d2b1cecf76e0bf
sym-7.2.0.2_x86_64_build600077.tar.gz
e4689656e2022d8fd192ae54bb46b8f6
soam/7.2/linux-x86_64/etc/ssm
23fd6ea6e4ff6062b27354e8b27043f9
soam/7.2/linux-x86_64/lib64/libsoambase.so
ed28ff27dee7580220d3fc9cdfc1aef4
soam/7.2/linux-x86_64/lib/libsoambase.so
cbbdafd6bc64058da2c35a67845958f4
sym-7.2.0.2_build600077.zip
695fe6e6dce6f3cc7e436159e16802e2
soam/7.2/w2k3_x64-vc7-psdk/lib/soambase.dll
45c97b7d4fc8bc95b800a35c1e84299c
soam/7.2/w2k3_x64-vc7-psdk/lib/soambase.lib
e3dd926c6113bc0c48ef6a167b9cf816
soam/7.2/w2k3_x64-vc7-psdk/lib/soambase.pdb
cb9941b5128372b8a41f0a499c3c73b8
soam/7.2/w2k3_x64-vc7-psdk/lib64/soambase.dll
66c31ec526f3e463160447e805368319
soam/7.2/w2k3_x64-vc7-psdk/lib64/soambase.lib
e9f19fc6b99243a6dd574970b33454f2
soam/7.2/w2k3_x64-vc7-psdk/lib64/soambase.pdb
cb11c21a07d8ac6ae4f2a72ea301daa8
symclnt-7.2.0.2_x86_64_build600077.tar.gz
68ea1028191c2cc55694a943f5e06fa1
lib/libsoambase.so
cbbdafd6bc64058da2c35a67845958f4
lib64/libsoambase.so
ed28ff27dee7580220d3fc9cdfc1aef4
symclnt-7.2.0.2_build600077.zip
5b57233c49d3c0afc493fce3c479ed50
lib/soambase.dll
45c97b7d4fc8bc95b800a35c1e84299c
lib/soambase.lib
e3dd926c6113bc0c48ef6a167b9cf816
lib/soambase.pdb
cb9941b5128372b8a41f0a499c3c73b8
lib64/soambase.dll
66c31ec526f3e463160447e805368319
lib64/soambase.lib
e9f19fc6b99243a6dd574970b33454f2
lib64/soambase.pdb
cb11c21a07d8ac6ae4f2a72ea301daa8
symde-7.2.0.2_x86_64_build600077.tar.gz
79871df1831cc1559403d3f535127ff4
7.2/linux-x86_64/lib/libsoambase.so
cbbdafd6bc64058da2c35a67845958f4
7.2/linux-x86_64/lib64/libsoambase.so
ed28ff27dee7580220d3fc9cdfc1aef4
symde-7.2.0.2_build600077.zip
de3ef9b749dd7b9566e930c018da3387
7.2/w2k3_x64-vc7-psdk/lib/soambase.dll
45c97b7d4fc8bc95b800a35c1e84299c
7.2/w2k3_x64-vc7-psdk/lib/soambase.lib
e3dd926c6113bc0c48ef6a167b9cf816
7.2/w2k3_x64-vc7-psdk/lib/soambase.pdb
cb9941b5128372b8a41f0a499c3c73b8
7.2/w2k3_x64-vc7-psdk/lib64/soambase.dll
66c31ec526f3e463160447e805368319
7.2/w2k3_x64-vc7-psdk/lib64/soambase.lib
e9f19fc6b99243a6dd574970b33454f2
7.2/w2k3_x64-vc7-psdk/lib64/soambase.pdb
cb11c21a07d8ac6ae4f2a72ea301daa8
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 2021
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.