Readme File for IBM® Spectrum Symphony RFE 149599


Readme file for:
IBM Spectrum Symphony

Product release: 7.2.1

Fix ID: sym-7.2.1-build600654-ms

Publication date: Sep 24, 2021

 

This enhancement allows IBM Spectrum Symphony HostFactory to specify volumeType for the provisioned host in awsprov_templates.json file.

 

1.    Scope 

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

Operating systems

IBM Spectrum Symphony: RHEL 6.4 to 7.4 64-bit

Product version

IBM Spectrum Symphony 7.2.1

 

2.    Installation

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

Installing on IBM Spectrum Symphony management hosts

a.       Log on to a management host as the cluster administrator:

> egosh user logon -u Admin -x Admin

b.       Stop the WEBGUI and HostFactory services:

> egosh service stop WEBGUI HostFactory

c.       On each management host in your cluster, download the following packages to, for example, the /symfixes directory.

        egomgmt-3.7.0_noarch_build600654.tar.gz

       egocore-3.7.0_x86_64_build600654.tar.gz

d.       Run the egoinstallfixes command to install the packages:

> egoinstallfixes /symfixes/egomgmt-3.7.0_noarch_build600654.tar.gz

> egoinstallfixes /symfixes/egocore-3.7.0_x86_64_build600654.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.

e.       Run the pversions command to verify the installation: 

> pversions -b 600654

f.      Delete all subdirectories and files in the following directories:

$ rm -rf $EGO_TOP/gui/work/*

$ rm -rf $EGO_TOP/gui/workarea/*

 (Optional) $ rm -rf $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/*

g.     Clear your browser cache. 

3.    Configuration and usage

     Configuration steps

a.     On the primary and primary candidate hosts, add configuration to aws template file ($EGO_CONFDIR/../../eservice/hostfactory/conf/providers/aws/conf/awsprov_templates.json):

Configure the volumeType and iops. For example:

{

    "templates": [

        {

            "templateId": "Template-VM-SYMA",

            "maxNumber": 10,

            "attributes": {

                "type": ["String", "X86_64"],

                "ncores": ["Numeric", "1"],

                "ncpus": ["Numeric", "1"],

                "nram": ["Numeric", "1024"]

            },

            "imageId": "ami-0f3bfc8dc665d2684",

            "subnetId": "subnet-04da4ea7421bd52ed",

            "volumeType" : "io1",

            "iops": 100,

            "vmType": "t2.micro",

            "keyName": "sym-key-4-symqa",

            "securityGroupIds": ["sg-18e44165"],

            "userDataScript": "/opt/weige/SYM7211/eservice/hostfactory/conf/providers/aws/conf/post_install.sh"

        }

    ]

}

 

volumeType: valid value is "gp2", "gp3", "io1", "io2", "standard". Default is "gp2". If the volume type is configured invalid, the volume type of "gp2" is used instead.

iops: if volumeType is configured as io1 and io2, it requires to configure this parameter. Valid value is an integer in the range 100 – 64000. If the iops specified is larger than 64000 or smaller than 100, the default 100 is used instead.

 

b.     Log on to the primary host, start the WEBGUI and HostFactory services:

 

> egosh service start WEBGUI HostFactory

4.    Uninstallation

Uninstalling from IBM Spectrum Symphony management hosts

a.       Log on to the IBM Spectrum Symphony management as the cluster administrator:

> egosh user logon -u Admin -x Admin

b.       Stop the WEBGUI and HostFactory services:

> egosh service stop WEBGUI HostFactory

c.       On each management host, roll back this interim fix:

> egoinstallfixes -r 600654

d.    On primary host, remove the new configurations in awsprov_templates.json file.

e.      Delete all subdirectories and files in the following directories:

$ rm -rf $EGO_TOP/gui/work/*

$ rm -rf $EGO_TOP/gui/workarea/*

 (Optional) $ rm -rf $WLP_OUTPUT_DIR/webgui_hostname/gui/workarea/*

f.     Clear your browser cache. 

g.      Log on to the primary host, start the WEBGUI and HostFactory services:

> egosh service start WEBGUI HostFactory

5.    List of files

    egomgmt-3.7.0_noarch_build600654.tar.gz
       wlp/usr/servers/gui/apps/ego/3.7/platformv5/resources/cloud/i18n/locale-en.json
       wlp/usr/servers/gui/apps/ego/3.7/platformv5/resources/cloud/i18n/locale-zh.json
    egocore-3.7.0_x86_64_build600654.tar.gz
       3.7/hostfactory/providers/aws/lib/AwsTool.jar

 

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.