Readme File for IBM® Spectrum Symphony 7.2.1 Interim Fix 550998 

Readme File for: IBM Spectrum Symphony

Product Release: 7.2.1

Update Name: Interim Fix 550998

Fix ID: sym-7.2.1-build550998

Publication Date: June 26, 2020

 

The host factory of IBM Spectrum Symphony occasionally overprovisions cloud hosts beyond the maximum number limit for each template. The overprovisioning occurs if the HostFactory service was restarted after cloud provisioning requests were submitted. The overprovisioning is caused by an incorrect recovery of internal state after a service restart.

 

This interim fix allows host factory to recover internal state correctly and preventing overprovisioning of cloud hosts.

Contents

1. List of fixes

2. Download location

3. Product and components affected

4. Installation and configuration

5. Uninstallation

6. List of files

7. Product notifications

8. Copyright and trademark information

 

1.  List of fixes

APAR: P103712

2.  Download location

Download interim fix 550998 from the following location: https://www.ibm.com/eserver/support/fixes/

3.  Product and components affected

Component name, Platform, Fix ID:

EGO, Linux x86_64, sym-7.2.1-build550998

4.  Installation and configuration

Follow the instructions in this section to download and install this interim fix to your cluster.

System requirements

Linux x86_64

Prerequisites

·        Fix Pack 7.2.1.1 (fix ID sym-7.2.1-build507069) must be installed in your IBM Spectrum Symphony 7.2.1 cluster.

 

Packages

Name

Description

egocore-3.7.0_x86_64_build550998.tar.gz

Package for Linux management hosts

Installation

Before you install this interim fix, verify that all cloud hosts provisioned that uses host factory are returned and there are no active requests for provisioning or returning cloud hosts.
 
Tip:  If you are using
manual provisioning, wait for active provision and return requests to complete, then return the provisioned hosts from the GUI or through REST API.  If you are using dynamic provisioning, either reduce the application workload significantly or increase the service level agreement (SLA) of the configured application, such as desired_task_complete_duration.  Wait for host factory to dynamically scale down and return all the provisioned cloud hosts.

a.     Log on to the master host as the cluster administrator and stop the HostFactory service:

> egosh user logon -u Admin

> egosh service stop HostFactory

b.     Clean up the work directory containing the host factory metadata:

      > rm -rf $EGO_CONFDIR/../../eservice/hostfactory/work/*

c.     On each management host:

                 i.         Log on as the cluster administrator.

                ii.         Create a directory, for example /symfixes directory.

               iii.         Download the egocore-3.7.0_x86_64_build550998.tar.gz package into the newly created directory.

               iv.         Use the egoinstallfixes command to install the package:

egoinstallfixes /symfixes/egocore-3.7.0_x86_64_build550998.tar.gz --silent

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

                v.         Use the pversions command to verify the installation:

        pversions -b 550998

d.     Log on to the master host as the cluster administrator and start the HostFactory service:

> egosh service start HostFactory

 

5.  Uninstallation

If required, follow the instructions in this section to uninstall this interim fix in your cluster.

a.     Log on to the master host as the cluster administrator and stop the HostFactory service:

> egosh user logon -u Admin

> egosh service stop HostFactory

b.     Clean up the work directory containing the host factory metadata:
> rm -rf $EGO_CONFDIR/../../eservice/hostfactory/work/*

c.     Log on to each management host as the cluster administrator and roll back this fix:

> egoinstallfixes -r 550998

d.     Log on to the master host as the cluster administrator and start the HostFactory service:

> egosh service start HostFactory

6.  List of files

$EGO_TOP/3.7/linux-x86_64/etc/hostfactory

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

8.  Copyright and trademark information

© Copyright IBM Corporation 2020

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.