IBM Platform Symphony 6.1.0.1 Interim Fix 352482 Readme File

IBM Platform Symphony 6.1.0.1 Interim Fix 352482 Readme File

Abstract

1. The client host retains and uses up remote direct memory access (RDMA) buffers, causing the client to crash.

2. SI direct data transfer cannot get message by input keys due to a duplicate ACE Universally Unique Identifier (UUID), causing the client to crash.

3. The messageBlock releases twice in the MessageSubmitAttribute destructor and the direct data transfer message duplicate thread, causing the client to crash.

Description

1. RDMA buffers are used up and the client does not have enough buffers. This fix introduces a new API class called SoamDataBlock:SoamDataBlock::releaseBuffer, which can actively release buffers for the client, and therefore, prevent the client from crashing.

This API behaves as follows:

1) When buffer data has been sent out, there is no release on the buffer, and it writes information to the API log.

2) When buffer data is not sent out, the buffer occupied will be released. After releasing, the buffer returned by SoamDataBlock::buf will no longer be available.

2. SI direct data transfer cannot get message by input keys due to a duplicate ACE Universally Unique Identifier (UUID), causing the client to crash. This fix adds a sequence number to the end of the UUID to avoid duplication.

3. The messageBlock releases twice in the MessageSubmitAttribute destructor and the direct data transfer message duplicate thread, causing the client to crash. This fix removes the direct data transfer messages duplicate thread.

This fix is applicable to Linux 64-bit platforms.

Readme file for: IBM® Platform Symphony

Product/Component Release: 6.1.0.1

Update Name: Interim fix 352482

Fix ID: sym-6.1.0.1-build352482-nudt

Publication date: 3 August 2015

Last modified date: 3 August 2015

Contents:

1. List of fixes

2. Download location

3. Products or components affected

4. Installation and configuration

5. List of files

6. List of new APIs

7. Example API usage

8. Copyright and trademark information

1. List of fixes

APAR#P101168 P101170 P101169

2. Download location

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

3. Products or components affected

Product/Component Name, Platform, Fix ID:

Platform Symphony/API, Linux 64-bit, sym-6.1.0.1-build352482-nudt

4. Installation and configuration

4.1 Before installation

1. Disable all applications.

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

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all -f

2. Back up the affected files.

Log on to the client and on to each compute or management host and back up the following file that will be replaced by this fix:

For non-client hosts:

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

For client hosts:

> $SOAM_HOME/lib64/libsoambase.so

For .h and .cpp files, search the locally compiled environment and back up the files that will be replaced by this fix.

3. Back up customer clients.

4.2 Installation steps

Log on to the client and on to each compute or management host and replace the old files with the downloaded one:

For non-client hosts:

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

For client hosts:

> $SOAM_HOME/lib64/libsoambase.so

For .h and .cpp files, search the locally compiled environment and replace the old files with the downloaded one.

4.3 After installation

1. Compile the clients.

2. Enable all applications.

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

> egosh user logon -u Admin -x Admin

> soamcontrol app enable <appName>

4.4 Uninstallation

1. Disable all applications.

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

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all -f

2. Uninstall.

Restore the file that you previously backed up:

For non-client hosts

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

For client hosts

> $SOAM_HOME/lib64/libsoambase.so

For .h and .cpp files, search the locally compiled environment and restore the files with the backed up clients.

3. Enable all applications.

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

> egosh user logon -u Admin -x Admin

> soamcontrol app enable <appName>

5. List of files

libsoambase.so

SoamInterface.h

SoamDataBlock.h

SoamDataBlock.cpp

SoamInputStream.cpp

SoamOutputStream.cpp

6. List of new APIs

void SoamDataBlock:: releaseBuffer()

This API actively releases buffers.

7. Example API usage

soam::SoamDataBlockPtr inputdatan = new SoamDataBlock(1024*1024*g_inputsize, true);
inputdatan->releaseBuffer();

8. Copyright and trademark information

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.