Readme File for IBM® Spectrum Symphony 7.3 RFE 145085 and 147589

Readme file for: IBM Spectrum Symphony

Product release: 7.3

Fix ID: sym-7.3-build600306-cs

Publication date: April 9, 2021

This fix provides two enhancements for multidimensional scheduling slot definition configuration: support for using zero (0) as the value for dimension metrics, and a new optional slot definition metric parameter to set service resource limits.

 

1.    Scope

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

Operating system

·        Windows Server 2012 to 2016 

·        Windows 8 to 10

 

Product version

IBM Spectrum Symphony 7.3

 

2.    Installation

Follow these instructions to download and install this enhancement on hosts in your cluster.

a.       Log on to the primary host as the cluster administrator, disable all applications and stop SD service:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all

> egosh service stop SD

b.       On each management host, download the sym-7.3.0.0-soamcore-7.3.0.0_build600306.msp and sym-7.3.0.0-soammgmt-7.3.0.0_build600306.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:\sym-7.3.0.0-soamcore-7.3.0.0_build600306.msp /l*v soamcore_install.log /norestart /quiet REINSTALLMODE=omus

C:\> msiexec /update C:\sym-7.3.0.0-soammgmt-7.3.0.0_build600306.msp /l*v soammgmt_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:\sym-7.3.0.0-soamcore-7.3.0.0_build600306.msp and sym-7.3.0.0-soammgmt-7.3.0.0_build600306.msp.

ž   sym_install_log is the log file for the upgrade; in this case, soamcore_install.log and soammgmt_install.log.

c.       Use the pversions command to verify the installation:

> pversions

d.       Enable your applications and start SD service:

> soamcontrol app enable application_name

> egosh service start SD

3.    Configuration and usage

After applying this enhancement, you can edit the MDS section of your application profile to configure the two enhancements.

To specify zero as the value for the multidimensional scheduling slot definition metrics, specify zero for the metric value. Note that for slot definitions to be valid, there must be least one non-serio metric value. For example:

<SlotDefinition name="zero_cpu" default="true">

<Metric name="ncpus">0</Metric>

<Metric name="maxmem">250</Metric>

</SlotDefinition>


To include a new slot definition metric parameter, called
limit, so that you can set service resource limits, add the limit parameter to your slot definition metric. For example:

 

<SlotDefinition name="service_limit" default="true">

<Metric name="ncpus" limit="3">2</Metric>

<Metric name="maxmem" limit="0">250</Metric>

</SlotDefinition>

When a service resource limit is enabled, the new parameter overrides the metric value. If the limit parameter is zero, the resource limit parameter is not applied.

4.    Uninstallation

If required, follow these instructions to uninstall this enhancement from hosts in your cluster.

a.       Log on to the primary host as the cluster administrator, disable all applications and stop SD service:

> egosh user logon -u Admin -x Admin

> soamcontrol app disable all

> egosh service stop SD

b.       Log on to each management host and roll back to the previous version of IBM Spectrum Symphony either from the Windows Control Panel or from the IBM Spectrum Symphony command line:

ž   To roll back from the Windows Control Panel, go to Control Panel > Programs and Features > View installed updates, click Update for Symphony 7.3.0 (build “600306”), and click Uninstall.

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

C:\> msiexec /uninstall {EF857E42-0E22-4C06-A63B-2F17BCDB7636} /package {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64} /norestart /quiet /l*v sym_rollback_soamcore.log

C:\> msiexec /uninstall {5CA7F89C-0A74-4AC7-B697-EFB1EFFD6C0C} /package {0C38B4FE-C44E-4C77-9A31-D0D2BCD24B08} /norestart /quiet /l*v sym_rollback_soammgmt.log

The command syntax is as follows:

C:\> msiexec /uninstall enhancement_code /package product_code /norestart /quiet /l*v rollback_log

where:

ž   enhancement_code is the identifier of the .msp package for this enhancement; in this case, {EF857E42-0E22-4C06-A63B-2F17BCDB7636} and {5CA7F89C-0A74-4AC7-B697-EFB1EFFD6C0C}.

ž   product_code is the identifier of the .msi file in the original product installation package; in this case, {5B7B0C11-4DDB-4C5F-96A2-D1DCF66DBB64} and {0C38B4FE-C44E-4C77-9A31-D0D2BCD24B08}.

ž   rollback_log is the name of the log file to capture details of the rollback; in this case, sym_rollback_soamcore.log and sym_rollback_soammgmt.log.

c.       Enable your applications and start SD service:

> soamcontrol app enable application_name

> egosh service start SD

5.    List of files

e0937f334e5f47435e215f1565f733c2 sym-7.3.0.0-soamcore-7.3.0.0_build600306.msp

2f3d74f850dd6bce544cc6b925d7176b sym-7.3.0.0-soammgmt-7.3.0.0_build600306.msp

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

7.    Copyright and trademark information

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