License Installation and Details

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

On this page:

Overview

In iSymphony each tenant is individually licensed whether there's a single tenant or multiple locations with several tenants. Each license contains the number of clients, i.e. simultaneous client connections, and the number of queues you can manage via the panel. The "License" section in the tenant configuration page or the iSymphony FreePBX module page will display who the license is registered to, the number of clients, the number of queues, the serial key, and if the license is a trial, the number of days remaining.

Activating/Updating a License

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

If you have modified you license with additional clients or queues simply perform the activate process with the same serial key in order to update the license.

FreePBX Module:

  1. Go to the iSymphony module page.
  2. Enter the serial key in the serial key in the activate field under the License section.
  3. Hit the Activate button.

ISymphony Administrator:

  1. Log into the iSymphony Administration interface (see the Connecting to the Administration Interface section) 
  2. Click on the tenant item you wish to activate the license on in order to open the tenant properties page.
  3. Under the license section hit the Activate button.
  4. In the prompt enter the serial key and select Activate.?  

Manual License Installation

Using the licensing activation feature requires Internet connectivity. If iSymphony has trouble contacting the licensing server it creates a license request file(request-r.lic) normaly located in /opt/isymphony/server/lic and it will notify you that you need to send the license file to support@getisymphony.com to have it manually generated.

Once you receive a license file from i9 Technologies follow these steps to install it.

  1. Shut down your iSymphony server (/opt/isymphony/server/shutdown.sh)
  2. Copy the license file into /opt/isymphony/sever/lic
  3. Open the extensions.xml file in /opt/isymphony/sever/config
  4. Look for your <Tenant> tag and modify the "license" attribute to look like license="license.lic". Save the file.
  5. Start your iSymphony server (/opt/isymphony/server/startup.sh).

Locating Your License Details

To locate your license outside of iSymphony:

  1. The serial key was originally sent via e-mail when you placed your order.
  2. View your licenses from the iSymphony Licenses section of your account
  3. View you orders from the My Orders section of your account

If you cannot locate your license via these two methods there are three ways to get the installed license information 

  1. Via the Administration Tab in the iSymphony client. 
    1. See Connecting to the Administration Interface to learn how to connect a client to the Administrator.
    2. In the left hand configuration tree in the administrator select your tenant under Tenants. This is usually default. The tenant properties page will be displayed on the left hand side.
    3. In the tenant properties page you will see a licensing section that will contain the details of the installed license.
  2. Via the FreePBX iSymphony Module. This requires the iSymphony FreePBX module to be installed in you FreePBX installation.
    1. Log into the FreePBX admin page.
    2. Go to the iSymphony page via the FreePBX menu.
    3. The licensing details will be displayed in the licensing section. 

      Some version of the iSymphony FreePBX module do not show the serial key in this area.

  3. Via the iSymphony CLI. This requires SSH access to the server iSymphony is installed on.1. Log onto the server via SSH.

    1. Type 

      telnet localhost 50001
      location default
      tenant default

      You may need to replace default with your real location and tenant names if you have changed them.

    2. At this point you can type in several commands to get the relative information about the license

      license serial
      license clients
      license queues
      license name
      license days
    3. Once you are done type

      exit
Tags: license
   
iSymphony