Readme File for IBM® Platform Symphony 7.1 Interim Fix 487169

Readme File for: IBM Platform Symphony

Product Release: 7.1 Fix Pack 1

Update Name: Interim Fix 487169

Fix ID: sym-7.1-build487169

Publication Date: August 6, 2018

The Client JVM could cause a core dump after running the client sample in a Platform Symphony 7.1 Fix Pack 1 cluster. This fix provides a resolution for this issue.

Contents

1. List of fixes

2. Download location

3. Product and components affected

4. Installation and configuration

5. List of files

6. Copyright and trademark information

1.     List of fixes

APAR: P102472

2.     Download location

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

3.     Product and components affected

Component name, Platform, Fix ID:

SOAM, Linux x86_64/Windows x86_64, sym-7.1-build487169

4.     Installation and configuration

System requirements

Linux x86_64

Windows x86_64

Linux installation

Log on to the master host as the cluster administrator, disable all applications:

> soamcontrol app disable all

Log on to each management host in the cluster and back up the following files, which will be replaced by this interim fix:

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

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

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

Log on to each Client host in the cluster and back up the following files, which will be replaced by this interim fix:

$SOAM_HOME/lib64/libjnativesoamapi_7.1.0_64.so

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/JavaSoamApi.jar

On each management host, download and decompress the sym7.1_lnx26-lib23-x64_build487169.tar.gz package:

> tar zxfo sym7.1_lnx26-lib23-x64_build487169.tar.gz -C $EGO_TOP

On each Client host, download and decompress the symclnt7.1_lnx26-lib23-x64_build487169.tar.gz package:

> tar zxfo symclnt7.1_lnx26-lib23-x64_build487169.tar.gz -C $SOAM_HOME

After installation

Log on to the master host as the cluster administrator, enable your applications:

> soamcontrol app enable <appName>

Linux uninstallation (if required)

Log on to the master host as the cluster administrator, disable all applications:

> soamcontrol app disable all

Log on to each management host in the cluster and restore the following files from your backup:

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

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

$SOAM_HOME/7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

Log on to each client host in the cluster and restore the following files from your backup:

$SOAM_HOME/lib64/libjnativesoamapi_7.1.0_64.so

$SOAM_HOME/lib64/libsoambase.so

$SOAM_HOME/lib/JavaSoamApi.jar

Log on to the master host as the cluster administrator, and enable your applications:

> soamcontrol app enable <appName>

Windows installation

Log on to the master host as the cluster administrator, disable all applications:

> soamcontrol app disable all

Log on to each management host in the cluster and copy the sym7.1-soam7.1_win-x64_build487169.msp package, and complete one of the following steps:

·        For an interactive installation, double-click the MSP package and follow the prompts.

·        For a silent installation, enter the following command from the command prompt:

C:\>msiexec /update C:\sym7.1-soam7.1_win-x64_build487169.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:

<sym_package_name_path> is the fully qualified file name of the MSP package.

<sym_install_log> is the log file for the upgrade.

Log on to each client host in the cluster and copy the symclnt7.1_win-x64_build487169.msp, and complete one of the following steps:

·        For an interactive installation, double-click the MSP package and follow the prompts.

·        For a silent installation, enter the following command from the command prompt:

C:\>msiexec /update C:\symclnt7.1_win-x64_build487169.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:

<sym_package_name_path> is the fully qualified file name of the MSP package.

<sym_install_log> is the log file for the upgrade.

Verify the installation. For example:

> pversions

IBM Platform Symphony Client 7.1.0

Update for Symphony 7.1.0 (build"487169")

Platform EGO 3.1.0

IBM Platform Symphony 7.1.0

Update for Symphony 7.1.0 (build"487169")

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.

After installation

Log on to the master host as the cluster administrator, enable your applications:

> soamcontrol app enable <appName>

Windows uninstallation (if required)

Log on to the master host as the cluster administrator, disable all applications:

> soamcontrol app disable all

Roll back this interim fix installation on each management host:

·        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"487169") and click Uninstall.

·        To roll back from the IBM Spectrum Symphony command line, enter the following command:

       C:\>msiexec /uninstall {442781B3-FBDC-463C-818B-85E09105D112} /package {555A2738-A103-40AD-84A2-7BFAA2697296} /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:

<interim_fix_code> is the identifier of the .msp package for the interim fix; in this case, {442781B3-FBDC-463C-818B-85E09105D112}.

<product_code> is the identifier of the .msi file in the product installation package; in this case, {555A2738-A103-40AD-84A2-7BFAA2697296}.

<rollback_log> is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.

Log on to the master host as the cluster administrator, and enable your applications:

> soamcontrol app enable <appName>

Roll back this interim fix installation on each client host:

·        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"487169") and click Uninstall.

·        To roll back from the IBM Spectrum Symphony command line, enter the following command:

       C:\>msiexec /uninstall {32885327-283A-453C-85AD-427971F27F74} /package {5FDF6EA5-0B86-4717-9139-8A6740C9C9A5} /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:

<interim_fix_code> is the identifier of the .msp package for the interim fix; in this case, {32885327-283A-453C-85AD-427971F27F74}.

<product_code> is the identifier of the .msi file in the product installation package; in this case, {5FDF6EA5-0B86-4717-9139-8A6740C9C9A5}.

<rollback_log> is the name of the log file to capture details of the interim fix rollback; in this case, sym_rollback.log.

5.     List of files

sym7.1_lnx26-lib23-x64_build487169.tar.gz:

7.1/linux2.6-glibc2.3-x86_64/lib64/libjnativesoamapi_7.1.0_64.so

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

7.1/linux2.6-glibc2.3-x86_64/lib/JavaSoamApi.jar

symclnt7.1_lnx26-lib23-x64_build487169.tar.gz:

lib64/libjnativesoamapi_7.1.0_64.so

lib64/libsoambase.so

lib/JavaSoamApi.jar

sym7.1-soam7.1_win-x64_build487169.msp:

soam/7.1/w2k3_x64-vc7-psdk/lib/JavaSoamApi.jar

soam/7.1/w2k3_x64-vc7-psdk/lib64/jnativesoamapi_7.1.0_64.dll

soam/7.1/w2k3_x64-vc7-psdk/lib64/jnativesoamapi_7.1.0_64.pdb

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

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

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

symclnt7.1_win-x64_build487169.msp:

lib/JavaSoamApi.jar

lib64/jnativesoamapi_7.1.0_64.dll

lib64/jnativesoamapi_7.1.0_64.pdb

lib64/soambase.dll

lib64/soambase.pdb

lib64/soambase.lib

6.     Copyright and trademark information

© Copyright IBM Corporation 2018

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.