Changes for page Remote Installations

Last modified by ryanp on 2021/09/09 20:55
<
From version < 4.1 >
edited by michaely
on 2021/09/09 18:01
To version < 5.1 >
edited by michaely
on 2021/09/09 18:01
>
Change comment: Import

Summary

Details

Page properties
Content
... ... @@ -16,7 +16,7 @@
16 16  
17 17  = 2. Open Communication =
18 18  
19 -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.
19 +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.
20 20  
21 21  == Open Firewall Ports ==
22 22  
... ... @@ -33,7 +33,7 @@
33 33  1. Log into FreePBX.
34 34  1. Navigate to **Settings->Manager Users->cxpanel.**
35 35  1. (((
36 -In the **Permit** field, append the following to the end, where **<HOST> **is the IP or hostname of the iSymphony server.
36 +In the **Permit** field, append the following to the end. Replace **<HOST>** with the IP or hostname of the iSymphony server.
37 37  
38 38  {{code}}
39 39  &<HOST>/255.255.255.255
... ... @@ -45,12 +45,12 @@
45 45  === **Remote Vanilla PBX Server** ===
46 46  
47 47  {{info}}
48 -Only perform these steps if your remote server is **not **based on FreePBX.
48 +Only perform these steps if your remote PBX is **not **based on FreePBX.
49 49  {{/info}}
50 50  
51 51  1. On the remote server, open the file **/etc/asterisk/manager.conf**.
52 52  1. (((
53 -Add a permit entry into the iSymphony manager connection that specifies the IP of the iSymphony Server.
53 +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 [[doc:Asterisk Server (Vanilla) Installation]] for more information on how to add one.
54 54  
55 55  {{code}}
56 56  [isymphony]
... ... @@ -71,64 +71,62 @@
71 71  {{/code}}
72 72  )))
73 73  
74 -= 3. Modify The PBX Connection Information =
74 +== iSymphony Server Permit Entry ==
75 75  
76 -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.
76 +{{info}}
77 +Only perform these steps if your remote PBX is FreePBX based.
78 +{{/info}}
77 77  
78 -{{note}}
79 -Make sure that a firewall is not blocking communication on TCP ports **5038**, **55050,** and **58080,** between the PBX and the iSymphony Server.
80 +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.
80 80  
81 -Port **5038 **is used by iSymphony to communicate with the Asterisk server. Ports **55050** and **58080** are used, by the FreePBX module, to synchronize configuration between FreePBX and the iSymphony Server. Vanilla Asterisk installations do not need to have **55050,** or **58080,** open to the remote PBX.
82 -{{/note}}
82 +Perform the following steps on the iSymphony Server:
83 83  
84 -=== Vanilla Asterisk ===
85 -
86 -1. Open the file **/etc/asterisk/manager.conf** on the PBX.
84 +1. Open the file **/opt/isymphony3/server/conf/security.xml**
87 87  1. (((
88 -Add a permit entry into the iSymphony manager connection that specifies the IP of the iSymphony Server and save the file.
86 +In the **communication_manager** SecurityContext, add the IP of the PBX to the IPAccess **WhiteList**. Replace **[HOST]** with the IP of the remote PBX. (% style="line-height: 1.4285715;" %)See [[doc:Security]] for more information.
89 89  
90 -{{code}}
91 -[isymphony]
92 - secret = mysecret
93 - deny=0.0.0.0/0.0.0.0
94 - permit=127.0.0.1/255.255.255.0
95 - permit=[ip of the iSymphony Server]/255.255.255.255
96 - read = all
97 - write = all
88 +{{code language="xml"}}
89 + <!-- Security context for the communication manager and REST service -->
90 + <SecurityContext servlet="communication_manager" enabled="true">
91 + ...
92 + <IPAccess enabled="true">
93 + <WhiteList>
94 + <IP>127.0.0.1</IP>
95 + <IP>0:0:0:0:0:0:0:1</IP>
96 + <IP>[HOST]</IP>
97 + </WhiteList>
98 + <BlackList>
99 + </BlackList>
100 + </IPAccess>
101 + </SecurityContext>
98 98  {{/code}}
99 99  )))
100 -1. (((
101 -Reload the Asterisk manager using the following command.
104 +1. Save the file.
105 +1. Restart the iSymphony Server, for the changes to take effect. See [[doc:Starting And Stopping The iSymphony Server]] for more information.
102 102  
103 -{{code language="bash"}}
104 -asterisk -rx "manager reload"
105 -{{/code}}
106 -)))
107 -1. Log into the iSymphony Administration Interface. See [[doc:Connecting to the Administration Interface]] for more information.
108 -1. 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 [[doc:PBX Connections]] for more information.
107 += 3. Modify The PBX Connection Information =
109 109  
110 -=== FreePBX ===
109 +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.
111 111  
112 -1. Open the file **/opt/isymphony3/server/conf/security.xml** on the iSymphony Server.
113 -1. In the **communication_manager** **SecurityContext** add the IP of the PBX to the **IPAccess** **WhiteList**. See [[doc:Security]] for more information.
114 -1. Restart the iSymphony Server. See [[doc:Starting And Stopping The iSymphony Server]] for more information.
111 +=== Remote FreePBX Server ===
112 +
113 +Perform these steps on the remote FreePBX install.
114 +
115 115  1. Log into FreePBX.
116 -1. (((
117 -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.
116 +1. Navigate to **Admin->iSympony V3**.
117 +1. 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.
118 +1. 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.
119 +1. (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**.
120 +1. Save and select **Apply Config**.
118 118  
119 -{{code}}
120 -&<IP of the iSymphony Server>/255.255.255.255
121 -{{/code}}
122 -)))
123 -1. Navigate to the iSymphony FreePBX Module page. See [[doc:FreePBX Module Administration]] for more information.
124 -1. (((
125 -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 [[doc:Core Servers]] for more information.
122 +=== **Remote Vanilla PBX Server** ===
126 126  
127 -{{note}}
128 -If you have two FreePBX instances with one iSymphony Server instance and both FreePBX instances have the same value for the **Server Name** property the two modules will conflict when trying to write out their configuration to the server.
129 -{{/note}}
130 -)))
131 -1. 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.
132 -1. Modify the **Asterisk Server Host** field to the IP or hostname of the PBX. this tells the iSymphony Server how to connect to Asterisk.
133 -1. 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 [[doc:FreePBX Module Administration]] for more information.
134 -1. Save the configuration and **Apply Config** in FreePBX.
124 +{{info}}
125 +Only perform these steps if your remote PBX is **not **based on FreePBX.
126 +{{/info}}
127 +
128 +1. Log into the iSymphony Administration Interface. See [[doc:Connecting to the Administration Interface]] for more information.
129 +1. Navigate to **Phone System->PBX Connections**.
130 +1. Click on **add** in the top right hand corner of the page.
131 +1. Fill in the connection information based on the manager entry you created for iSymphony. See [[doc:PBX Connections]] for more information.
132 +1. Save the PBX connection.

Search

Navigation

iSymphony