Upgrade Onsite Proxy

When a newer Onsite Proxy release is available, you can move an existing installation up to it directly from the host’s command line. The Onsite Proxy sits on the same local network as your IP phones and relays their traffic to Cloud Voice, so keeping it current makes sure you have the latest fixes and features. The upgrade keeps your current setup intact, so there is no need to reconnect or reconfigure the service afterward.

Caution

An upgrade briefly takes the running Onsite Proxy offline while the new version starts. IP phones that rely on it to reach Cloud Voice can lose service during that short window, so plan the upgrade for a maintenance period or a time when few calls are active.

Before you begin

Confirm that the Onsite Proxy is already installed on the host you want to upgrade.

Upgrade the Onsite Proxy

1. Open a command line session on the host where the Onsite Proxy is running.

2. Switch to the root user by running:

   sudo -i

   Note

   If you are prompted for a password, enter the password for your current user account and press Enter.

3. Download the latest installation package to a directory of your choice. Use the command that matches the host’s CPU architecture (the instruction set of its processor), replacing <download_url> with the download location provided by Cloud Voice and <desired_directory> with the folder where you want the package saved.

   Architecture	Command
   x86_64	wget <download_url>/onsiteproxy-x86_64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz
   ARM64	wget <download_url>/onsiteproxy-aarch64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz

   Tip

   Not sure which architecture the host uses? Run uname -m. A result of x86_64 means use the x86_64 command, and aarch64 means use the ARM64 command.

   For example, to save an x86_64 package to the desktop:

   wget <download_url>/onsiteproxy-x86_64.tar.gz -O /home/user/Desktop/onsiteproxy.tar.gz

4. Start the upgrade by pointing the upgrade command at the package you just downloaded. Replace <your_package_path> with the actual location of the new package:

   onsite-proxy-upgrade <your_package_path>/onsiteproxy.tar.gz

   For the example above, this would be:

   onsite-proxy-upgrade /home/user/Desktop/onsiteproxy.tar.gz

5. When the Onsite Proxy Upgrade window appears, check that the new version shown is correct, then select <Yes> and press Enter.

   Note

   Selecting <No> cancels the upgrade and leaves the current version and settings unchanged.

   

6. Once the Upgrade Complete message appears, press Enter to finish.

   

The Onsite Proxy now runs the new version. All of its previous settings, including connection information and which services are enabled, carry over automatically, so no further configuration is required.