Last modified by Scott Gagan on 2024/02/14 19:32
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 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.
5
6 {{info}}
7 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.
8 {{/info}}
9
10 = 1. Before you start =
11
12 Please check the following points:
13
14 1. Ensure that your system meets the minimum requirements to run iSymphony. For more information, please read the detailed [[system requirements>>doc:iSymphony Requirements]].
15 11. In particular, ensure that a Sun/Oracle JRE is already installed on the server. See [[doc:Installing iSymphony]] for more details.
16 1. Have your iSymphony license key ready.
17 1. Determine the correct installation method to use for your environment. See [[doc:Determine the Installation Method]] for more information.
18
19
20 {{id name="download"/}}
21 {{/layout-cell}}
22
23 {{layout-cell}}
24 {{panel title="On this page:"}}
25 {{toc/}}
26 {{/panel}}
27 {{/layout-cell}}
28 {{/layout-section}}
29
30 {{layout-section ac:type="single"}}
31 {{layout-cell}}
32 = 2. Server Installation =
33
34 Install the iSymphony server. The install package and installation steps will differ depending on the type of OS you will be installing on.
35
36 === RPM (RedHat Based Linux Distributions) ===
37
38 (((
39 Once you have downloaded the iSymphony RPM to your server run the following command to install it.
40
41 {{code language="bash"}}
42 rpm -Uvh iSymphonyServerV3-fpbx-<version>-1.noarch.rpm
43 {{/code}}
44
45 {{info}}
46 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.
47
48 {{code language="bash"}}
49 /opt/isymphony3/server/config.sh
50 {{/code}}
51
52 Once the JRE location has been properly set run the following command to startup the server:
53
54 {{code language="bash"}}
55 service iSymphonyServerV3 start
56 {{/code}}
57 {{/info}}
58
59 === Tarball (Debian and other Linux Distributions) ===
60 )))
61
62 1. (((
63 Once you have downloaded the iSymphony TARBALL to your server run the following commands to install it.
64
65 {{code language="bash"}}
66 tar -xzf iSymphonyServer<version>.tar.gz
67 cd ./iSymphonyServer<version>
68 chmod +x install.sh
69 ./install.sh
70 {{/code}}
71 )))
72 1. (((
73 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.
74 )))
75 1. (((
76 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.
77 )))
78 1. (((
79 Start the iSymphony server:
80
81 {{code}}
82 /opt/isymphony3/server/startup.sh
83 {{/code}}
84 )))
85
86 = 3. Verify Required Ports Are Open =
87
88 Verify that ports 58080 and 55050 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. These ports allow access to the iSymphony Client and Administration interfaces.
89
90 {{code}}
91 iptables -L
92 iptables -A INPUT -p tcp -m tcp --dport 58080 -j ACCEPT
93 iptables -A INPUT -p tcp -m tcp --dport 55050 -j ACCEPT
94 service iptables save
95 {{/code}}
96
97 {{note}}
98 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.
99 {{/note}}
100
101 = 4. FreePBX Module Installation =
102
103 {{note}}
104 The FreePBX module does not install the server piece of the application. Both the module and the iSymphony server need to be installed. Make sure that you follow step 2 above to get the server installation running before you install the module. You may have version 2 already installed in **/opt/isymphony. **If this is the case you will STILL need to install the iSymphony V3 server.
105 {{/note}}
106
107 {{info}}
108 iSymphony 3.x.x utilizes a completely new FreePBX module. The FreePBX module for iSymphony 2.x.x will not work with iSymphony 3.x.x and vise versa.
109 {{/info}}
110
111 {{info}}
112 Both iSymphony 2.x.x and iSymphony 3.x.x modules can be installed side by side without issue.
113 {{/info}}
114
115 {{info}}
116 If you are utilizing the FreePBX or Asterisk Now distros you may already have the module installed and ready to go.
117 {{/info}}
118
119
120 The iSymphony FreePBX module is provided in the FreePBX module repositories. You can follow the steps below to download and install the module form the repository.
121
122 1. Login to your FreePBX GUI and navigate to **Admin->Module Admin.**
123 1. Select **Check Online** in the top left hand corner of the page.
124 1. Under the **Admin** section on the page you should see **iSymphonyV3** available for download. Click on the **iSymphonyV3** item and select **Download and Install**.
125 1. Select **Process** on the top right hand corner of the page and continue the installation.
126 1. Select **Apply Config** at the top of the page. Asterisk will reload and the iSymphony module will populate the extensions and users. This may take some time as the iSymphony configuration is being built.
127
128 The iSymphony server should now be running and configured.
129
130 = 5. Advanced Installations (optional) =
131
132 * Remote Installations: if iSymphony will not be running on the same machine as Asterisk, see the [[doc:Remote Installations]] page for extra steps that are needed in order to complete the installation.
133 * Migrations: If iSymphony is being installed on a new server to migrate existing configuration, see the [[doc:Migrating an iSymphony Server]] page for the next steps.
134 {{/layout-cell}}
135 {{/layout-section}}
136 {{/layout}}

Search

Navigation

iSymphony