Upgrading the Smart Hub silently


You can upgrade the Smart Hub silently.

NEW IN 20.02.01 The Smart Hub installer includes an additional optional component called the Smart Hub Gateway. If you want to manage the servers in private networks (in on-premises or cloud environments such as AWS) where inbound connectivity with the RSCD Agents is not available, you must install the Smart Hub Gateway.

Important note for Windows Smart Hub

TrueSight Server Automation 21.02 no longer supports the Redis Server embedded with the Smart Hub on a Windows system. If you are already using the Redis Server that was embedded with Smart Hub 20.02.01 or 20.02, you must migrate data to the Redis Server installed on a Linux system in your environment. For the migration instructions, see Migrating-the-Smart-Hub-and-Redis-Server-data.

To upgrade the Smart Hub

Do the following:

  1. Log in to the system where you want to upgrade the Smart Hub.
    • (Windows) Log in as an administrator.
    • (UNIX and Linux) Log in as a root user.
  2. Extract the Smart Hub installer files to a directory of your choice.
    • (Windows) Extract SMARTHUB<version>-WIN64.zip
    • (Linux) Extract SMARTHUB<version>-LIN64.zip
  3. Navigate to the directory that contains extracted files.

  4. Run the following command:

    • (Windows) 

      ./setup.bat --silent --upgrade --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080 --migration-completed --ca-cert-subject <value> --server-cert-subject <value>

      For example:

      ./setup.bat --silent --upgrade --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080 --migration-completed --ca-cert-subject --ca-cert-subject /C=US/ST=TX/L=Austin/O=Calbro Software/OU=root/CN=Smart Hub CA:%HOST% --server-cert-subject /C=US/ST=TX/L=Houston/O=BMC Software/OU=server/CN=%HOST%

    • (UNIX and Linux)

      ./setup.sh --silent --upgrade --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080 --ca-cert-subject <value> --server-cert-subject <value>

      For example:

      ./setup.sh --silent --upgrade --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080 --ca_cert_subject /C=US/ST=TX/L=Austin/O=Calbro Software/OU=root/CN=Smart Hub CA:%HOST% --server_cert_subject /C=US/ST=TX/L=Houston/O=BMC Software/OU=server/CN=%HOST%

    where, 
    -- silent indicates accepting the end user license agreement and proceeding with the silent installation.
    -- upgrade indicates upgrading the Smart Hub. 
    -- install-upgrade-smarthub-gateway indicates installing or upgrading the Smart Hub Gateway. The Smart Hub Gateway is upgraded when the previously installed Smart Hub Gateway version is lower than the current Smart Hub Gateway version. 
    --migration-completed indicates that you completed migrating data from the embedded Redis Server to another Redis Server installed on a Linux system. You must include this flag. Otherwise, the upgrade cannot proceed. 
    --ca-cert-subject indicates the values used for generating the CA-signer certificate. The default is /C=US/ST=TX/L=Houston/O=BMC Software/OU=root/CN=Smart Hub CA:%HOST%.
    --server-cert-subject indicates the values used to generating the Smart Hub server certificate. The default is /C=US/ST=TX/L=Houston/O=BMC Software/OU=server/CN=%HOST%.

    Important

    If in the existing installation, the values provided to generate the CA-signer certificate and the Smart Hub server certificate match, you are prompted to regenerate the Smart Hub server certificate with different values. Regenerate the certificate and run the command again.

  5. Verify that the Smart Hub and Smart Hub Gateway is up and running:
    • (Windows)
      1. On the search bar, enter services.msc.
      2. Verify that the following services are running:
        • TrueSight Server Automation Smart Hub
        • TrueSight Server Automation Smart Hub Gateway
    • (Linux) Run the following commands to view the status of Smart Hub and Smart Hub Gateway:
      • systemctl status smarthub.service
      • systemctl status smarthub.gateway.service

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*