Upgrade Orchestrator or Stats Collectors

You can upgrade Orchestrator software for an on-prem installation or stats collector or an installation in the cloud.

Upgrade On-Prem Orchestrator or Stats Collector

Upgrading an on-prem Orchestrator: If you are upgrading an on-prem Orchestrator 8.6.0 or later to a version earlier than 9.6.0, complete the following steps.

Upgrading a Stats Collector:

  • If you are upgrading a Stats Collector running 8.6.0 through 9.5.x to a version earlier than 9.6.0, use this same procedure to upgrade stats collectors.

  • If you are upgrading a Stats Collector from 8.6.0 through 9.5.x to 9.6.0 or later, be sure to read the following important notice.

IMPORTANT: If you are upgrading to Orchestrator 9.6.0 or later, your statistics data will not be migrated automatically from the Distributed Stats Collector to the new Stats Collector that runs on a single virtual instance. Do not upgrade to Orchestrator 9.6.0 or later if you do not want to migrate to the new Stats Collector. If you want to migrate your existing statistics data to the new Stats Collector beginning with Orchestrator 9.6.0, see Migrate Stats Collectors to 9.6.0 On-Prem Orchestrator .

WARNING: An upgrade that fails can cause Orchestrator to be in a corrupt state. Back up Orchestrator before you start the upgrade process.

  1. Create an SSH shell to Orchestrator.

  2. Open an SSH session to Orchestrator.

  3. Log in as admin or a user with administrator privileges.

  4. Switch to root: su - root

  5. Enter cd /home

Depending on your environment, you can upgrade Orchestrator in either of the following ways:

NOTE: Upgrading via SCP is only available for versions 8.10.20 and later.

Upgrade via HTTP

If you have an HTTP URL to the Orchestrator installation file, enter the following in the existing SSH console to run the install script and point it to the hosted installation file:

/home/gms/gms/setup/install_orchestrator.sh <HTTP URL of the Orchestrator Installation File>

NOTE: The upgrade process can take several hours to complete.

If you are migrating to on-prem Orchestrator 9.6.0 or later, go to Migrate Stats Collectors to 9.6.0 On-Prem Orchestrator and complete the steps to migrate your stats collector data.

Upgrade via SCP

If you don’t have an HTTP server, copy the Orchestrator installation file to Orchestrator by using SCP, run the install script, and point it to the local installation file.

NOTE: This procedure assumes that the SCP programs on both ends are patched for CVE-2020-15778 and/or you trust the remote server from which you will SCP the installation file.

To upgrade your Orchestrator via SCP:

  1. Determine whether your VM is running Rocky Linux or Cent OS. SSH into the VM, and then run cat /etc/redhat-release

  2. If your VM is running Rocky Linux, go to step 4.

  3. If your VM is running on CentOS, enter the following: mv /bin/scp-local /bin/scp # from Orchestrator SSH shell console.

  4. From your local PC console, enter the following:

    scp <Orchestrator Installation file> admin@<orchestrator_ip_address>:/home/gms

  5. From the Orchestrator SSH shell console, enter the following:

    /home/gms/gms/setup/install_orchestrator.sh <full_path_to_Orchestrator_Installation_file>

NOTE: The upgrade process can take several hours to complete.

If you are migrating to on-prem Orchestrator 9.6.0 or later, go to Migrate Stats Collectors to 9.6.0 On-Prem Orchestrator and complete the steps to migrate your stats collector data.

Upgrade Orchestrator in the Cloud

Complete the following steps to upgrade Orchestrator in the cloud.

  1. Using Orchestrator in the cloud, navigate to Orchestrator > Software & Setup > Upgrade > Upgrade Orchestrator.

    The Upgrade Orchestrator dialog box opens.

  2. Click in the Select Version field to display a drop-down list of Orchestrator versions you can upgrade to, and then select the appropriate version.

  3. Click Upgrade.

    You will receive an email message indicating that the Orchestrator version upgrade has started. Orchestrator service is not available during the upgrade process. When the process completes, you will receive another message indicating that the upgrade was successful. If a failure occurs, however, you will receive a failure message with instructions to contact HPE Aruba Networking support.

Next Steps

After you install or upgrade Orchestrator, you need to configure appliances. For information on configuring appliances, see Appliance Configuration Wizard.