Readme File for IBM® Spectrum Symphony RFE 134748
Readme file for: IBM Spectrum Symphony
Product release: 7.3.1
Fix ID: sym-7.3.1-build600341-cacib
Publication date: Apr 30, 2021
With this IBM Spectrum Symphony enhancement, partial .NET Core 5 support
was added to the IBM Spectrum Symphony client API.
Before you install this enhancement to your cluster, note the following requirements:
|
Operating system |
· RHEL 6.x to 8.x 64-bit |
|
· Windows Server 2012 to 2016 · Windows 8 to 10 |
|
|
Product version |
IBM
Spectrum Symphony 7.3.1 |
Follow these instructions to download and install
this enhancement on hosts in your cluster.
Prerequisites
Download and install .NET 5 according to the Microsoft documentation: https://dotnet.microsoft.com/download/dotnet/5.0
If there are running .NET Core applications in the cluster, stop them, and
rebuild with the new Platform.Symphony.Soam.NetCore_64.dll SDK.
a. On each management host and compute host, download the soamcore-7.3.1.0_x86_64_build600341.tar.gz package to, for example, the /symfixes directory.
b.
Run
the egoinstallfixes command to install the soamcore-7.3.1.0_x86_64_build600341.tar.gz package:
> egoinstallfixes /symfixes/soamcore-7.3.1.0_x86_64_build600341.tar.gz
Note: Running
the egoinstallfixes command automatically backs up the current binary
files to a fix backup directory for recovery purposes. Do not delete this
backup directory; you will need it if you want to recover the original
files. For more information on using this command, see the egoinstallfixes
command reference
c.
Run the pversions command
to verify the installation:
> pversions -b 600341
IBM Spectrum soamcore 7.3.1.0
-----------------------------
binary type: linux-x86_64, Apr 14 2021,
Build 600341
installed: Apr 27 2021
notes:
fixes:
files: /soam/7.3.1/linux-x86_64/lib64/libsoamapidotnetcore.so.7.3.1
/soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
/soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
/soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
a.
Back up the following files:
$SOAM_HOME/7.3.1/linux-x86_64/lib64/libsoamapidotnetcore.so.7.3.1
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
b.
Download the symde-7.3.1.0_x86_64_build600341.tar.gz file and
extract its contents to the top-level installation directory:
> tar zxfo symde-7.3.1.0_x86_64_build600341.tar.gz
-C $SOAM_HOME
a.
Back up
the following files:
$SOAM_HOME/lib64/libsoamapidotnetcore.so.7.3.1
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
b.
Download
the symclnt-7.3.1.0_x86_64_build600341.tar.gz file and extract its contents to the top-level installation
directory:
>
tar zxfo symclnt-7.3.1.0_x86_64_build600341.tar.gz -C $SOAM_HOME
On each host, download the symde-7.3.1.0_build600341.msp package to a temporary location on the host and install the package:
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 C:\symde-7.3.1.0_build600341.msp /l*v install.log /norestart /quiet REINSTALLMODE=omus
The command syntax is as follows:
C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus
where:
sym_package_name_path is the fully qualified path to the .msp package; in this case, C:\symde-7.3.1.0_build600341.msp.
sym_install_log is the log file for the upgrade; in this case, install.log.
On each host, download the symclnt-7.3.1.0_build600341.msp package to a temporary location on the host and install the package:
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 C:\symclnt-7.3.1.0_build600341.msp /l*v install.log /norestart /quiet REINSTALLMODE=omus
The command syntax is as follows:
C:\>msiexec /update sym_package_name_path /l*v sym_install_log /norestart /quiet REINSTALLMODE=omus
where:
sym_package_name_path is
the fully qualified path to the .msp
package; in this case, C:\symclnt-7.3.1.0_build600341.msp.
sym_install_log is the log file for the upgrade; in this case, install.log.
Take the following steps to create
an application:
a. Use the dotnet new command to create
the Client, Common and Service projects:
> dotnet new console -n Client
> dotnet new classlib -n
Common
> dotnet new console -n Service
b.
Edit the Client/Client.csproj, Common/Common.csproj, Service/Service.csproj projects, and add .NET
Core reference to them. For example:
<ItemGroup>
<Reference
Include="Platform.Symphony.Soam.NetCore_64">
<HintPath>/PathOf/Platform.Symphony.Soam.NetCore_64.dll</HintPath>
</Reference>
</ItemGroup>
c. Use the dotnet
add command
to add the Common project as a reference
to the Client and Service projects:
> dotnet add Client/Client.csproj
reference Common/Common.csproj
> dotnet add Service/Service.csproj
reference Common/Common.csproj
d. Implement your changes to Client, Common and
Service code. For the
supported API lists, refer to the .NET 5 API reference from IBM Box: .NET
CORE 5 documentation.
e. Use the dotnet
build or dotnet
publish command to compile the
Client and Service projects:
> dotnet build --configuration Release
a. Log on to the IBM Spectrum Symphony management as the cluster administrator:
> egosh user logon -u Admin -x Admin
b.
Stop all .Net 5 applications:
> soamcontrol
app disable appName
c.
On each
cluster host, roll back this interim fix:
> egoinstallfixes -r 600341
a. Log on to the IBM Spectrum Symphony Developer Edition host, and stop all .NET 5 applications:
> soamcontrol app disable appName
b.
Restore
your backup for the following files:
$SOAM_HOME/7.3.1/linux-x86_64/lib64/libsoamapidotnetcore.so.7.3.1
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
$SOAM_HOME/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
a. Log on to the IBM Spectrum Symphony client host and stop the running .NET 5 client.
b.
Restore
your backup for the following files:
$SOAM_HOME/lib64/libsoamapidotnetcore.so.7.3.1
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
$SOAM_HOME/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
a. Log on to the IBM Spectrum Symphony Developer Edition host, and stop all .NET 5 applications:
> soamcontrol app disable appName
b.
On each
IBM Spectrum Symphony Developer Edition host, uninstall the enhancement:
To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.3.1 (build “600341”) and click Uninstall.
To roll back from the IBM Spectrum
Symphony command prompt, enter the following command:
C:\> msiexec /uninstall {46B86B78-05AB-4862-8AF1-5F964B986194} /package {B0C862C5-0439-4E94-8B25-E6E97254B79F} /norestart /quiet /l*v rollback.log
The command syntax is as follows:
C:\> msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback.log
where:
interim_fix_code is
the identifier of the .msp package
for this interim fix, in this case, {46B86B78-05AB-4862-8AF1-5F964B986194}.
product_code is
the identifier of the .msi file
for the original product installation package, in this case, {B0C862C5-0439-4E94-8B25-E6E97254B79F}.
rollback.log is the name of the log file to capture details of the rollback.
a. Log on to the IBM Spectrum Symphony client host and stop all .NET 5 applications.
b.
On each
IBM Spectrum Symphony client host, uninstall the enhancement:
To roll back from the Windows
Control Panel, go to Control Panel > Programs and Features
> View installed updates, click Update for Symphony 7.3.1 (build
“600341”) and click Uninstall.
To roll back from the IBM Spectrum
Symphony command prompt, enter the following command:
C:\> msiexec /uninstall {DD06360F-0F40-4D4A-83A9-2904F836D65D} /package {D0374E2E-2D3C-4240-9642-D99621AD5463} /norestart /quiet /l*v rollback.log
The command syntax is as follows:
C:\> msiexec /uninstall interim_fix_code /package product_code /norestart /quiet /l*v rollback.log
where:
interim_fix_code is the identifier of
the .msp
package for this
interim fix, in this case, {DD06360F-0F40-4D4A-83A9-2904F836D65D}.
product_code is the identifier of the .msi file for the original product installation package, in this case, {D0374E2E-2D3C-4240-9642-D99621AD5463}.
rollback.log is
the name of the log file to capture details of the rollback.
6eb898bb2bb4440c21520e969a5a8a4c soamcore-7.3.1.0_x86_64_build600341.tar.gz
c73f5fa1c90729a563c179422eb8514f soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
f50c51701140e077927e32c38e8804ff soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
6227257bb1406b5a9fd5ef7e6035feea soam/7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
5ff9f2c1f9a7ad4ed07e8c25ffd8936b soam/7.3.1/linux-x86_64/lib64/libsoamapidotnetcore.so.7.3.1
08c2b701aae11513a902fb412d9ba65c symde-7.3.1.0_x86_64_build600341.tar.gz
c73f5fa1c90729a563c179422eb8514f 7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
f50c51701140e077927e32c38e8804ff 7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
6227257bb1406b5a9fd5ef7e6035feea 7.3.1/linux-x86_64/lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
5ff9f2c1f9a7ad4ed07e8c25ffd8936b 7.3.1/linux-x86_64/lib64/libsoamapidotnetcore.so.7.3.1
5ec446517fdc53bb083e7691cf1636c5 symclnt-7.3.1.0_x86_64_build600341.tar.gz
c73f5fa1c90729a563c179422eb8514f
lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.dll
f50c51701140e077927e32c38e8804ff
lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.pdb
6227257bb1406b5a9fd5ef7e6035feea
lib64/Platform.Symphony.Soam.NetCore_64/7.3.1.0/Platform.Symphony.Soam.NetCore_64.deps.json
5ff9f2c1f9a7ad4ed07e8c25ffd8936b lib64/libsoamapidotnetcore.so.7.3.1
2404ca44865eefc36bd56305f59160b3 symde-7.3.1.0_build600341.msp
db9bdfa313f835d7356bb19485e776c7
7.3.1/w2k3_x64-vc7-psdk/lib64/Platform.Symphony.Soam.NetCore_64.dll
e4a5b6b17d995851e7d6f68aedb794de
7.3.1/w2k3_x64-vc7-psdk/lib64/Platform.Symphony.Soam.NetCore_64.deps.json
3d194e615778a2e3b05606d9fb4a1efd 7.3.1/w2k3_x64-vc7-psdk/lib64/soamapidotnetcore_7.3.1_64.dll
d0c9423b293bc4abe9660b316a9ad031
7.3.1/w2k3_x64-vc7-psdk/lib64/soamapidotnetcore_7.3.1_64.pdb
b424c43d24d0db56622c2b2ebeae21b0 symclnt-7.3.1.0_build600341.msp
db9bdfa313f835d7356bb19485e776c7
symclient/lib64/Platform.Symphony.Soam.NetCore_64.dll
e4a5b6b17d995851e7d6f68aedb794de
symclient/lib64/Platform.Symphony.Soam.NetCore_64.deps.json
3d194e615778a2e3b05606d9fb4a1efd
symclient/lib64/soamapidotnetcore_7.3.1_64.dll
d0c9423b293bc4abe9660b316a9ad031
symclient/lib64/soamapidotnetcore_7.3.1_64.pdb
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.
© Copyright IBM Corporation 2021
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.