Readme File for IBM® Spectrum Symphony 7.3.2 RFE SPCS-I-964, SPCS-I-974, and SPCS-I-977

Readme file for: IBM Spectrum Symphony

Product/Component Release: 7.3.2

Update Name: Interim Fix 601899

Fix ID: sym-7.3.2-build601899-jpmc

Publication date: Feb 27, 2024

 

Enhancements to update the IBM Spectrum Symphony host factory feature:

·       Update the symA requestor plug-in to release IBM Spectrum Symphony hosts that have only unoccupied allocations and that have the return_idle_only configuration enabled.

 

·       Add a configuration file to restrict the location of new or updated provider and requestor plug-in scripts.

 

Enhancement to support a server certificate chain for TLS-enabled connections so that the TLS client simply needs be configured with the root CA certificate when needed.

 

Contents

1.     Scope

2.     Installation and configuration

3.     Uninstallation

4.     List of files

5.     Product notifications

6.     Copyright and trademark information

1.   Scope

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

Operating system

Linux 64-bit

Product version

IBM Spectrum Symphony 7.3.2 with Fix 601711

2.     Installation and configuration

Follow these instructions to download and install this interim fix on the management and compute hosts in your cluster.

     System requirements

Linux x86_64

Pre-Installation

a.     Log on to the primary host as the cluster administrator, disable all applications, stop all EGO services and shutdown your cluster:

> egosh user logon -u Admin

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown all

 

Installing on management hosts

a.     On each management host, create a directory (for example, /symfixes) and download the hfcore-1.2.0.0_x86_64_build601899.tar.gz, egocore-4.0.0.0_x86_64_build601899.tar.gz and soamcore-7.3.2.0_x86_64_build601899.tar.gz packages to the directory.

b.     Use the egoinstallfixes command to install the packages:

> egoinstallfixes /symfixes/hfcore-1.2.0.0_x86_64_build601899.tar.gz

> egoinstallfixes /symfixes/egocore-4.0.0.0_x86_64_build601899.tar.gz

> egoinstallfixes /symfixes/soamcore-7.3.2.0_x86_64_build601899.tar.gz

 

Important: Running the egoinstallfixes command automatically backs up the current binary files to a fix backup directory.  For recovery purposes of the original file, do not delete this backup directory. For more information on using this command, see the egoinstallfixes command reference.

c.     Use the pversions command to verify the installation:

> pversions -b 601899

 

Installing on compute hosts

a.     On each compute host, create a directory (for example, /symfixes) and download the egocore-4.0.0.0_x86_64_build601899.tar.gz and soamcore-7.3.2.0_x86_64_build601899.tar.gz packages to the directory.

b.     Use the egoinstallfixes command to install the packages:

> egoinstallfixes /symfixes/egocore-4.0.0.0_x86_64_build601899.tar.gz

> egoinstallfixes /symfixes/soamcore-7.3.2.0_x86_64_build601899.tar.gz

c.      Use the pversions command to verify the installation:

> pversions -b 601899

 

Configuration

a.     On one management host, back up and modify the symA requestor configuration in the shared host factory directory:

> cd $EGO_CONFDIR/../../hostfactory/conf/requestors/symAinst

> cp symAinstreq_policy_config.json symAinstreq_policy_config.json.601899

> vi symAinstreq_policy_config.json

Add the return_all_if_zero_tasks configuration to return all instances provisioned by this requestor if there are no active tasks for monitored applications and if return_idle_only is enabled:

    "host_return_policy":[

        {

            "name": "lazy",

            "description": "Return cloud hosts closer to the end of billing interval",

            "billing_interval": 10,

            "return_interval": 5,

            "return_blocked_hosts": true,

            "force_return_interval": 3,

            "return_idle_only": true,

            "return_all_if_zero_tasks": true,

            "allow_idle_duration_seconds": 60

        },

        {

            "name": "immediate",

            "description": "Return cloud hosts immediately",

            "return_blocked_hosts": true,

            "force_return_interval": 1,

            "return_idle_only": true,

            "return_all_if_zero_tasks": true,

            "allow_idle_duration_seconds": 60

        }]

