IBM Platform Symphony 5

IBM Platform Symphony 7.1 Interim Fix 377118 Readme File

Abstract

The Platform Symphony client may create multiple connections to the same SSM.

Description

The Platform Symphony client may create multiple connections to the same SSM, even if the client called the API to close the connection. This may cause SSM to exceed the file descriptors (FD) limit and refuse to accept new connections from the Platform Symphony client. After applying this fix, there will be only one connection between the Platform Symphony client and SSM.

This interim fix applies only to the following platforms:

Linux 64-bit

Windows 64-bit

Readme file for: IBM® Platform Symphony

Product/Component Release: 7.1 Fix Pack 1

Update Name: Interim Fix 377118

Fix ID: sym-7.1-build377118

Publication date: 7 December 2015

Last modified date: 4 December 2015

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. Copyright and trademark information

1. List of fixes

APAR#P101510

2. Download location

http://www.ibm.com/eserver/support/fixes/

3. Products or components affected

Product/Component Name, Platform, Fix ID:

Platform Symphony/soambase, Windows 64-bit/Linux 64-bit, sym-7.1-build377118

4. System requirements

You must have Platform Symphony 7.1 Fix Pack 1 installed before applying this fix.

5. Installation and configuration

5.1 Before installation

1. Disable all applications.

Log on to the master host as the cluster administrator and run:

C:\>soamcontrol app disable all

2. Back up files that will be replaced by this fix on Linux hosts.

For Linux 64-bit management and compute hosts:

soam/7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

For Linux 64-bit Platform Symphony Developer Edition hosts:

7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

For Linux 64-bit client hosts:

lib/libsoambase.so

lib64/libsoambase.so

5.2 Installation steps

· On Linux:

For Linux 64-bit management and compute hosts:

> tar zxfo sym7.1-build377118_lnx26-lib23-x64.tar.gz -C $EGO_TOP

For Linux 64-bit Platform Symphony Developer Edition hosts:

> tar zxfo symde7.1-build377118_lnx26-lib23-x64.tar.gz -C $SOAM_HOME

For Linux 64-bit client hosts:

> tar zxfo symclnt7.1-build377118_lnx26-lib23-x64.tar.gz -C $SOAM_HOME

· On Windows:

Install the appropriate .msp package.

If you are installing a Platform Symphony management or compute host, download and install soam7.1_win-x64-377118.msp.

If you are installing a Platform Symphony Developer Edition host, download and install symde7.1_win-x64-377118.msp.

If you are installing a Platform Symphony client host, download and install symclnt7.1_win-x64-377118.msp.

Interactive installation:

Double-click the Platform Symphony MSP package to run the Platform Symphony installer.

Silent installation:

Run the Platform Symphony installer from the command line using the following command:

C:\>msiexec /update <Symphony_package_name_path> /l*v <symphony_install_log> /norestart /quiet REINSTALLMODE=omus

Where:

1) Symphony_package_name_path is the fully qualified file name of the Platform Symphony MSP package in this release.

2) symphony_install_log is the log file for the Platform Symphony upgrade.

For example, to install this fix on a Windows management or compute host, run:

C:\>msiexec /update C:\soam7.1_win-x64-377118.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus

To install this fix on a Platform Symphony Developer Edition host, run:

C:\>msiexec /update C:\symde7.1_win-x64-377118.msp /l*v updateDE.log /norestart /quiet REINSTALLMODE=omus

To install this fix on a Platform Symphony client host, run:

C:\>msiexec /update C:\symclnt7.1_win-x64-377118.msp /l*v updateSymclnt.log /norestart /quiet REINSTALLMODE=omus

5.3 After installation

1. Verify the installation using the pversions command on Windows.

The following output is an example of successfully running the verification command on management and compute host:

C:\>pversions

Platform EGO 3.1.0

IBM Platform Symphony 7.1.0

Update for Symphony 7.1.0 (build"377118")

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

