Child pages
  • Remote Installations

This documentation relates to iSymphony 3.5. You can view older documentation on the Older Documentation page

Skip to end of metadata
Go to start of metadata

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. 

On this page:

 

The remote agent is not required, but you will not be able to manage voicemail or recordings in iSymphony if it is 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 you need to ensure that no firewall, ACL, or other IP access lists are blocking communication on the required ports.

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 whether 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

Only perform these steps if your remote PBX 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. This must be done on the manager login entry that 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
     writetimeout = 3000
     eventfilter=!Event: RTCPSent
     eventfilter=!Event: RTCPReceived
     eventFilter=!Event: CEL
  3. Save the file.
  4. Reload the Asterisk manager using the following command.

    asterisk -rx "manager reload"

iSymphony Server Permit Entry

Only perform these steps if your remote PBX is FreePBX based.

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 whether 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. Set the Module Client Link Settings Host field to the value used for Asterisk Server Host.
  6. Set the Module Client Link Settings Port field to 58080 if SSL is disabled; set to 55050 if SSL is enabled.
  7. (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. See Core Servers and PBX Connections for more information.
  8. Save and select Apply Config.

Remote Vanilla PBX Server

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

  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.