IBM Platform Symphony 7.1.1 Interim Fix #411033 Readme File

Abstract

A symexec child process remains even after the symexec service process is terminated.

Description

This fix adds a new environment variable called SYMEXEC_SET_SAME_GROUP to the Service section of the application profile (Service > OsTypes > OsType > env). This environment variable specifies whether the SI and its child process are set to the same process group. If set to true, Platform Symphony will ensure the child process belongs to the same group as the SI. If set to false or if disabled, Platform Symphony ensures the child process belong to its own group.

This interim fix applies only to the following platforms:

Linux 64-bit

Readme file for: IBM® Platform Symphony

Product/Component Release: 7.1.1

Update Name: Interim Fix 411033

Fix ID: sym-7.1.1-build411033-ms

Publication date: 29 June 2016

Last modified date: 29 June 2016

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# P101765

2. Download location

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

3. Products or components affected

Product/Component Name, Platform, Fix ID:

Platform Symphony/symexecservice, Linux 64-bit, sym-7.1.1-build411033-ms

4. System requirements

You must have Platform Symphony 7.1.1 installed before applying this fix.

5. Installation and configuration

5.1 Before installation

1. Disable the application.

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

> egosh user logon -u Admin -x Admin

> soamcontrol app disable symexec7.1.1

2. Log on to all hosts in the cluster and back up the following file that will be replaced by this fix:

> $SOAM_BINDIR/symexecservice

5.2 Installation steps

Log on to all hosts in the cluster and decompress the .tar file to your Platform Symphony installation directory:

> tar zxfo pssasetup2015_linux-x86_64_build411033.tar.gz -C $EGO_TOP

5.3 After installation

1. Enable the fix.

Configure the SYMEXEC_SET_SAME_GROUP environment variable in the application profile of the symexec application, as follows:

<Service default="true" description="The Execution Service" name="symexecservice">
       <osTypes>
            <osType fileNamePattern="%sessionId%" logDirectory="${SOAM_HOME}/work" name="all">
            ....
               <env name="SYMEXEC_SET_SAME_GROUP">true</env>
            </osType>
        </osTypes>
</Service>

By default, the value of SYMEXEC_SET_SAME_GROUP environment variable is false.

2. Register and enable the application:

> soamreg symexec7.1.1.xml

> soamcontrol app enable symexec7.1.1

5.4 Uninstallation

1. Disable the application.

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

> soamcontrol app disable symexec7.1.1

2. Log on to all hosts in the cluster and restore the backup file:

> $SOAM_BINDIR/symexecservice

3. Remove the SYMEXEC_SET_SAME_GROUP environment variable from the application profile.

4. Register and enable the application:

> soamreg symexec7.1.1.xml

> soamcontrol app enable symexec7.1.1

6. List of files

pssasetup2015_linux-x86_64_build411033.tar.gz:

soam/7.1.1/linux-x86_64/bin/symexecservice

7. Copyright and trademark information

© Copyright IBM Corporation 2016

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.