IBM Platform Symphony 5.0 Fix Patch #230175

Readme File

Abstract

When a Platform Symphony service instance or other event listeners in the callback function onSessionEnter encounter an infinite loop, a user can try to abort the session. This causes the slot occupied by the instance to be wasted.

Description

·         When a session aborts, if the callback function onSessionEnter cannot return, the slot occupied by the SI will be wasted. The SI and corresponding SIM will hang infinitely, preventing other applications from using slots. This wastes the slots.


This fix patch applies only to the following platform:

·        Linux 64-bit

Readme file for: IBM® Platform Symphony

Product/Component Release: 5.0

Update Name: Fix pack

Fix ID: sym-5.0-build230175-ms

Publication date: 4th March, 2014

Last modified date: 4th March, 2014

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

SUP_BY_SYM#228061

2.    Download location

Download Fix #230175 from the following location:

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

3.    Products or components affected

Product/Component Name, Platform, Fix ID:

Platform Symphony/ssm, Linux 64-bit, sym-5.0-build230175-ms

4.    System requirements

Not applicable.

5.    Installation and configuration

5.1                      Before installation

               1. Disable all applications

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

    > source cshrc.platform

    > soamcontrol app disable all

               2. Back up file

            Log on to each management host and back up the following binary that will be replaced by this patch:

    > $SOAM_HOME/5.0/linux2.6-glibc2.3-x86_64/etc/ssm

5.2                      Installation steps

               Log on to each management host and replace the current “ssm” binary with the downloaded one in the following directory:

    > $SOAM_HOME/5.0/linux2.6-glibc2.3-x86_64/etc/ssm

5.3                      After installation

               1. Verify the installation

               For example, run:

    >$SOAM_HOME/5.0/linux2.6-glibc2.3-x86_64/etc/ssm -V

   

The following is an example output:

 

    Platform Symphony 5.0.0.230175, Feb 20 2014

Copyright (C) 2001-2009 Platform Computing Corporation.

 

    2. Configure the parameter SOAM_CANCEL_BIND_SESSION_END in the application profile.
   Set the value of SOAM_CANCEL_BIND_SESSION_END to true to enable the feature.

By default, the feature is disabled.

 

For example:

<SSM ……>

<osTypes>

<osType name="X86_64"

……

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

</osType>

</osTypes>

</SSM>

               3. Enable all applications

    Log on to the master host as the cluster administrator and run:
   > source cshrc.platform

   > soamcontrol app enable <appName>

5.4                      Uninstallation

               1. Disable all applications

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

    > source cshrc.platform

    > soamcontrol app disable all

               2. Restore the backup file

    Log on to each management host and restore the backup file for the following binary:

    > $SOAM_HOME/5.0/linux2.6-glibc2.3-x86_64/etc/ssm

6.    List of files

ssm

7.    Copyright and trademark information

© Copyright IBM Corporation 2014

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.