Upgrading an existing installation

If you are already using a version 1.2.x or 1.5.x of IBM® Spectrum Control Base Edition (formerly known as IBM Storage Integration Server), you can upgrade to the newer version without having to uninstall the previous version.

Before you begin

  • Back up the current Integration Server database, using the isis_configuration backup -f /var/tmp/backup -k <key value> command.
  • Verify that the TCP port 8443 is open and network connectivity to the IBM storage systems and VMware resources (vCenter server, vSphere applications, etc) is available. In addition, make sure that the 'ibmsc' user can access the /opt/ibm and /var/log/sc folders.

Procedure

Perform the following procedure to upgrade Spectrum Control:

  1. Log out of the Spectrum Control GUI and close the browser.
  2. On the Spectrum Control side: download the newer installation package and the IBM_Spectrum_Control_Signing_Key_Pub.key file, used for the package validation. See Downloading IBM Spectrum Control Base Edition software).
  3. Copy the installation package and the public key files to a local folder on a current Spectrum Control server.
  4. Go to the local folder and then use the gpg --import IBM_Spectrum_Control_Signing_Key_Pub.key to import the IBM GNU Privacy Guard (GPG) public key to validate that the installation files. This ensures that the files were received from IBM and were not manipulated in any way by a third party.
  5. Enter gpg --verify IBM_Spectrum_Control_Base_Edition_v2.0.1.tar.gz.asc IBM_Spectrum_Control_Base_Edition_v2.0.1.tar.gz to verify the digital signature of the installation files.
  6. Extract the installation package file ('* ' represents the build number) : 
    # tar -xzvf IBM_Spectrum_Control_Base_Edition-2.0.1-*-x86_64.tar.gz
    The following RPM files are extracted:
    • nginx-1.6.2-1.el6.ngx.x86_64.rpm
    • postgresql92-9.2.2-1PGDG.rhel6.x86_64.rpm
    • postgresql92-contrib-9.2.2-1PGDG.rhel6.x86_64.rpm
    • postgresql92-libs-9.2.2-1PGDG.rhel6.x86_64.rpm
    • postgresql92-server-9.2.2-1PGDG.rhel6.x86_64.rpm
    • uuid-1.6.1-10.el6.x86_64.rpm
    • ibm_spectrum_control-2.0.1-*.bin – product BIN file.
    • ibm_spectrum_control_java_runtime_extension-2.0.0-*.bin – Required if DS8000® is used; should be installed last.
  7. Go to the extracted directory and then use the-U *.rpm command to run and install all the complementary RPM files.
  8. Enter chmod +x ibm_spectrum_control-2.0.1-*.bin to authorize the installation of the product BIN file.
  9. Enter ./ibm_spectrum_control-2.0.1-*.bin to start the upgrade.

  1. Review the license agreement which is displayed after you run the installation file.
  2. Enter 1 to accept the license agreement and complete the installation: 
    Press Enter to continue viewing the license agreement, or enter "1" to accept 
the agreement, "2" to decline it, "3" to print it, "4" to read non-IBM terms, 
or "99" to go back.

1

Preparing to upgrade [ibm_storage_integration_server] to the new [ibm_spectrum_control]
Stopping service ibm_storage_integration_server...
Renaming old user isis to ibmsc
Renaming old group isis to ibmsc
Upgrading [ibm_storage_integration_server] to the new [ibm_spectrum_control]
Moving rpm configuration files to IBM Spectrum Control
   3 configuration files replaced by newer versions. The original files moved to:
      /opt/ibm/ibm_spectrum_control/conf.d/ibmsyslog.conf.saverpm
      /opt/ibm/ibm_spectrum_control/conf.d/nginx/sc_nginx.conf.saverpm
      /opt/ibm/ibm_spectrum_control/conf.d/vasa1/vasa_config.ini.saverpm
Moving Django key to IBM Spectrum Control
Moving SSL Certificate to IBM Spectrum Control
Configuring rsyslog
Setting up nginx
Migrating database to IBM Spectrum Control
Configuring new service [ibm_spectrum_control]
Update SC_UUID
Upgrading the extension of all registered vCenter servers...
Adding a default vCO server instance...
Starting Celery services ... [OK]
Starting Django service ... [OK]
Unconfiguring old service [ibm_storage_integration_server]

Installation completed successfully.
  3. If you are using a DS8000 storage array, enter ./ibm_spectrum_control_java_runtime_extension-2.0.0-*.bin to install the required Java components for DS8000.
  4. Review the license agreement which is displayed after you run the installation file.
  5. Enter 1 to accept the license agreement and complete the installation: 
    Press Enter to continue viewing the license agreement, or enter "1" to accept 
the agreement, "2" to decline it, "3" to print it, "4" to read non-IBM terms, 
or "99" to go back.

1

Stopping Django service ... [OK]
Stopping Celery services ... [OK]
Starting DS8000 proxy.....[OK]
Starting Celery services ... [OK]
Starting Django service ... [OK]

Installation completed successfully.
  6. Log in (see GUI – Logging in) and click Settings > About to verify that the Spectrum Control version number has been updated.
    Figure 1. Spectrum Control version number
    This image shows the Spectrum Control version number.
  7. To avoid unauthorized access to Spectrum Control, it is strongly recommended to change the default password for the 'ibmsc' user as soon as possible, as described in CLI – Switching to 'IBMSC' user mode. After the upgrade, Spectrum Control: