Readme File
for IBM® Platform Symphony 7.1 Interim Fix 464444
Readme File for: IBM
Platform Symphony
Product Release: 7.1
Fix Pack 1
Update Name: Interim
Fix 464444
Fix ID: sym-7.1-build464444-unic
Publication Date: August
18, 2017
Windows hosts,
in a large cluster, might become unavailable when the following error is
reported in the LIM log: “Failed in sending/receiving a message: Message too
long”. This interim fix
provides a resolution for this issue.
With this fix,
the default network send/receive buffer size is increased from 16,384 bytes to
81,920 bytes. If this value is not enough for your cluster, update this value
by configuring the EGO_MASTER_ANN_BUF_SIZE parameter in the ego.conf file on each host. Enlarging this
value impacts only the processes that send and receive network packages,
allowing these processes to create more memory space for sending and receiving
network packages. It does not impact the transferred package size on the
network.
NOTE: This
interim applies to all hosts in your Platform Symphony 7.1 Fix Pack 1 cluster.
Ensure that you apply it to every host in the cluster.
Contents
1. List of fixes
2. Download location
3. Product and components affected
4. Installation and configuration
5. Uninstallation
6. List of files
7. Copyright and trademark information
1.
List of fixes
APAR: P102327
2.
Download location
Download interim fix 464444 from the following location: https://www.ibm.com/eserver/support/fixes/
3.
Product and components affected
Component name, Platform, Fix ID:
EGO, Windows x86_64 and Linux x86_64, sym-7.1-build464444-unic
4.
Installation and configuration
Follow these steps to install this
interim fix on all hosts in a Platform Symphony 7.1 Fix Pack 1 cluster:
System
requirements
o
Windows
x86_64
o
Linux
x86_64
Installation
1. Log on to the master host as the
cluster administrator:
> egosh user logon -u Admin -x
Admin
2. Disable your applications, stop services, and shut down the cluster:
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown all
3. Based on your host operating system, complete the
following steps:
Windows hosts
a. Log on to each Windows host in the cluster, copy the
ego3.1_win-x64_build464444.msp package, and complete one of the following steps:
o
To perform an interactive
installation, double-click the .msp package.
o
To perform a silent installation
from the Platform Symphony command line, complete these steps:
C:\>msiexec
/update C:\ego3.1_win-x64_build464444.msp /l*v updateSym.log /norestart /quiet
REINSTALLMODE=omus
The
command syntax is as follows:
C:\>msiexec
/update <sym_package_name_path>
/l*v <sym_install_log>
/norestart /quiet REINSTALLMODE=omus
where:
o
<sym_package_name_path> is the fully qualified file name to
the .msp package.
o
<sym_install_log> is the log file for the upgrade.
b. Run the “pversions” command to verify the installation. For example:
> pversions
Platform EGO 3.1.0
Update for Symphony 7.1.0
(build"464444")
IBM Platform Symphony 7.1.0
Copyright IBM Corp. 1992, 2014.
All rights reserved.
US Government Users Restricted
Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Linux hosts
a. Log on to each Linux host in the cluster and back up
the following file, which will be replaced by this interim fix:
$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/lim
b. Copy the sym7.1_lnx26-lib23-x64_build464444.tar.gz package and install this interim fix:
> tar zxfo sym7.1_lnx26-lib23-x64_build464444.tar.gz
-C $EGO_TOP
c. Run the “lim
-V” command to verify the
installation. For example:
> lim -V
Platform EGO 3.1.0.0 build
464444, Aug 8 2017
Copyright International Business
Machines Corp, 1992-2014.
US Government Users Restricted
Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
binary type:
linux2.6-glibc2.3-x86_64
notes:
fixes:
4. Start the cluster and enable your applications:
> egosh ego start all
> soamcontrol app enable <appName>
5.
Uninstallation
If required, follow these steps to uninstall
this interim fix in a Platform Symphony 7.1 Fix Pack 1 cluster:
1. Log on to the master host as the
cluster administrator:
> egosh user logon -u Admin -x Admin
2. Disable your applications, stop services, and shut down the cluster:
> soamcontrol app disable all
> egosh service stop all
> egosh ego shutdown all
3. Based on your host operating system, complete the
following step:
Windows hosts
Log
on to each Windows host in the cluster, roll back to the previous version of
Platform Symphony either from the Windows Control Panel or from the Platform
Symphony command line:
o To
roll back from the Windows Control Panel, go to Control Panel > Programs
and Features > View installed updates, click Update for Symphony 7.1.0 (build
“464444”) and click Uninstall.
o To
roll back from the Platform Symphony command line, enter the following command:
C:\>msiexec
/uninstall {0F6D363F-6675-4BD9-8BD8-657F2782D3BF} /package
{C45B1816-5299-4893-A88D-C11621C02B9D} /norestart /quiet /l*v sym_rollback.log
The
command syntax is as follows:
C:\>msiexec
/uninstall <interim_fix_code>
/package <product_code>
/norestart /quiet /l*v <rollback_log>
where:
o
<interim_fix_code> is the identifier of the
.msp package for the interim fix; in this case, {0F6D363F-6675-4BD9-8BD8-657F2782D3BF}.
o
<product_code> is the identifier of the .msi file
in the product installation package; in this case, {C45B1816-5299-4893-A88D-C11621C02B9D}.
o
<rollback_log> is the name of the log file to capture
details of the interim fix rollback; in this case, sym_rollback.log.
Linux hosts
Log
on to each Linux host in the cluster and restore the following file from your
backup:
$EGO_TOP/3.1/linux2.6-glibc2.3-x86_64/etc/lim
4. Start the cluster and enable your applications:
> egosh ego start all
> soamcontrol app enable <appName>
6.
List
of files
lim
lim.exe
lim32.pdb
7.
Copyright
and trademark information
© Copyright IBM Corporation 2017
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.