Upgrading IBM Spectrum Symphony silently on Windows using .exe packages

Upgrade IBM® Spectrum Symphony to the latest version by performing a silent installation of the .exe packages, using only the command line. The .exe method is only supported if the cluster uses advanced WEM. Typically, you install IBM Spectrum Symphony on the primary host using the interactive method, and then upgrade on management and compute hosts using either the interactive or silent method. (If you do want to upgrade on the primary host using the silent method, contact IBM support for assistance.) This topic describes how to upgrade silently using .exe packages on management and compute hosts.

Before you begin

About this task

After you upgrade IBM Spectrum Symphony on the primary host using the interactive method (see Performing a rolling upgrade on Windows), follow the steps in this topic to upgrade silently on management or compute hosts.

When you upgraded IBM Spectrum Symphony on the primary host, the installer generated the SymInstallManagement-version.bat and SymInstallCompute-version.bat installer files under the installation directory. You will run the .bat files in the following steps.

Procedure

  1. Log on to your host using the same installation user operating system account that you used to install your previous version of IBM Spectrum Symphony.
  2. Copy the following installer files from the installation directory of the primary host where you upgraded IBM Spectrum Symphony, to the management and compute hosts on which you want to upgrade IBM Spectrum Symphony. Note that you may have other versions of these installer files in your directory. Ensure that you copy the 7.3.2 version of the files:
    • SymInstallManagement-version.bat
    • SymInstallCompute-version.bat
    • SymInstallManagement-version.iss
    • SymInstallCompute-version.iss
    • sym-version.exe
  3. Upgrade the IBM Spectrum Symphony .exe package (sym-version.exe) by opening a command prompt, going to the directory where the file is located, and running the appropriate command:
    • For a management host, run:
      SymInstallManagement-version.bat
    • For a compute host, run:
      SymInstallCompute-version.bat

    The .bat files use the following parameters and values. The MASTERHOST parameter is mandatory; all other parameters are optional or conditional. If you do not specify an optional parameter, the installer will use the default values described in these parameter descriptions:

    Option Description
    MASTERHOST Set the name of the primary host.
    INSTALLDIR Optional. Set the path to the installation directory. For a rolling upgrade, set this to the directory where you have your previous version of IBM Spectrum Symphony installed. The default is C:\Program Files\IBM\SpectrumComputing. Change this directory if your previous installation was not to the default directory.
    CLUSTERNAME Optional. Define the name of the cluster. The default is cluster1.
    Your cluster name is permanent; you cannot change it after installation. Do not use the name of any host or user as the name of your cluster. Consider the following rules when naming your cluster:
    • The cluster name can contain up to 39 alphanumeric characters.
    • The cluster name can contain the underscore character (_), the hyphen character (-), and the period (.). No other special characters are supported.
    • The cluster name cannot contain spaces.
    CLUSTERADMIN Optional. Specify the cluster administrator OS user account name in the format domain\user_name.

    If you are using a local user, specify .\user_name and ensure that the user password is the same on all hosts.

    The default is your installation account.

    CLUSTERID Mandatory if you are running the installation to upgrade IBM Spectrum Symphony. Set the ID of the cluster.
    BASEPORT Optional. Set the connection base port for the cluster. The default is 7869.
    DBHOST Optional. Specify the name of the host where Derby (the non-production database) will run. Do not specify an external database instead of Derby.
    DISABLESSL Optional. For management hosts, specify Yes to disable security, which is enabled by default during installation to secure web server communication.
    The web servers are accessible on the following default ports:
    • The cluster management console web server: With security disabled, the default port is 8080. Otherwise, the default port is 8443.
    • The REST web server: With security disabled, the default port is 8180. Otherwise, the default port is 8543.
    Note: Check for port conflicts to ensure that the specified ports are free.
  4. Open a command prompt on the upgraded version, and run the egosh -V command to confirm the upgrade on your hosts. The output should list the EGO version as 4.0.0.
    egosh -V
    EGO 4.0.0 build xxxxxx, MMM DD YYYY
    binary type: win-x64

What to do next

After upgrading IBM Spectrum Symphony to the latest version by performing a silent installation of the .exe packages, complete the remaining steps in Performing a rolling upgrade on Windows to access the cluster management console, to verify that you have installed the applicable IBM Spectrum Symphony packages, and to complete any post-upgrade tasks.