Wiki source code of Remote Installations

Last modified by ryanp on 2021/09/09 20:55
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_equal"}}
3 {{layout-cell}}
4 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.
5
6 = 1. Setup The Remote Voicemail And Recording Agent =
7
8 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 [[doc:Remote Agents]] for information on how to install and configure a Remote Agent.
9 {{/layout-cell}}
10
11 {{layout-cell}}
12 {{panel title="On this page:"}}
13
14
15 {{toc maxLevel="2" indent="1"/}}
16 {{/panel}}
17 {{/layout-cell}}
18 {{/layout-section}}
19
20 {{layout-section ac:type="single"}}
21 {{layout-cell}}
22 {{info}}
23 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.
24 {{/info}}
25
26 = (% style="color: rgb(0,0,0);" %)2. Open Communication(%%) =
27
28 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.
29
30 == Open Firewall Ports ==
31
32 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.
33
34 == Asterisk Permit Entry ==
35
36 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.
37
38 === Remote FreePBX Server ===
39
40 Perform these steps on the remote FreePBX install:
41
42 1. Log into FreePBX.
43 1. Navigate to **Settings->Manager Users->cxpanel.**
44 1. (((
45 In the **Permit** field, append the following to the end. Replace **<HOST>** with the IP or hostname of the iSymphony server.
46
47 {{code}}
48 &<HOST>/255.255.255.255
49 {{/code}}
50 )))
51 1. Ensure that all the **read **and **write** permissions are checked.
52 1. Save and select** Apply Config.**
53
54 === **Remote Vanilla PBX Server** ===
55
56 {{info}}
57 Only perform these steps if your remote PBX is **not **based on FreePBX.
58 {{/info}}
59
60 1. On the remote server, open the file **/etc/asterisk/manager.conf**.
61 1. (((
62 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 [[doc:Asterisk Server (Vanilla) Installation]] for more information on how to add one.
63
64 {{code}}
65 [isymphony]
66 secret = mysecret
67 deny=0.0.0.0/0.0.0.0
68 permit=127.0.0.1/255.255.255.0
69 permit=[ip of the iSymphony Server]/255.255.255.255
70 read = all
71 write = all
72 writetimeout = 3000
73 eventfilter=!Event: RTCPSent
74 eventfilter=!Event: RTCPReceived
75 eventFilter=!Event: CEL
76 {{/code}}
77 )))
78 1. Save the file.
79 1. (((
80 Reload the Asterisk manager using the following command.
81
82 {{code language="bash"}}
83 asterisk -rx "manager reload"
84 {{/code}}
85 )))
86
87 == iSymphony Server Permit Entry ==
88
89 {{info}}
90 Only perform these steps if your remote PBX is FreePBX based.
91 {{/info}}
92
93 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.
94
95 Perform the following steps on the iSymphony Server:
96
97 1. Open the file **/opt/isymphony3/server/conf/security.xml**
98 1. (((
99 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.
100
101 {{code language="xml"}}
102 <!-- Security context for the communication manager and REST service -->
103 <SecurityContext servlet="communication_manager" enabled="true">
104 ...
105 <IPAccess enabled="true">
106 <WhiteList>
107 <IP>127.0.0.1</IP>
108 <IP>0:0:0:0:0:0:0:1</IP>
109 <IP>[HOST]</IP>
110 </WhiteList>
111 <BlackList>
112 </BlackList>
113 </IPAccess>
114 </SecurityContext>
115 {{/code}}
116 )))
117 1. Save the file.
118 1. Restart the iSymphony Server for the changes to take effect. See [[doc:Starting And Stopping The iSymphony Server]] for more information.
119
120 = 3. Modify The PBX Connection Information =
121
122 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.
123
124 === Remote FreePBX Server ===
125
126 Perform these steps on the remote FreePBX install.
127
128 1. Log into FreePBX.
129 1. Navigate to **Admin->iSympony V3**.
130 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.
131 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.
132 1. Set the **Module Client Link Settings Host** field to the value used for **Asterisk Server Host**.
133 1. Set the **Module Client Link Settings Port** field to 58080 if SSL is disabled; set to 55050 if SSL is enabled.
134 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**. See [[doc:Core Servers]] and [[doc:PBX Connections]] for more information.
135 1. Save and select **Apply Config**.
136
137 === **Remote Vanilla PBX Server** ===
138
139 {{info}}
140 Only perform these steps if your remote PBX is **not **based on FreePBX.
141 {{/info}}
142
143 1. Log into the iSymphony Administration Interface. See [[doc:Connecting to the Administration Interface]] for more information.
144 1. Navigate to **Phone System->PBX Connections**.
145 1. Click on **add** in the top right hand corner of the page.
146 1. Fill in the connection information based on the manager entry you created for iSymphony. See [[doc:PBX Connections]] for more information.
147 1. Save the PBX connection.
148 {{/layout-cell}}
149 {{/layout-section}}
150 {{/layout}}

Search

Navigation

iSymphony