Readme File for IBM^® Platform Symphony 6.1.0.1 Interim Fix 476578

Readme File for: IBM Platform Symphony

Product Release: 6.1.0.1

Update Name: Interim Fix 476578

Fix ID: sym-6.1.0-build476578

Publication Date: December 1, 2017

If the onSessionEnter callback function cannot return for a long time when the session is aborted, the service instance (SI) and the corresponding SIM hang indeterminably. As a result, the slot occupied by the SI is wasted, affecting slot allocation to other applications. This interim fix resolves this issue so that when the session is aborted, the SI and corresponding SIM exit.

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: P100284

2.     Download Locations

Download interim fix 476578 from https://www.ibm.com/eserver/support/fixes/

3.     Product and Components Affected

Component name, Platform, Fix ID:

SOAM, Windows 64-bit, sym-6.1.0-build476578

4.     Installation and Configuration

System requirements

Windows 64-bit

Prerequisite

IBM Platform Symphony 6.1.0.1 must be installed.

Installation

a.      Log on to the master host as the cluster administrator and disable applications in your cluster:

> soamcontrol app disable all

b.      Log on to each management host in your cluster and copy the sym6.1.0_win-x64_build476578.msp package. Then, 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:

> msiexec /update C:\sym6.1.0_win-x64_build476578.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus

The command syntax is as follows:

> msiexec /update <sym_package_path> /l*v <sym_install_log> /norestart /quiet REINSTALLMODE=omus

where:

o   <sym_package_name_path> is the fully qualified path to the .msp package in this interim fix.

o   <sym_install_log> is the log file for the upgrade.

After Installation

a.      Run the pversions command to verify the installation:

C:\>pversions

Platform EGO 1.2.7.0

IBM Platform Symphony 6.1.0.1

Update for Symphony 6.1.0 (build"476578")

Copyright International Business Machines Corp, 1992-2008, 2013.

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

b.      Edit your application profile and set the SOAM_CANCEL_BIND_SESSION_END environment variable to true. When set to true, the SI and SIM of an aborted session exit; When set to false, the feature is disabled (default).

For example:

<SSM resReq="" workDir="${EGO_SHARED_TOP}/soam/work" startUpTimeout="60" shutDownTimeout="300">

      <osTypes>

            <osType name="NTX64" startCmd="${SOAM_HOME}/6.1/w2k3_x64-vc7-psdk/etc/ssm">

            <env name="SOAM_CANCEL_BIND_SESSION_END">true</env>

            </osType>

      </osTypes>

      ……

</SSM>

c.      Log on to the master host as the cluster administrator and enable applications in your cluster:

> soamcontrol app enable <appName>

5.     Uninstallation

a.      Log on to the master host as the cluster administrator and disable applications in your cluster:

> soamcontrol app disable all

b.     Log on to each management host and roll back to the previous version of Platform Symphony either from the Windows Control Panel or from the Platform Symphony command prompt:

·        To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 6.1.0 (build"476578") and click Uninstall.

·        To roll back from the Platform Symphony command prompt, enter the following command:

C:\>msiexec /uninstall {51DB06E4-818F-4FD8-8CA6-C63A02BB85FE} /package {788F27F9-17F6-424E-9D09-AAF6F4DE01BE} /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, {51DB06E4-818F-4FD8-8CA6-C63A02BB85FE}.

o   <product_code> is the identifier of the .msi file in the product installation package; in this case, {788F27F9-17F6-424E-9D09-AAF6F4DE01BE}.

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

c.      Remove the environment variable in your profile.

d.      Log on to the master host as the cluster administrator and enable applications in the cluster:

> soamcontrol app enable <appName>

6.     List of Files

ssm.exe

ssm.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.