The return_all_if_zero_tasks configuration can be missing (undefined), be true, or be false. A missing configuration is same as setting this value to false. If return_idle_only is not set to true, return_all_if_zero_tasks will be ignored. If only return_idle_only is set to true, and all monitored applications are idle, instances with unoccupied allocations will not be returned. If return_all_if_zero_tasks is also set to true, and all monitored applications are idle, instances with unoccupied allocations will be returned. If LOG_DEBUG is enabled, a message will be logged once this feature is activated:

Returning all hosts if policy allows. All applications are idle and return_all_if_zero_tasks is true for return policy immediate.

b.     On one management host, create the new hostfactorysec.json file:
> cd $EGO_CONFDIR/../../hostfactory/conf

> vi hostfactorysec.json

Include this configuration to the file: {

  "HF_REQUESTOR_PLUGIN_SCRIPTS_TOP": "${HF_TOP}/${HF_VERSION}/requestorplugins/",

  "HF_PROVIDER_PLUGIN_SCRIPTS_TOP": "${HF_TOP}/${HF_VERSION}/providerplugins/"

}

If the hostfactorysec.json file is not present, the requestor and provider scripts can be specified in any directory. With this configuration, the scripts directory is restricted to the specified directory or its subdirectories. The Hostfactory service will log this configuration in LOG_DEBUG mode.

c.      From the primary host, start the cluster and enable your applications:

> egosh ego start all

> soamcontrol app enable application_name

3.    Uninstallation

If required, follow these instructions to uninstall this interim fix from management and compute hosts in your cluster.

a.     Log on to the primary host as the cluster administrator, disable all applications, stop all EGO services and shutdown your cluster:

> egosh user logon -u Admin

> soamcontrol app disable all

> egosh service stop all

> egosh ego shutdown all

b.     Log on to each management and compute host and roll back this interim fix:

> egoinstallfixes -r 601899

c.      On one management host, restore the symA requestor configuration file in the shared host factory directory:

$EGO_CONFDIR/../../hostfactory/conf/requestors/symAinst

d.     From the primary host, start the cluster and enable your applications:

> egosh ego start all

> soamcontrol app enable application_name

4.     List of files

ad7d37ee7c57acfc14b31cb65d702e42  hfcore-1.2.0.0_x86_64_build601899.tar.gz
2cc297c0b3f4254139c6559fc550642b  hostfactory/1.2/requestorplugins/symA/scripts/Calculator.py
fdbe9dc6ce05d719b76ec9b5390a8784  hostfactory/1.2/requestorplugins/symA/scripts/ClusterHandler.py
b721504e43567929c4a4c740eff74345  hostfactory/1.2/requestorplugins/symA/scripts/Config.py
e1887e411b9cc83c04b58e779606e84c  hostfactory/1.2/requestorplugins/symA/scripts/DefaultSetting.py
06332f97977e1d94aff93ad60441bd6b  hostfactory/1.2/requestorplugins/symA/scripts/Demand.py
e807c58214727c5a8ce2998a24b1aa55  hostfactory/1.2/requestorplugins/symA/scripts/Log.py
228871ed6bcb9af49d8d9d458bbd722a  hostfactory/1.2/requestorplugins/symA/scripts/Main.py
5fde6d861f44160f1c8a748e798e5864  hostfactory/1.2/requestorplugins/symA/scripts/Return.py
81dc2798dc5778dda97bb6a25868e329  hostfactory/1.2/requestorplugins/symA/scripts/Utilities.py
0b6b8dce1974ea7a7c52c7c10e23d444  hostfactory/1.2/linux-x86_64/etc/hostfactory

 

666731ddc6a5b2b06e94cdb27a0c4bb1  egocore-4.0.0.0_x86_64_build601899.tar.gz

eee0bbbd1c2e4fea1e40671356698c50  4.0/linux-x86_64/etc/pem

73b7b52230541b9ce1b3c220a15dfb51  4.0/linux-x86_64/etc/rs

2696569de0d50b88c28fda4928ca76e2  4.0/linux-x86_64/etc/vemkd

7f5eedae2827dba7a5ccc3d56898f428  4.0/linux-x86_64/etc/egosc

 

100a153f180f1916ea9a197bc12c2d65  soamcore-7.3.2.0_x86_64_build601899.tar.gz

12560fa8568f62884239258629688ecb  soam/7.3.2/linux-x86_64/etc/ssm

8b902a600d29db0ac6209e7d477f5665  soam/7.3.2/linux-x86_64/etc/sd

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

6.    Copyright and trademark information

© Copyright IBM Corporation 2024

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.