Asterisk Server (Vanilla) Installation

Last modified by Scott Gagan on 2021/09/10 22:35

What's on this page:

These instructions are for installation on a vanilla or non FreePBX based Asterisk server. If you are using a FreePBX based install see the FreePBX, Elastix and Trixbox Installation section.

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.
  2. Have your iSymphony license key ready. You can obtain a trial, free or commercial license now, or retrieve your existing license key.
  3. You must be able to use a command prompt and install Java to continue. If not, please contact your system administrator to assist you.

2. Install the JRE (Java Runtime Environment)

Please be sure to review the Support Platforms page for details on version requirements of platform software.

Failed to execute the [error] macro. Cause: [The required content is missing.]. Click on this message for details.

  1. If you are not sure whether you have JRE installed correctly, please confirm by doing the following:
    1. Open a shell console.
    2. Type echo $JAVA_HOME in the shell console and then press Enter
    3. View the result:
      • 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.
      • 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.
  2. If you need to install the JRE, follow these instructions:
    • Go to the Java download page.
    • Download the version entitled 'JRE 6 Update XX', where 'XX' stands for some number. (The latest version is available on that page.)
    • When the download has finished, run the Java installer. Detailed installation instructions are provided on Oracle's website.
       At one point, you will be asked to choose an installation directory. Make a note of this directory for use later.

3. Server Installation

  1. 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:

    rpm -Uvh iSymphonyServer<version>.rpm

    Or if you're using the TAR:

    tar xzvf iSymphonyServer<version>.tar.gz
    <path to extracted package>/install.sh

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

    /opt/isymphony/server/config.sh

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

    #include /opt/isymphony/server/isymphony.conf

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

  5. 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:

    [isymphony]
    secret = mysecret
    deny=0.0.0.0/0.0.0.0
    permit=127.0.0.1/255.255.255.0
    read = all
    write = all

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

  7. Start the iSymphony server:

    /opt/isymphony/server/startup.sh

  8. Verify that ports 50000 and 50003 are not being blocked by any firewall and are forwarded as necessary.

The iSymphony server should now be running. You'll need to setup permissions on the server for your users in the Permissions section. 

   

Search

Navigation

iSymphony