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 installation on a vanilla or non FreePBX based Asterisk server. If you are using a FreePBX based install see the [[doc:FreePBX, Elastix and Trixbox Installation]] section.
9 {{/info}}
10
11 = 1. 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 = 2. Install the JRE (Java Runtime Environment) =
20
21 {{info}}
22 **Please be sure to review the [[Support Platforms>>doc:Supported Platforms]] page for details on version requirements of platform software.**
23 {{/info}}
24
25 {{note}}
26 OpenJDK is currently **not** supported.
27 {{/note}}
28
29 1. If you are not sure whether you have JRE installed correctly, please confirm by doing the following:
30 11. Open a shell console.
31 11. Type echo $JAVA_HOME in the shell console and then press Enter
32 11. View the result:
33 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.
34 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.
35 1. If you need to install the JRE, follow these instructions:
36 1*. Go to the [[Java download page>>url:http://www.oracle.com/technetwork/java/javase/downloads/index.html||shape="rect"]].
37 1*. Download the version entitled 'JRE 6 Update XX', where 'XX' stands for some number. (The latest version is available on that page.)
38 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"]].
39 At one point, you will be asked to choose an installation directory. Make a note of this directory for use later.
40
41 {{id name="download"/}}
42
43 = 3. Server Installation =
44
45 1. (((
46 Once you have downloaded iSymphony you are ready to install it. There are two options, depending if you downloaded the RPM or TARBALL server file.If using the RPM:
47
48 |(((
49 rpm -Uvh iSymphonyServer**//<version>//**.rpm
50 )))
51
52 Or if you're using the TAR:
53
54 |(((
55 tar xzvf iSymphonyServer<version>.tar.gz
56 <path to extracted package>/install.sh
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 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:
68
69 |(((
70 #include /opt/isymphony/server/isymphony.conf
71 )))
72 )))
73 1. Reload the Asterisk Configuration by either restarting asterisk entirely or using the Asterisk CLI to issue a **reload** command or a **dialplan reload **command if using Asterisk 1.6 or higher.
74 1. (((
75 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:
76
77 |(((
78 [isymphony]
79 secret = mysecret
80 deny=0.0.0.0/0.0.0.0
81 permit=127.0.0.1/255.255.255.0
82 read = all
83 write = all
84 )))
85 )))
86 1. If you are using Asterisk 1.6 or higher you must issue a **manager reload** command on the Asterisk CLI in order for the changes to manager.conf to be applied.
87 1. (((
88 Start the iSymphony server:
89
90 |(((
91 /opt/isymphony/server/startup.sh
92 )))
93 )))
94 1. Verify that ports 50000 and 50003 are not being blocked by any firewall and are forwarded as necessary.
95
96 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.

Search

Navigation

iSymphony