Configure Connection Information

Use this procedure to point the Onsite Proxy at your Cloud Voice PBX (Private Branch Exchange, the hosted phone system). It applies whenever you need to establish a fresh link, including the first connection after you skipped the setup wizard while installing the proxy. The connection details are entered through a terminal-based wizard that runs directly on the proxy host.

Prerequisites

Before you begin, add an Onsite Proxy instance on your Cloud Voice PBX so that the PBX generates the credentials this wizard needs: the connection address, UUID (Universally Unique Identifier, the unique ID for this proxy instance), and secret key. You can view them in the PBX portal at System > Onsite Proxy > Edit > Connection information.

Step 1. Run the configuration wizard on the Onsite Proxy

Open a terminal session on the Onsite Proxy host.
Switch to the root account:
Terminal window
```
sudo -i
```
When prompted, type the password for your current user and press Enter.
Launch the wizard:
Terminal window
```
onsite-proxy-configure
```
The Onsite Proxy Configuration Wizard opens in a prompt window.
Press Enter at the opening prompt to start.
Work through each connection setting in turn, using the values you copied from the PBX.

PBX connection address
1. In the Configure PBX Connection Address window, paste the connection address you obtained from the PBX, then select <Ok> and press Enter.
2. In the Confirm Connection Address window, select <Yes> and press Enter.
UUID
1. In the Configure UUID window, paste the UUID from the PBX, then select <Ok> and press Enter.
2. In the Confirm UUID window, select <Yes> and press Enter.
Secret key
1. In the Configure Secret Key window, paste the secret key from the PBX, then select <Ok> and press Enter.
2. In the Confirm Secret Key window, select <Yes> and press Enter.
PBX external web server port

The web server port and the tunnel port arrive pre-filled from your PBX, so there is nothing to paste for these two steps. In most cases you simply confirm the values shown. Change them only if your network uses non-default ports.
1. In the Configure PBX External Web Server Port window, select <Ok> and press Enter.
2. In the Confirm PBX External Web Server Port window, select <Yes> and press Enter.
PBX external tunnel port
1. In the Configure PBX External Tunnel Port window, select <Ok> and press Enter.
2. In the Confirm PBX External Tunnel Port window, select <Yes> and press Enter.
Local IP
1. In the Select Local IP window, choose the static IP (Internet Protocol) address assigned to the host.
  
  If the address you want is missing from the Available network interfaces list, select manual and press Enter, then type the IP address by hand.
2. Select <Ok> and press Enter.
3. In the Confirm Local IP window, select <Yes> and press Enter.
Review everything in the Configuration Summary window. When the details are correct, select <Yes> and press Enter.
At the Verification Successful prompt, press Enter.
At the Configuration Complete prompt, press Enter.

Step 2. Restart the proxy services

Apply the new configuration by restarting both services:

Restart the tunnel forwarding service:
Terminal window
```
systemctl restart proxycore.service
```
Restart the tunnel status reporting service:
Terminal window
```
systemctl restart proxycron.service
```

Result

The Onsite Proxy is now connected to your Cloud Voice PBX. Confirm the link in either of these ways:

On the Onsite Proxy host, run onsiteproxy-cli status. For details on reading the output, see Query client status.
In the PBX portal, review the status under System > Onsite Proxy.