Uninstall Onsite Proxy

The Onsite Proxy runs on a host in the same subnet (local network segment) as your IP phones (desk phones that register over the network) and relays their traffic to Cloud Voice. When you no longer need it on a host, for example after decommissioning that site or moving the phones onto a different connection, you can remove it completely with the packaged uninstall command. The steps below walk through running that command and confirming the removal.

Before you begin

Make sure the Onsite Proxy is already installed on the host you plan to clean up. If the uninstall command is not found, the proxy was likely never installed on this host, or you are on the wrong machine.

Remove the Onsite Proxy

Danger

Uninstalling the Onsite Proxy stops it from relaying traffic between the local IP phones and Cloud Voice. Any phone that reaches Cloud Voice through this proxy loses its connection and cannot place or receive calls, including emergency (E911) calls, until it connects through another path. Only run this on a host you are certain is no longer serving live phones.

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

2. Switch to the root user (the administrator account with full system access) by running:

   sudo -i

   Note

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

3. Start the uninstaller by running:

   onsite-proxy-uninstall

   The Onsite Proxy Uninstallation window opens.

4. Select <Yes> and press Enter to confirm.

   

   Caution

   This is the point of no return. Once you confirm, the proxy is removed and the phones that depend on it drop offline. To bring the service back you have to install it again from scratch.

5. When the Uninstallation Complete message appears, press Enter to finish.

   

   Tip

   If you need the proxy again later on this host, you do not have to recover anything: just follow the install guide to set it up fresh.