Last modified by Scott Gagan on 2021/09/10 22:35
Show last authors
1 What's on this page:
2
3
4
5 {{toc/}}
6
7 {{info}}
8 These instructions are for an installation on a FreePBX based system. If you have a non-FreePBX based system see the [[doc:Asterisk Server (Vanilla) Installation]] section.
9 {{/info}}
10
11 = Before you start =
12
13 Please check the following points:
14
15 1. Ensure that your system meets the minimum requirements to run iSymphony. For more information, please read the detailed [[system requirements>>doc:ISYM28.System Requirements]].
16 1. Have your iSymphony license key ready. You can [[obtain a trial, free or commercial license>>doc:iSymphony 2\.8 Documentation.iSymphony Installation and Update Guide.Getting an iSymphony License.WebHome]] now, or [[retrieve your existing license key>>url:https://www.getisymphony.com/isymphonyregister/||shape="rect"]].
17 1. You must be able to use a command prompt and install Java to continue. If not, please contact your system administrator to assist you.
18
19 * Asterisk 1.4 or higher
20 * FreePBX v2.5 or higher
21 * FreePBX Asterisk API module v2.5.0.2 or higher
22 * Sun Java JRE v1.6 or higher. ~[[[**http:~~/~~/www.java.com**>>url:http://www.java.com/||shape="rect"]]]
23 * iSymphony FreePBX module v1.0.8 or higher
24
25 = Install the JRE (Java Runtime Environment) =
26
27 {{info}}
28 **iSymphony requires Java 6 (JRE 1.6) or later**
29 iSymphony needs JRE 1.6 or newer to be installed on your computer.
30 {{/info}}
31
32 {{note}}
33 OpenJDK is currently **not** supported.
34 {{/note}}
35
36 1. If you are not sure whether you have JRE installed correctly, please confirm by doing the following:
37 11. Open a shell console.
38 11. Type echo $JAVA_HOME in the shell console and then press Enter
39 11. View the result:
40 11*. If a line is displayed such as /opt/jre1.6.0_12 or /usr/lib/jvm/java-6-sun, then your JRE is installed and properly configured.
41 11*. If nothing is displayed, then you either need to install the JRE or set the $JAVA_HOME environment variable. You can set this environment variable in your user account's 'profile' file. Alternatively, you can set this after installing iSymphony by defining this path in your iSymphony installation's config.sh file, usually located in the iSymphony directory.
42 1. If you need to install the JRE, follow these instructions:
43 1*. Go to the [[Java download page>>url:http://www.oracle.com/technetwork/java/javase/downloads/index.html||shape="rect"]].
44 1*. Download the version entitled 'JRE 6 Update XX', where 'XX' stands for some number. (The latest version is available on that page.)
45 1*. When the download has finished, run the Java installer. Detailed installation instructions are provided on [[Oracle's website>>url:http://www.oracle.com/technetwork/java/javase/index-137561.html||shape="rect"]].
46 At one point, you will be asked to choose an installation directory. Make a note of this directory for use later.
47
48 {{id name="download"/}}
49
50 = Server Installation =
51
52 1. (((
53 Once you have downloaded the iSymphony RPM run the following command to install:
54
55 |(((
56 rpm -Uvh iSymphonyServer**//<version>//**.rpm
57 )))
58 )))
59 1. (((
60 Configure the iSymphony installation. iSymphony assumes your Sun Java JRE is located in **/usr/java/latest/ **by default. If your Sun Java JRE is in a different location you must run the following commands and set the correct path.
61
62 |(((
63 /opt/isymphony/server/config.sh
64 )))
65 )))
66 1. (((
67 Start the iSymphony server:
68
69 |(((
70 /opt/isymphony/server/startup.sh
71 )))
72 )))
73 1. (((
74 Verify that ports 50000 and 50003 are not being blocked by any firewall and are forwarded as necessary. If you are running IP Tables (installed and activated by default on PBXIAF) run the following commands on the server CLI in order to open the ports.
75
76 {{noformat}}
77 iptables -L
78 iptables -A INPUT -p tcp -m tcp --dport 50000 -j ACCEPT
79 iptables -A INPUT -p tcp -m tcp --dport 50003 -j ACCEPT
80 service iptables save
81
82 {{/noformat}}
83
84 {{note title="Firewall Details"}}
85 Please note that the above command will open the iSymphony ports to the world. As iSymphony does not provide integrated ACLs for TCP/IP access to these ports, it is recommended that you consult your firewall or iptables documentation to ensure that only the hosts that need to access the above ports are allowed to do so. An alternate example of this follows, which only allows source IPs from the 192.168.1.0/24 subnet to access the ports:
86
87 {{noformat}}
88 iptables -A INPUT -p tcp -m tcp -s 192.168.1.0/24 --dport 50000 -j ACCEPT
89 iptables -A INPUT -p tcp -m tcp -s 192.168.1.0/24 --dport 50003 -j ACCEPT
90 {{/noformat}}
91
92 This example, however, may require modification in your specific environment.
93 {{/note}}
94 )))
95 1. Login to your FreePBX administrator and click on **Module Admin**.
96 1. Verify that you have the **Asterisk API** module installed under **System Administration**. If not select **Check for updates online** at the top of the page and install the **Asterisk API** module.
97 1. Click **Upload module**
98 1. Specify the location of the iSymphony FreePBX module on your computer and click **Upload**.
99 1. Return to the **Module Admin** and **Enable** the iSymphony module and click **Process**.
100 1. Click **Apply Configuration Changes**.
101 1. Asterisk will reload and the iSymphony module will populate the extensions and profiles. This may take some time as the iSymphony configuration is being built.
102
103 The iSymphony server should now be running. You'll need to setup permissions on the server for your users in the [[doc:iSymphony 2\.8 Documentation.iSymphony Administrator's Guide.Permissions.WebHome]] section.
104
105 = Extra Steps for Remote Installation =
106
107 If iSymphony is on a separate box from FreePBX perform these extra steps.
108
109 {{info}}
110 When iSymphony is **not** running on the same file system as the voicemail files are stored the visual voicemail functionality will **not** be available. Mapped drives will not solve this issue.
111 {{/info}}
112
113 {{warning}}
114 If you are adding an additional location to your iSymphony server make sure that you set the Location name to something other than "default" or the location name of an existing location before you Apply Configuration in FreePBX. If you have two modules pointing to the same server with the same location ID both module instances will attempt to write their config to the same location causing conflicts.
115 {{/warning}}
116
117
118
119 1. Go to the iSymphony page under Admin in FreePBX.
120 1. Set the **iSymphony Server Host** field to the IP or Hostname of server iSymphony Server is running on so that the FreePBX module knows how to connect to the iSymphony server.
121 1. Set the **Asterisk Server Host** field to the IP or Hostname of the FreePBX server so that the iSymphony Server knows how to connect to the Asterisk server.
122 1. Go to the Asterisk API Module page in FreePBX and select **isymphony.**
123 1. (((
124 In the **Permit** Field append the following to the existing entry. (Note the subnet mask may be different on your network)
125
126 {{code}}
127 &<IP of the iSymphony server>/255.255.255.0
128 {{/code}}
129 )))
130 1. Reload FreePBX
131 1. Your iSymphony server needs to connect to the Asterisk server and vise versa so we need to make sure that no firewalls are blocking these connections. See step 4 in Server Installation to get an example of how to open a port when using IPTables\\
132 11. The iSymphony server will need to connect to port 5038 on the FreePBX server.
133 11. The FreePBX server will need to connect to port 50001 on the iSymphony server.
134
135

Search

Navigation

iSymphony