Skip to Content
Version 6.1 by michaely on 2021/09/09 18:02
Hide last authors
michaely 1.1 1 What's on this page:
2
3
4
5 {{toc/}}
6
7 {{info}}
8 These instructions are for installation on a vanilla or non FreePBX based Asterisk server. If you are using a FreePBX based install see the [[doc:FreePBX, Elastix and PBX in a Flash Installation]] section.
9 {{/info}}
10
11 {{info}}
12 iSymphony 3.x.x is configured, by default, in such a way that you can run an iSymphony 3.x.x instance along side an iSymphony 2.x.x installation.
13 {{/info}}
14
15 = 1. Before you start =
16
17
18
19 {{id name="Before you start"/}}
20
21 Please check the following points:
22
23 1. Ensure that your system meets the minimum requirements to run iSymphony. For more information, please read the detailed [[system requirements>>doc:iSymphony Requirements]].
24 1. Have your iSymphony license key ready.
25 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.
michaely 3.1 26 1. Determine the correct installation method to use for your environment. See [[doc:Determine the Installation Method]] for more information.
michaely 1.1 27
28 = 2. Install the JRE (Java Runtime Environment) =
29
30
31
32 {{id name="Install the JRE"/}}
33
34 {{info}}
35 **Please be sure to review the [[Support Platforms>>doc:ISYM28.Supported Platforms]] page for details on version requirements of platform software.**
36 {{/info}}
37
michaely 6.1 38 {{note}}
39 OpenJDK is currently **not** supported.
40 {{/note}}
41
michaely 1.1 42 1. If you are not sure whether you have JRE installed correctly, please confirm by doing the following:
43 11. Open a shell console.
44 11. Type echo $JAVA_HOME in the shell console and then press Enter
45 11. View the result:
46 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.
47 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.
48 1. If you need to install the JRE, follow these instructions:
49 1*. Go to the [[Java download page>>url:http://www.oracle.com/technetwork/java/javase/downloads/index.html||shape="rect"]].
50 1*. Download the version entitled 'JRE 7 Update XX', where 'XX' stands for some number. (The latest version is available on that page.)
51 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"]].
52 At one point, you will be asked to choose an installation directory. Make a note of this directory for use later.
53
54
55
56 {{id name="download"/}}
57
58 = 3. Server Installation =
59
60 Install the iSymphony server. The install package and installation steps will differ depending on the type of OS you will be installing on.
61
62 === RPM (RedHat Based Linux Distributions) ===
63
64 (((
65 Once you have downloaded the iSymphony RPM to your server run the following command to install it.
66
67 {{code language="bash"}}
68 rpm -Uvh iSymphonyServerV3-<version>-1.noarch.rpm
69 {{/code}}
70
71 {{info}}
72 By default the rpm installer will look for your java installation in **/usr/java/latest** or whatever your **JAVA_HOME** environment variable is set to. If the installer cannot locate the JRE the startup will fail. If your JRE is in a different location run the following command to set the JRE location.
73
74 {{code language="bash"}}
75 /opt/isymphony3/server/config.sh
76 {{/code}}
77 {{/info}}
78
79 === Tarball (Debian and other Linux Distributions) ===
80 )))
81
82 1. (((
83 Once you have downloaded the iSymphony TARBALL to your server run the following commands to install it.
84
85 {{code language="bash"}}
86 tar xzf iSymphonyServerV3<version>.tar.gz
87 cd ./iSymphonyServerV3<version>
88 chmod +x install.sh
89 ./install.sh
90 {{/code}}
91 )))
92 1. (((
93 If the installer cannot locate a suitable JRE you will be prompted to specify the path to the JRE during installation.  iSymphony assumes your Sun Java JRE is located in **/usr/java/latest/ **by default.
94 )))
95 1. (((
96 The installer will then ask you for the location to install iSymphony. The default will be **/opt/isymphony3/server.** We recommend that you utilize the default path.
97 )))
98
99 = 4. Setup Asterisk Configuration =
100
101 1. (((
102 Configure Asterisk by including the **isymphony.conf** file in your Asterisk dial plan. This can be accomplished by adding the following line to the end of your Asterisk **extensions.conf **file
103
104 {{code}}
105 #include /opt/isymphony3/server/isymphony.conf
106 {{/code}}
107 )))
108 1. (((
109 Reload the Asterisk Configuration using the following command:
110
111 {{code language="bash"}}
112 asterisk -rx "dialplan reload"
113 {{/code}}
114 )))
115 1. (((
116 Add an entry into **/etc/asterisk/manager.conf** similar to the following and verify that it contains a **permit **entry for the IP that the iSymphony server is installed on:
117
118 {{code}}
119 [isymphony]
120 secret = mysecret
121 deny=0.0.0.0/0.0.0.0
122 permit=127.0.0.1/255.255.255.0
123 read = all
124 write = all
125 writetimeout = 3000
126 eventfilter=!Event: RTCPSent
127 eventfilter=!Event: RTCPReceived
128 eventFilter=!Event: CEL
129 {{/code}}
130 )))
131 1. (((
132 Reload the Asterisk manager configuration using the following command:
133
134 {{code language="bash"}}
135 asterisk -rx "manager reload"
136 {{/code}}
137 )))
michaely 4.1 138 1. (((
139 If you are using Asterisk Queues you will need to add the following two properties to each queue configured in **/etc/asterisk/queues.conf**
140
141 {{note}}
142 If you do not add these properties, agents will not show any status when they are rung by a queue.
143 {{/note}}
144
145 {{code}}
146 eventmemberstatus=yes
147 eventwhencalled=yes
148 {{/code}}
149
150 Once added run the following command to apply the changes:
151
152 {{code}}
153 asterisk -rx "core reload"
154 {{/code}}
155 )))
michaely 1.1 156 1. Set up the voicemail and recording agent resource URLs and Extensions:
157 11.
158 111. Open the file **/opt/isymphony3/server/conf/agent/voicemail.xml**
159 111. Modify the **host** value in this file to the public hostname or IP of the iSymphony server. This field specifies the host to use in the URL when playing back voicemail in the client.
160 111. Modify the **extension** value to the file extension of the voicemail files as they are stored in the voicemail directory. This is used to determine which file type to play back in the client when listening to voicemail.
161 111. Open the file **/opt/isymphony3/server/conf/agent/recording.xml**
162 111. Modify the **host** value in this file to the public hostname or IP of the iSymphony server. This field specifies the host to use in the URL when playing back recordings in the client.
163 111. Modify the **extension** value to the file extension of the recording files as they are stored in the recording directory. This is used to determine which file type to play back in the client when listening to recordings.
164 1. (((
165 Start or restart the iSymphony Server via the following commands.
166
167 {{info}}
168 If the iSymphony server is already running you must restart in order for the voicemail and recording configuration to take effect.
169 {{/info}}
170
171 **RPM**
172
173 {{code language="bash"}}
174  service iSymphonyServerV3 restart
175 {{/code}}
176
177 **Tarball**
178
179 {{code language="bash"}}
180 /opt/isymphony3/server/shutdown.sh
181 /opt/isymphony3/server/startup.sh
182 {{/code}}
183 )))
184
michaely 6.1 185 = 4. Verify Required Ports Are Open =
michaely 1.1 186
187 Verify that ports 58080 and 55050 are not being blocked by any firewall and are forwarded as necessary. If you are running IP Tables run the following commands on the server CLI in order to open the ports. These ports allow access to the iSymphony Client and Administration interfaces.
188
189 {{noformat}}
190 iptables -L
191 iptables -A INPUT -p tcp -m tcp --dport 58080 -j ACCEPT
192 iptables -A INPUT -p tcp -m tcp --dport 55050 -j ACCEPT
193 service iptables save
194 {{/noformat}}
195
196 {{note}}
197 The above command will open up the iSymphony Client and Administration Interfaces to the entire outside world. Normally this is fine since these interfaces require authentication in order to access them. If you would like to enable further access restriction or enable SSL encryption on the iSymphony Client and Administration Interfaces you can do so via the security system. See [[doc:Security]] for more information.
198 {{/note}}
199
200 The iSymphony server should now be installed and running.