Readme File for IBM® Spectrum Symphony RFE 132050

Readme file for: IBM Spectrum Symphony

Product/Component Release: 7.1.2

Fix ID: sym-7.1.2-build524770-cs

Publication date: July 21, 2019

This enhancement increases the string size limit of the status parameter for the TaskContext.PublishStatus .NET API to 1M (1024*1024 characters) in IBM Spectrum Symphony 7.1.2. Previously, the string size limit was 128 characters.

Contents

Scope

Installation

Uninstallation

Product notifications

Copyright and trademark information

1.   Scope

Before you install this update to your cluster, note the following requirements:

Operating system

Windows 2008 R2 64-bit

Product versions

·       IBM Spectrum Symphony 7.1.2

·       IBM Spectrum Symphony 7.1.2 Developer Edition

 

2.   Installation

Follow the instructions in this section to download and install this enhancement on Windows hosts in your cluster.

Prerequisites

Packages

Name

Description

soamcore-7.1.2.0_build524770.msp

Package containing the binary files for the cluster.

symde-7.1.2.0_build524770.msp

Package containing the binary files for the Developer Edition.

 

About the .Net files in this installation

This installation updates Platform.Symphony.Soam.Net4.0.dll and Platform.Symphony.Soam.Net4.0_64.dll only in the Global Assembly Cache. The file locations are:

C:\Windows\Microsoft.NET\assembly\GAC_32\Platform.Symphony.Soam.Net4.0\v4.0_7.1.2.0__ebe3ab0caa75a162\Platform.Symphony.Soam.Net4.0.dll

C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll

Ensure that any references to these files in your Visual Studio project point to the Global Assembly Cache location, not to the DE or client installation directories. Here is a sample for the 64bit file.

a.   In the Visual Studio Solution Explorer, expand the client sub-project.

b.   Under References, select Platform.Symphony.Soam.Net4.0_64.dll.

c.   In the Properties dialog, view the Path to ensure the GAC is referenced:

C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll

d.   If the GAC is not referenced, remove the Platform.Symphony.Soam.Net4.0_64 reference and add a new reference pointing to this file:

C:\Windows\Microsoft.Net\assembly\GAC_64\Platform.Symphony.Soam.Net4.0_64\v4.0_7.1.2.0__07d115044e882e03\Platform.Symphony.Soam.Net4.0_64.dll

Installing binaries on hosts in the cluster

a.    Log on to the master host as the cluster administrator and disable IBM Spectrum Symphony applications:

C:\>soamcontrol app disable all

b.    Log on to each host in the cluster and back up the following binary files:

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\etc\ssm.exe

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\etc\ssm.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soam_resources_7.1.2.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soam_resources_7.1.2.dll

c.    On each host, copy the soamcore-7.1.2.0_build524770.msp file for installation:

·       For an interactive installation, double-click the .msp package and follow the prompts.

·       For a silent installation, enter the following command from the command prompt:

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.

For example, to update a compute host, enter the following command:

C:\>msiexec /update C:\soamcore-7.1.2.0_build524770.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus

d.    Enable IBM Spectrum Symphony applications:

C:\>soamcontrol app enable <appName>

Installing binaries on Developer Edition hosts

a.   Log on to the Developer Edition host and disable IBM Spectrum Symphony applications:

C:\>soamcontrol app disable all

b.    Back up the following binary files:

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\etc\ssm.exe

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\etc\ssm.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.lib

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soambase.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.lib

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soambase.pdb

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib\soam_resources_7.1.2.dll

%SOAM_HOME%\7.1.2\w2k3_x64-vc7-psdk\lib64\soam_resources_7.1.2.dll

c.    On each host, copy the symde-7.1.2.0_build524770.msp file for installation:

·       For an interactive installation, double-click the .msp package and follow the prompts.

·       For a silent installation, enter the following command from the command prompt:

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.

For example, to update a host, enter the following command:

C:\>msiexec /update C:\symde-7.1.2.0_build524770.msp /l*v updateSym.log /norestart /quiet REINSTALLMODE=omus

d.    Enable IBM Spectrum Symphony applications:

C:\>soamcontrol app enable <appName>

3.   Uninstallation

If required, follow these steps to uninstall and disable this enhancement.

Uninstalling on hosts in the cluster

a.     Disable IBM Spectrum Symphony applications:

C:\>soamcontrol app disable all

b.     Uninstall the enhancement on each host:

·       To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.1.2 (build 524770) and click Uninstall.

·       To roll back from the IBM Spectrum Symphony command prompt, enter the following command:

C:\>msiexec /uninstall <enhancement_code> /package <product_msi> /norestart /quiet /l*v <Sym_rollback_log>

where:

o   <enhancement_code> is the identifier of the .msp package for this enhancement.

o   <product_msi> is the path to the .msi file for the original product installation package.

o   <Sym_rollback_log> is the name of the log file to capture details of the rollback.

For example, to uninstall this enhancement on a compute host, enter the following command:

C:\>msiexec /uninstall {3D0D168F-E6C6-4F43-9197-F5F422D33D08} /package {445FC793-46B4-4B0A-99CE-2662B1164812} /norestart /quiet /l*v sym_rollback.log

c.     Enable your applications:

C:\>soamcontrol app enable <appName>

Uninstalling on Developer Edition hosts

a.     Disable IBM Spectrum Symphony applications:

C:\>soamcontrol app disable all

b.     Uninstall the enhancement on each DE host:

·       To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.1.2 (build 524770) and click Uninstall.

·       To roll back from the IBM Spectrum Symphony command prompt, enter the following command:

C:\>msiexec /uninstall <enhancement_code> /package <product_msi> /norestart /quiet /l*v <Symde_rollback_log>

where:

o   <enhancement_code> is the identifier of the .msp package for this enhancement.

o   <product_msi> is the path to the .msi file for the original product DE installation package.

o   <Symde_rollback_log> is the name of the log file to capture details of the rollback.

For example, enter the following command:

C:\>msiexec /uninstall {5151CEFB-BB3E-4E31-B928-DD88055EE1AE} /package {B95E954E-ACC8-4AEB-BAC3-70F1E9D512B4} /norestart /quiet /l*v symde_rollback.log

c.     Enable your applications:

C:\>soamcontrol app enable <appName>

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

5.   Copyright and trademark information

© Copyright IBM Corporation 2019

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.