On this page:

• 1. Setup The Remote Voicemail And Recording Agent
• 2. Open Communication
  • Open Firewall Ports
  • Asterisk Permit Entry
    • Remote FreePBX Server
    • Remote Vanilla PBX Server
  • iSymphony Server Permit Entry
• 3. Modify The PBX Connection Information
  • • Remote FreePBX Server
    • Remote Vanilla PBX Server

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. 

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 you need to ensure that no firewall, ACL, or other IP access lists, are 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. Replace <HOST> with 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

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. This must be done on the manager login entry, the iSymphony server will be connecting with. If you do not yet have a manager entry on the PBX, for iSymphony, see Asterisk Server (Vanilla) Installation for more information on how to add one. 

   [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"

iSymphony Server Permit Entry

When setting up a remote FreePBX installation, you need to ensure that the iSymphony server will allow the iSymphony module, on the remote FreePBX server, to connect. By default, the iSymphony server will only allow connections from localhost. You will need to modify the security.xml file, on the iSymphony Server, to allow connections from the IP of the remote FreePBX server.

Perform the following steps on the iSymphony Server:

1. Open the file /opt/isymphony3/server/conf/security.xml

2. In the communication_manager SecurityContext, add the IP of the PBX to the IPAccess WhiteList. Replace [HOST] with the IP of the remote PBX. See Security for more information.

           <!-- Security context for the communication manager and REST service -->
           <SecurityContext servlet="communication_manager" enabled="true">
      ...     
                   <IPAccess enabled="true">
                           <WhiteList>
                                   <IP>127.0.0.1</IP>
                                   <IP>0:0:0:0:0:0:0:1</IP>
                                   <IP>[HOST]</IP>
                           </WhiteList>
                           <BlackList>
                           </BlackList>
                   </IPAccess>
           </SecurityContext>
3. Save the file.
4. Restart the iSymphony Server, for the changes to take effect. See Starting And Stopping The iSymphony Server for more information.

3. Modify The PBX Connection Information

You need to ensure that the iSymphony server knows the connection information for the remote PBX. In the case of a FreePBX based remote server, you will also need to ensure that the FreePBX module knows the connection information for the iSymphony Server. 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 Admin->iSympony V3.
3. Set the Server API Host field, to the IP address or hostname of the iSymphony server. This lets the module know how to connect to the iSymphony server.
4. Set the Asterisk Server Host field to the IP address or hostname of the remote PBX. This is normally the IP or hostname, that you utilize to access the FreePBX GUI. This will let the iSymphony server know how to connect to Asterisk.
5. (Optional) If you are attempting to set up an additional Core Server (organization), for a hosted type environment, you will need to set a unique name for the sever in the Server Name field. For all other situations, including a combined PBX setup, leave the Server Name as default.
6. Save and select Apply Config.

Remote Vanilla PBX Server

1. Log into the iSymphony Administration Interface. See Connecting to the Administration Interface for more information.
2. Navigate to Phone System->PBX Connections.
3. Click on add in the top right hand corner of the page.
4. Fill in the connection information based on the manager entry you created for iSymphony. See PBX Connections for more information.
5. Save the PBX connection.