Remote Installations

Version 4.1 by michaely on 2021/09/09 18:01
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

On this page:

When installing the iSymphony Server remotely from the PBX, extra steps need to be taken in order for the iSymphony Server to communicate with the remote PBX.

1. Setup The Remote Voicemail And Recording Agent

In order for the iSymphony server to know about voicemail and recording file activity, on the remote PBX, you must install and configure a Remote Agent on the PBX. See Remote Agents, for information on how to install and configure a Remote Agent. 

The remote agent is not required, however you will not have voicemail or recording management, in browser, if not set up.

2. Open Communication

iSymphony will need a clear path of communication between it and the PBX. Specific ports need to be accessible between the servers, so we need to ensure that no firewall, or IP access list is, blocking communication.

Open Firewall Ports

iSymphony connects to the PBX on TCP port 5038. If using FreePBX, the FreePBX iSymphony module will connect to the the iSymphony Server, on TCP ports 55050, and 58080. These ports must be open on any firewalls, between the servers.

Asterisk Permit Entry

In order for iSymphony to connect to the Asterisk server, you will need to add the IP of the iSymphony server to the manager entry of the remote PBX. How this is done depends on if your remote PBX is based on FreePBX, or not.  

Remote FreePBX Server

Perform these steps on the remote FreePBX install.

  1. Log into FreePBX.
  2. Navigate to Settings->Manager Users->cxpanel.

  3. In the Permit field, append the following to the end, where <HOST> is the IP or hostname of the iSymphony server.

    &<HOST>/255.255.255.255
  4. Ensure that all the read and write permissions are checked.
  5. Save and select Apply Config.

Remote Vanilla PBX Server

Only perform these steps if your remote server is not based on FreePBX.

  1. On the remote server, open the file /etc/asterisk/manager.conf.

  2. Add a permit entry into the iSymphony manager connection that specifies the IP of the iSymphony Server.

    [isymphony]
     secret = mysecret
    deny=0.0.0.0/0.0.0.0
     permit=127.0.0.1/255.255.255.0
     permit=[ip of the iSymphony Server]/255.255.255.255
    read = all
    write = all
  3. Save the file.

  4. Reload the Asterisk manager using the following command.

    asterisk -rx "manager reload"

3. Modify The PBX Connection Information

In order to set up a remote PBX connection, with the iSymphony Server, you need to configure the iSymphony Server with the connection information of the PBX. In the case of a remote FreePBX installation, you will also need to configure the iSymphony FreePBX module, with the connection information of the iSymphony Server. The additional connection information, in the FreePBX module, will allow the module to synchronize the configuration, between FreePBX and the iSymphony Server.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

Vanilla Asterisk

  1. Open the file /etc/asterisk/manager.conf on the PBX.

  2. Add a permit entry into the iSymphony manager connection that specifies the IP of the iSymphony Server and save the file.

    [isymphony]
     secret = mysecret
    deny=0.0.0.0/0.0.0.0
     permit=127.0.0.1/255.255.255.0
     permit=[ip of the iSymphony Server]/255.255.255.255
    read = all
    write = all

  3. Reload the Asterisk manager using the following command.

    asterisk -rx "manager reload"
  4. Log into the iSymphony Administration Interface. See Connecting to the Administration Interface for more information.
  5. Navigate to the settings for your PBX Connection and set the Host field to the IP or hostname of the remote PBX. This will tell iSymphony how to connect to the remote PBX. See PBX Connections for more information.

FreePBX

  1. Open the file /opt/isymphony3/server/conf/security.xml on the iSymphony Server.
  2. In the communication_manager SecurityContext add the IP of the PBX to the IPAccess WhiteList. See Security for more information.
  3. Restart the iSymphony Server. See Starting And Stopping The iSymphony Server for more information.
  4. Log into FreePBX.

  5. Navigate to Settings->Asterisk API/Manager Users->cxpanel and add a permit entry for the IP of the iSymphony Server by appending the following to end of the contents of the Permit section and save the configuration.

    &<IP of the iSymphony Server>/255.255.255.255
  6. Navigate to the iSymphony FreePBX Module page. See FreePBX Module Administration for more information.

  7. If you are adding an additional PBX to your iSymphony Server instance make sure to change the Server Name property under Server Settings to something other than default. If you only have one PBX you can leave this value as default. See Core Servers for more information.

    Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

  8. Modify the Server API Host field under Server Settings to the IP or hostname of the iSymphony Server. This tells the iSymphony FreePBX Module how to connect to the iSymphony Server.
  9. Modify the Asterisk Server Host field to the IP or hostname of the PBX. this tells the iSymphony Server how to connect to Asterisk.
  10. Modify the Client Host field to the IP or hostname of the iSymphony Server. This value is used to construct the URL to point to the iSymphony Client Interface. See FreePBX Module Administration for more information.
  11. Save the configuration and Apply Config in FreePBX.
   

Search

Navigation

iSymphony