Upgrading an existing installation

If you are already using an earlier release of IBM Spectrum Connect, you can upgrade to the newer version without having to uninstall the previous one.

Before you begin

  • If needed, back up the current Spectrum Control Base or Spectrum Connect database by entering the following command.
    • sc_configuration backup -f /var/tmp/backup -k <key value> for IBM Spectrum Connect.
      Note: The backup and restore procedure is allowed within the same version only. This means that it is not possible to back up files from Spectrum Control Base version 2.2.1 and restore them in version 3.0.3.
  • If you are using RHEL 6.x, upgrade to RHEL 7.x before upgrading Spectrum Connect.
    Important: RHEL 6.x is no longer supported.
  • Verify that the following communication ports are open to ensure network connectivity between VMware resources, Spectrum Connect and IBM storage systems:
    • 8440 (vCenter, vROps and vRO servers)
    • 7778 (FlashSystem A9000/A9000R).
    • 22 (storage systems that run IBM Spectrum Virtualize)
    • 8452 (DS8000)
      Note: The 8443 port remains open after the Spectrum Connect upgrade, if the previous version was configured to use this port. If you install the software package anew, the 8440 port is used. You can change the default TCP port at any time by running a script, as explained in Changing the Spectrum Connect communication port. Moreover, certain upgrade scenarios, such as using SELinux, may require additional configuration steps, as detailed in Performing first-time installation of Spectrum Connect.
  • Make sure that the 'ibmsc' user can access the /opt/ibm and /var/log/sc folders.
  • Verify the version of your current Spectrum Connect installation. IBM Spectrum Control Base Edition versions released before version 3.0.0 cannot be upgraded to version 3.1.0 or later. This includes the IBM Storage Integration Server releases. You must first upgrade the earlier release to version 3.0.3 and restart vSphere Web Client. Then you can upgrade it to version 3.1.0 or later.
    Important: To ensure proper transition from physical to abstracted storage provisioning, refer to the IBM Spectrum Control Base Edition version 3.0.3 "Upgrading an existing installation" procedure.

Procedure

Perform the following procedure to upgrade Spectrum Connect:

  1. Log out of the Spectrum Connect GUI and close the browser.
  2. On the Spectrum Connect side: download the newer installation package and the IBM_Spectrum_Connect_Signing_Key_Pub.key file, used for the package validation. See Downloading IBM Spectrum Connect software).
  3. Copy the installation package and the public key files to a local folder on a current Spectrum Connect server.
  4. Go to the local folder and then use the gpg --import IBM_Spectrum_Connect_Signing_Key_Pub.key to import the IBM® GNU Privacy Guard (GPG) public key to validate the installation files. This ensures that the files were received from IBM and were not manipulated in any way by a third party.
    Note: Downloading the install package from a trusted, SSL-protected resource, such as Fix Central, ensures its authenticity and integrity. However, you can mark the key as trusted by entering gpg --edit-key "IBM Spectrum Connect Signing Key", typing the trust command and selecting option 5.
  5. Extract the installation package file ('* ' represents the build number) :
    # tar -xzvf IBM_Spectrum_Connect-3.8.0-*-x86_64.tar.gz
    Depending on the operating system type, the following files are extracted:
    • RHEL 7.x:
      • erlang-19.3.0-1.el7.centos.x86_64.rpm
      • jemalloc-3.6.0-1.el7.x86_64.rpm
      • nginx-1.10.3-1.el7.ngx.x86_64.rpm
      • postgresql96-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-contrib-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-docs-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-libs-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-server-9.6.17-1PGDG.rhel7.x86_64.rpm
      • rabbitmq-server-3.6.0-1.noarch.rpm
      • redis-3.2.5-1.el7.x86_64.rpm
      • uuid-1.6.2-26.el7.x86_64.rpm
    • CentOS 7.x:
      • erlang-19.3.0-1.el7.centos.x86_64.rpm
      • jemalloc-3.6.0-1.el7.x86_64.rpm
      • libxslt-1.1.28-5.el7.x86_64.rpm
      • nginx-1.10.3-1.el7.ngx.x86_64.rpm
      • postgresql96-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-contrib-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-docs-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-libs-9.6.17-1PGDG.rhel7.x86_64.rpm
      • postgresql96-server-9.6.17-1PGDG.rhel7.x86_64.rpm
      • rabbitmq-server-3.6.0-1.noarch.rpm
      • redis-3.2.5-1.el7.x86_64.rpm
      • uuid-1.6.2-26.el7.x86_64.rpm
    • ibm_spectrum_connect-3.8.0-*.bin – product BIN file.
    • ibm_spectrum_connect-3.8.0-*-x86_64.bin.asc – digital signature file for the BIN file verification.
  6. Enter gpg --verify ibm_spectrum_connect-3.8.0-*-x86_64.bin.asc ibm_spectrum_connect-3.8.0-*-x86_64.bin to verify the digital signature of the installation files.
  7. Go to the extracted directory and then use the rpm -U *.rpm command to run and install all the complementary RPM files.
  8. Enter chmod +x ibm_spectrum_connect-3.8.0-*.bin to authorize the installation of the product BIN file.
  9. Enter ./ibm_spectrum_connect-3.8.0-*.bin to start the upgrade.
    Note: Make sure you login as root, or use sudo for the command.
    Note: During the upgrade several configuration files are overwritten by newer versions (as illustrated by the screen output below). If these files were changed in the previous versions, you must apply the same changes to the new files, if you want to preserve the settings.
  10. Review the license agreement which is displayed after you run the installation file.
  11. Enter 1 at the following prompt 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, "4" to Read non-IBM terms, or "99" to go back.
    
    1
    warning: /tmp/isis-2kvpNq/ibm_spectrum_connect.rpm: Header V4 RSA/SHA1 Signature, key ID 6d5e9449: NOKEY
    Preparing for upgrade to SC 3.8.0
    warning: /opt/ibm/ibm_spectrum_connect/conf.d/hsgsvr/hsgsvr_config.ini saved as /opt/ibm/ibm_spectrum_connect/conf.d/hsgsvr/hsgsvr_config.ini.rpmsave
    Extract Python according to OS version
    Upgrading from Spectrum Connect
    Starting rabbitmq-server (via systemctl):                  [  OK  ]
    Configuring rsyslog
    Configuring new service [ibm_spectrum_connect]
    Upgrading database, this may take a couple of minutes to complete...
    Configuring the nginx port to: 8440.
    No need to change Spectrum Connect port
    Create default settings
    Upgrading the extension of all registered vCenter servers...
    Initiate refresh array task
    Installation completed successfully.
    
  12. Log in (see Logging in) and click Settings > About to verify that the Spectrum Connect version number has been updated.
    Figure 1. Spectrum Connect version number
    This image shows the Spectrum Connect version number.
  13. To avoid unauthorized access to Spectrum Connect via GUI, it is strongly recommended to change the default password for the 'admin' user as soon as possible, as described in Changing the password of a Spectrum Connect user.
    With the Spectrum Connect update, the IBM Storage Enhancements for VMware vSphere Web Client is upgraded automatically for all connected vCenter servers. However, the following components must be updated manually:
    Table 1. Configuration files renamed during Spectrum Connect upgrade
    File name Location
    40-ibmsyslog.conf /etc/rsyslog.d/
    500.html /etc/nginx/conf.d/
    sc_fastcgi_params /etc/nginx/conf.d/
    sc_nginx.conf /etc/nginx/conf.d/