IBM Platform Symphony 6.1.1 Fix Pack 1 Readme File

Abstract

This fix pack addresses various fixes for Platform Symphony 6.1.1. Apply it to your Platform Symphony management, compute, and client hosts.

Description

This fix pack addresses various fixes for Platform Symphony 6.1.1. Apply it to your Platform Symphony management, compute, and client hosts.

Readme file for: IBM® Platform Symphony

Product/Component Release: 6.1.1

Update Name: Fix Pack 1 (246733)

Fix ID: sym-6.1.1-build246733-citigroup

Publication date: 14 November 2014

Last modified date: 14 November 2014

Contents:

1. List of fixes

2. Download location

3. Products or components affected

4. Installation and configuration

5. List of files

6. Copyright and trademark information

1. List of fixes

APAR#: P100810

2. Download location

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

3. Products or components affected

Product/Component Name/Platform:

IBM Platform Computing/all affected binaries/Windows 64-bit

4.  Installation and configuration

4.1        Before installation

1.  Shut down the cluster.

C:\>soamcontrol app disable all

C:\>egosh service stop all

C:\>egosh ego shutdown all

2. Back up all files under the following folders on all management and compute hosts:

%SOAM_HOME%\..\perf\ego\1.2.8\lib\

%SOAM_HOME%\..\perf\1.2.8\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\ego\1.2.8\platform\

%SOAM_HOME%\..\gui\ego\1.2.8\lib\win\

%SOAM_HOME%\..\gui\conf\standard_reports\ego\

%SOAM_HOME%\..\gui\1.2.8\lib\

%SOAM_HOME%\..\gui\1.2.8\etc\win2003-x64

%SOAM_HOME%\..\1.2.8\lib\

%SOAM_HOME%\..\1.2.8\etc\

%SOAM_HOME%\..\1.2.8\bin\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\js

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\wizard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\pmr\jobs\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\application\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\dashboard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\session\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\task\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\widget\min\js\

%SOAM_HOME%\..\perf\soam\6.1.1\DBschema\

%SOAM_HOME%\..\perf\soam\6.1.1\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\bin\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\etc\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib64\

3. Back up all files under the following folders on all client hosts:

%SOAM_HOME%\lib\

%SOAM_HOME%\lib64\

4.2        Installation steps

1. Remove the following old .jar files from management hosts that will be upgraded by this fix pack. The following is a list of old .jar files on management hosts:

%SOAM_HOME%\..\perf\1.2.8\lib\commons-fileupload-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\xwork-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-spring-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-junit-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-json-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\stringutils-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-web-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-tx-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-test-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-taglibs-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-acl-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-orm-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-jdbc-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-expression-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-context-support-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-context-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-beans-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-asm-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-aop-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\ognl-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\commons-lang3-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\xwork-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\struts2-core-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\ognl-*.jar

%SOAM_HOME%\..\gui\1.2.8\lib\commons-fileupload-*.jar

2. Decompress the ego1.2.8_win-x64_246733.zip and soam6.1.1_win-x64_246733.zip file to get all files, and then copy all files to the following directory on all management hosts and compute hosts:

%SOAM_HOME%\..\perf\ego\1.2.8\lib\

%SOAM_HOME%\..\perf\1.2.8\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\ego\1.2.8\platform\

%SOAM_HOME%\..\gui\ego\1.2.8\lib\win\

%SOAM_HOME%\..\gui\conf\standard_reports\ego\

%SOAM_HOME%\..\gui\1.2.8\lib\

%SOAM_HOME%\..\gui\1.2.8\etc\win2003-x64

%SOAM_HOME%\..\1.2.8\lib\

%SOAM_HOME%\..\1.2.8\etc\

%SOAM_HOME%\..\1.2.8\bin\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\js

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\wizard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\pmr\jobs\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\application\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\dashboard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\session\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\task\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\widget\min\js\

%SOAM_HOME%\..\perf\soam\6.1.1\DBschema\

%SOAM_HOME%\..\perf\soam\6.1.1\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\bin\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\etc\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib64\

3. Decompress the SymClnt6.1.1_win-x64_246733.zip file to get all files, and then copy all files to the following directory on all client hosts:

%SOAM_HOME%\lib\

%SOAM_HOME%\lib64\

4.3        After installation

1. Verify the installation on the management hosts.

Note: The build numbers of some binary files in the fix pack are greater than fix pack build number. This is as designed.

Use the -V command to check the version of the cluster.

If you have upgraded successfully, the "ssm -V" and "vemkd -V" commands provide the following output:

> ssm.exe -V

IBM Platform Symphony 6.1.1.0 build 243623, Sep 18 2014

Copyright International Business Machines Corp, 1992-2013.

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

> vemkd.exe -V

Platform EGO 1.2.8.0 build 245107, Oct 15 2014

Copyright International Business Machines Corp, 1992-2013.

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

binary type: win2003-x64

notes:

fixes:

2. Update the .NET Global Assembly Cache (GAC) on the Windows host:

Option 1: Use the gacutil tool to update the GAC if Microsoft Visual Studio is already installed on all Windows hosts:

a). Open a Visual Studio command prompt or .NET Framework SDK command prompt.

b). Run the following commands:

gacutil -i %SOAM_HOME%\6.1.1\w2k3_x64-vc7-psdk\lib64\Platform.Symphony.Soam.Net_64.dll

gacutil -i %SOAM_HOME%\6.1.1\w2k3_x64-vc7-psdk\lib\Platform.Symphony.Soam.Net.dll

The following is an example output:

Microsoft (R) .NET Global Assembly Cache Utility. Version 2.0.50727.42

Copyright (c) Microsoft Corporation. All rights reserved.

Assembly successfully added to the cache

Option 2: Drag the .dll file into the C:\SystemRoot\Assembly directory:

a). Delete the corresponding old files. From a command prompt window, run:

> cd C:\WINDOWS\assembly\GAC_64\Platform.Symphony.Soam.Net_64\6.1.1.0__07d115044e882e03

del *

> cd C:\WINDOWS\assembly\GAC\Platform.Symphony.Soam.Net\6.1.1.0__ebe3ab0caa75a162

del *

b). Drag the .dll file into the C:\SystemRoot\Assembly directory:

1) Open two instances of Windows Explorer. In one, navigate to the location of the .dll file. In the other, navigate to the C:\SystemRoot\Assembly directory.

2) Drag the file Platform.Symphony.Soam.Net_64.dll file from the %SOAM_HOME%\6.1.1\w2k3_x64-vc7-psdk\lib64 directory to the C:\WINDOWS\assembly directory.

3) Drag the Platform.Symphony.Soam.Net.dll file from the %SOAM_HOME%\6.1.1\w2k3_x64-vc7-psdk\lib directory to the C:\WINDOWS\assembly directory.

Option 3: Copy the new assembly into the same location as your client.

If you cannot manually install the GAC, you can copy the new assembly into the same location as your client and deploy it in your service package as another dependent library of your service.

For 64-bit applications, use the Platform.Symphony.Soam.Net_64.dll file.

For 32-bit applications, use the Platform.Symphony.Soam.Net.dll file.

3. Clean up all working directories on all management hosts. Delete all subdirectories and files from these directories:

> del /f /s /q %SOAM_HOME%\..\gui\work\*

> del /f /s /q %SOAM_HOME%\..\soam\work\*

4. Clean up the browser cache on all client hosts. 

5. Start the upgraded cluster.

C:\>egosh ego start

C:\>soamcontrol app enable appName

4.4        Uninstalling

1.   Shut down the cluster.

C:\>soamcontrol app disable all

C:\>egosh service stop all

C:\>egosh ego shutdown all

2. Remove the following new .jar files from management hosts that are introduced by this fix pack. The following is a list of .jar files on management hosts:

%SOAM_HOME%\..\perf\1.2.8\lib\commons-fileupload-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\xwork-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-spring-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-junit-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-json-plugin-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\struts2-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\stringutils-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-web-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-tx-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-test-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-taglibs-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-security-acl-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-orm-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-jdbc-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-expression-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-core-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-context-support-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-context-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-beans-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-asm-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\spring-aop-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\ognl-*.jar

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\lib\commons-lang3-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\xwork-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\struts2-core-*.jar

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\ognl-*.jar

%SOAM_HOME%\..\gui\1.2.8\lib\commons-fileupload-*.jar

3.    Restore the following folders on all management hosts and compute host with the backed-up file:

%SOAM_HOME%\..\perf\ego\1.2.8\lib\

%SOAM_HOME%\..\perf\1.2.8\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\lib\

%SOAM_HOME%\..\gui\perf\1.2.8\perfgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\ego\1.2.8\platform\

%SOAM_HOME%\..\gui\ego\1.2.8\lib\win\

%SOAM_HOME%\..\gui\conf\standard_reports\ego\

%SOAM_HOME%\..\gui\1.2.8\lib\

%SOAM_HOME%\..\gui\1.2.8\etc\win2003-x64

%SOAM_HOME%\..\1.2.8\lib\

%SOAM_HOME%\..\1.2.8\etc\

%SOAM_HOME%\..\1.2.8\bin\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\js

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\WEB-INF\classes\

%SOAM_HOME%\..\gui\soam\6.1.1\soamgui\wizard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\pmr\jobs\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\application\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\dashboard\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\session\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\sym\task\js\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\WEB-INF\

%SOAM_HOME%\..\gui\soam\6.1.1\symgui\widget\min\js\

%SOAM_HOME%\..\perf\soam\6.1.1\DBschema\

%SOAM_HOME%\..\perf\soam\6.1.1\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\bin\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\etc\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib\

%SOAM_HOME%\..\soam\6.1.1\w2k3_x64-vc7-psdk\lib64\

4.   Restore the following folders on all client hosts with the backed-up file:

%SOAM_HOME%\lib\

%SOAM_HOME%\lib64\

5.   Start the cluster.

C:\>egosh ego start

C:\>soamcontrol app enable appName

5. List of files

SymClnt6.1.1_win-x64_246733.zip

ego1.2.8_win-x64_246733.zip

soam6.1.1_win-x64_246733.zip

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