Link Search Menu Expand Document

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.

  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/ <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:

  1. From Orchestrator SSH shell console, enter the following: mv /bin/scp-local /bin/scp #

  2. From your local PC console, enter the following: scp <Orchestrator Installation file> admin@<orchestrator_ip_address>:/home/gms

  3. From the Orchestrator SSH shell console, enter the following: /home/gms/gms/setup/ <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.

  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 Aruba support.

Next Steps

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

Back to top

© Copyright 2024 Hewlett Packard Enterprise Development LP.

To view the end-user software agreement, go to HPE Aruba Networking EULA.

Open Source Code:

This product includes code licensed under certain open source licenses which require source compliance. The corresponding source for these components is available upon request. This offer is valid to anyone in receipt of this information and shall expire three years following the date of the final distribution of this product version by Hewlett Packard Enterprise Company. To obtain such source code, please check if the code is available in the HPE Software Center at but, if not, send a written request for specific software version and product for which you want the open source code. Along with the request, please send a check or money order in the amount of US $10.00 to:

Hewlett Packard Enterprise Company
Attn: General Counsel
WW Corporate Headquarters
1701 E Mossy Oaks Rd Spring, TX 77389
United States of America