Readme File for IBM^® Platform Symphony 7.1.1 Interim Fix 553364

Readme File for: IBM Platform Symphony

Product Release: 7.1.1

Update Name: Interim Fix 553364

Fix ID: sym-7.1.1-build553364

Publication Data: July 27, 2020

Interim fix to resolve when the client hangs using the SoamConnection.openSession method for Java API in IBM Platform Symphony 7.1.1.

Contents

1. List of fixes

2. Download location

3. Product and components affected

4. Installation and configuration

5. Uninstallation

6. List of files

7. Product notifications

8. Copyright and trademark information

1.     List of fixes

APARs: P103760

2.    Download location

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

3.    Product and components affected

Component name, Platform, Fix ID:

SOAM, Windows x86_64, sym-7.1.1-build553364

4.    Installation and configuration

Follow these steps to download and install this interim fix on IBM Platform Symphony client or IBM Platform Symphony Developer Edition hosts on Windows.

System requirements

Windows x86_64

Installing on IBM Platform Symphony client hosts

a.   Log on to each client host and ensure that no client processes are running.

b.     Copy the symclnt2015_win-x64_build553364.msp package and complete one of the following steps:

o   For an interactive installation, double-click the symclnt2015_win-x64_build553364.msp package first and follow the prompts.

o   For a silent installation, enter the following commands from the command prompt in the order specified:

C:\>msiexec /update C:\symclnt2015_win-x64_build553364.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 of the MSP package.

o    sym_install_log is the log file for the upgrade.

Installing on IBM Platform Symphony Developer Edition hosts

a.      Log on to each IBM Platform Symphony Developer Edition host and ensure that no client processes are running.

b.      Copy the symde2015_win-x64_build553364.msp package and complete one of the following steps:

o   For an interactive installation, double-click the symde2015_win-x64_build553364.msp package first and follow the prompts.

o   For a silent installation, enter the following commands from the command prompt in the order specified:

C:\>msiexec /update C:\symde2015_win-x64_build553364.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 of the MSP package.

o    sym_install_log is the log file for the upgrade.

When you submit workload, you can set the API_CALL_TIMEOUT environment variable on the client side:

     Syntax: API_CALL_TIMEOUT=value

Description: Defines the number of seconds the IBM Platform Symphony API waits to complete the API call to the session director or session manager before it times out. For a client to submit workload, the client must connect to an application and then call the IBM Platform Symphony API to interact with a session created on this connection. The timeout value can be any unsigned integer and -1, which is treated specially to specify that the API never times out. 

5.    Uninstallation

If required, follow these steps to uninstall this interim fix from your IBM Platform Symphony client or IBM Platform Symphony Developer Edition hosts on Windows.

Uninstalling from IBM Platform Symphony client hosts

a.      Log on to each client host and ensure that no client processes are running.

b.      Roll back this interim fix:

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.1.0 (build “553364”) and click Uninstall.

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

> msiexec /uninstall {644E525F-EEFE-4096-9425-B60EF22B91EC} /package {E8050693-F430-4F1C-825B-41A275B0B223} /norestart /quiet /l*v sym_rollback.log

The command syntax is as follows:

> 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, {644E525F-EEFE-4096-9425-B60EF22B91EC}.

o   product_code is the identifier of the .msi file in the product installation package; in this case, {E8050693-F430-4F1C-825B-41A275B0B223}.

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

Uninstalling from IBM Platform Symphony Developer Edition hosts

a.     Log on to each IBM Platform Symphony Developer Edition host and ensure that no client processes are running..

b.     Roll back this interim fix:

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.1.0 (build “553364”) and click Uninstall.

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

> msiexec /uninstall {70400260-7D7F-4EB5-8480-0A5CDEF300F3} /package {691EC0D3-443D-4B63-9F62-F5CED80DC34B} /norestart /quiet /l*v sym_rollback.log

The command syntax is as follows:

> 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, {70400260-7D7F-4EB5-8480-0A5CDEF300F3}.

o   product_code is the identifier of the .msi file in the product installation package; in this case, {691EC0D3-443D-4B63-9F62-F5CED80DC34B}.

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

6.    List of files

symclnt2015_win-x64_build553364.msp:

 lib64\soambase.dll

 lib64\soambase.pdb

 lib64\soambase.lib

 lib\soambase.dll

 lib\soambase.pdb

 lib\soambase.lib

symde2015_win-x64_build553364.msp:

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

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

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

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

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

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

7.    Product notifications

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. 

8.  Copyright and trademark information

© Copyright IBM Corporation 2020

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.