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
If you are using on-prem Orchestrator 8.6.0 or later and want to upgrade to a newer version, complete the following steps. Use this same procedure to upgrade stats collectors.
WARNING: An upgrade that fails can cause Orchestrator to be in a corrupt state. Back up Orchestrator before you start the upgrade process.
-
Create an SSH shell to Orchestrator.
-
Open an SSH session to Orchestrator.
-
Log in as admin or a user with administrator privileges.
-
Switch to root:
su - root
-
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.
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.
From the Orchestrator SSH console, enter the following as root:
-
From Orchestrator SSH shell console, enter the following:
mv /bin/scp-local /bin/scp #
-
From your local PC console, enter the following:
scp <Orchestrator Installation file> admin@<orchestrator_ip_address>:/home/gms
-
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.
Upgrade Orchestrator in the Cloud
Complete the following steps to upgrade Orchestrator in the cloud.
-
Using Orchestrator in the cloud, navigate to Orchestrator > Software & Setup > Upgrade > Upgrade Orchestrator.
The Upgrade Orchestrator dialog box opens.
-
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.
-
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.