Wiki source code of Remote Installations

Last modified by ryanp on 2021/09/09 20:55

version	line-number	content
12.1	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.
7.1	5
12.1	6	= 1. Setup The Remote Voicemail And Recording Agent =
7.1	7
12.1	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}}
7.1	10
12.1	11	{{layout-cell}}
	12	{{panel title="On this page:"}}
1.1	13
	14
12.1	15	{{toc maxLevel="2" indent="1"/}}
	16	{{/panel}}
	17	{{/layout-cell}}
	18	{{/layout-section}}
1.1	19
12.1	20	{{layout-section ac:type="single"}}
	21	{{layout-cell}}
1.1	22	{{info}}
12.1	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.
1.1	24	{{/info}}
	25
12.1	26	= (% style="color: rgb(0,0,0);" %)2. Open Communication(%%) =
1.1	27
12.1	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.
6.1	29
9.1	30	== Open Firewall Ports ==
	31
12.1	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.
1.1	33
3.1	34	== Asterisk Permit Entry ==
	35
12.1	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.
3.1	37
	38	=== Remote FreePBX Server ===
	39
12.1	40	Perform these steps on the remote FreePBX install:
3.1	41
	42	1. Log into FreePBX.
	43	1. Navigate to Settings->Manager Users->cxpanel.
1.1	44	1. (((
9.1	45	In the Permit field, append the following to the end. Replace <HOST> with the IP or hostname of the iSymphony server.
1.1	46
	47	{{code}}
3.1	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}}
9.1	57	Only perform these steps if your remote PBX is not based on FreePBX.
3.1	58	{{/info}}
	59
9.1	60	1. On the remote server, open the file /etc/asterisk/manager.conf.
3.1	61	1. (((
12.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.
3.1	63
	64	{{code}}
1.1	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
13.1	72	writetimeout = 3000
	73	eventfilter=!Event: RTCPSent
	74	eventfilter=!Event: RTCPReceived
	75	eventFilter=!Event: CEL
1.1	76	{{/code}}
	77	)))
9.1	78	1. Save the file.
1.1	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
9.1	87	== iSymphony Server Permit Entry ==
1.1	88
9.1	89	{{info}}
	90	Only perform these steps if your remote PBX is FreePBX based.
	91	{{/info}}
	92
12.1	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.
9.1	94
	95	Perform the following steps on the iSymphony Server:
	96
	97	1. Open the file /opt/isymphony3/server/conf/security.xml
1.1	98	1. (((
9.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.
1.1	100
9.1	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>
1.1	115	{{/code}}
	116	)))
9.1	117	1. Save the file.
12.1	118	1. Restart the iSymphony Server for the changes to take effect. See [[doc:Starting And Stopping The iSymphony Server]] for more information.
1.1	119
9.1	120	= 3. Modify The PBX Connection Information =
	121
12.1	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.
9.1	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.
12.1	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.
9.1	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.
12.1	148	{{/layout-cell}}
	149	{{/layout-section}}
	150	{{/layout}}

Wiki source code of Remote Installations

Search

Navigation