This documentation relates to iSymphony 3.5. You can view older documentation on the Older Documentation page

Skip to end of metadata
Go to start of metadata

These instructions are for an installation on a FreePBX based system. If you have a non-FreePBX based system see the Asterisk Server (Vanilla) Installation section.

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.

1. Before you start

Please check the following points:

  1. Ensure that your system meets the minimum requirements to run iSymphony. For more information, please read the detailed system requirements.
    1. In particular, ensure that a Sun/Oracle JRE is already installed on the server. See Installing iSymphony for more details. 
  2. Have your iSymphony license key ready.
  3. Determine the correct installation method to use for your environment. See Determine the Installation Method for more information.

On this page:

2. Server Installation

Install the iSymphony server. The install package and installation steps will differ depending on the type of OS you will be installing on.

RPM (RedHat Based Linux Distributions)

Once you have downloaded the iSymphony RPM to your server run the following command to install it.

rpm -Uvh iSymphonyServerV3-fpbx-<version>-1.noarch.rpm

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.

/opt/isymphony3/server/config.sh

Once the JRE location has been properly set run the following command to startup the server:

service iSymphonyServerV3 start

Tarball (Debian and other Linux Distributions)

  1. Once you have downloaded the iSymphony TARBALL to your server run the following commands to install it.

    tar -xzf iSymphonyServer<version>.tar.gz
    cd ./iSymphonyServer<version>
    chmod +x install.sh
    ./install.sh
  2. 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.

  3. 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.

  4. Start the iSymphony server:

    /opt/isymphony3/server/startup.sh

3. Verify Required Ports Are Open

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.

iptables -L
iptables -A INPUT -p tcp -m tcp --dport 58080 -j ACCEPT
iptables -A INPUT -p tcp -m tcp --dport 55050 -j ACCEPT
service iptables save

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 Security for more information.

4. FreePBX Module Installation

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.

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.

Both iSymphony 2.x.x and iSymphony 3.x.x modules can be installed side by side without issue.

If you are utilizing the FreePBX or Asterisk Now distros you may already have the module installed and ready to go.

 

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.

  1. Login to your FreePBX GUI and navigate to Admin->Module Admin.
  2. Select Check Online in the top left hand corner of the page.
  3. Under the Admin section on the page you should see iSymphonyV3 available for download. Click on the iSymphonyV3 item and select Download and Install.
  4. Select Process on the top right hand corner of the page and continue the installation.
  5. 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.

The iSymphony server should now be running and configured.

5. Advanced Installations (optional)

  • Remote Installations: if iSymphony will not be running on the same machine as Asterisk, see the Remote Installations page for extra steps that are needed in order to complete the installation.
  • Migrations: If iSymphony is being installed on a new server to migrate existing configuration, see the Migrating an iSymphony Server page for the next steps.