2. Enable the application.

Log on to the master host as the cluster administrator and run:

> soamcontrol app enable <appName>

5.4 Uninstallation

1. Disable all applications.

Log on to the master host as the cluster administrator and run:

> soamcontrol app disable all

2. Restore the backup files.

· On Linux:

Restore the backed-up files on all hosts. For a detailed list of files, refer to the backup file list in the "Before installation" section.

· On Windows:

Important:

You cannot use the Microsoft Windows "Add/Remove Programs" feature to roll back to a previous Platform Symphony package on a management/compute host.

a.) Get the Platform Symphony package for Platform Symphony 7.1 Fix Pack 1 (for example, soam7.1_win-x64.msi in this case).

b.) Use the following command to roll back Platform Symphony:

C:\>msiexec /uninstall <Sym_SP_path> /package <Sym_7.1_path> /norestart /quiet /l*v <sym_rollback_log>

Where:

1) Sym_SP_path is the fully qualified filename of the Platform Symphony MSP package in this release.

2) Sym_7.1_path is the fully qualified filename of the Platform Symphony 7.1 fix pack 1 MSI package.

3) sym_rollback_log is the log file for the Platform Symphony rollback.

For example, to roll back Platform Symphony on a Windows management or compute host, run:

C:\>msiexec /uninstall C:\soam7.1_win-x64-377118.msp /package C:\soam7.1_win-x64.msi /norestart /quiet /l*v rollbackSym.log

To roll back a Platform Symphony Developer Edition on a Windows host, run:

C:\>msiexec /uninstall C:\symde7.1_win-x64-377118.msp /package C:\symde7.1_win-x64.msi /norestart /quiet /l*v rollbackDE.log

To roll back Platform Symphony client on a Windows host, run:

C:\>msiexec /uninstall C:\symclnt7.1_win-x64-377118.msp /package C:\symclnt7.1_win-x64.msi /norestart /quiet /l*v rollbackClnt.log

3. Enable applications.

Log on to the master host as the cluster administrator and run:

C:\>soamcontrol app enable <appName>

6. List of files

sym7.1-377118_lnx26-lib23-x64.tar.gz:

soam/7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

soam/7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

symclnt_377118_lnx26-lib23-x64.tar.gz:

lib64/libsoambase.so

lib/libsoambase.so

symde7.1_377118_lnx26-lib23-x64.tar.gz:

7.1/linux2.6-glibc2.3-x86_64/lib64/libsoambase.so

7.1/linux2.6-glibc2.3-x86_64/lib/libsoambase.so

soam7.1_win-x64-377118.msp:

soam\7.1\w2k3_x64-vc7-psdk\lib64\soambase.dll

soam\7.1\w2k3_x64-vc7-psdk\lib64\soambase.lib

soam\7.1\w2k3_x64-vc7-psdk\lib64\soambase.pdb

soam\7.1\w2k3_x64-vc7-psdk\lib\soambase.dll

soam\7.1\w2k3_x64-vc7-psdk\lib\soambase.lib

soam\7.1\w2k3_x64-vc7-psdk\lib\soambase.pdb

symclnt7.1_win-x64-377118.msp:

lib64\soambase.dll

lib64\soambase.lib

lib64\soambase.pdb

lib\soambase.dll

lib\soambase.lib

lib\soambase.pdb

symde7.1_win-x64-377118.msp:

7.1\w2k3_x64-vc7-psdk\lib64\soambase.dll

7.1\w2k3_x64-vc7-psdk\lib64\soambase.lib

7.1\w2k3_x64-vc7-psdk\lib64\soambase.pdb

7.1\w2k3_x64-vc7-psdk\lib\soambase.dll

7.1\w2k3_x64-vc7-psdk\lib\soambase.lib

7.1\w2k3_x64-vc7-psdk\lib\soambase.pdb

7. Copyright and trademark information

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.