Installing Purchased Commercial Modules
- Nathaniel Halbrooks
Overview
After you register your system and purchase a commercial module from the Portal Store, you just need to do two basic things in order to get the new module up and running:
Update the license file of your PBX so it recognizes the newly purchased module as being licensed.
Install the module if it is not already installed. (On most systems, all commercial modules are preinstalled.)
You do not need to look for a keycode, serial number, download link, or an e-mail containing your software. Your new purchase will automatically be tied to the Deployment ID that you selected during checkout. The final steps for licensing, downloading, and installing your new module are explained below. You will use the System Admin and Module Admin modules of your PBX GUI to complete the process.
How To Update the License File of the PBX
Log into your PBX GUI.
Go to Admin → System Admin.
Depending on your version of the PBX GUI, click on either the License or Activation option on the right side of your screen.
You should now see all modules that the deployment is licensed for. Verify that the license on your box shows all the commercial modules that you have purchased.
If you do not see your new item listed, simply press the Check, or Update License, or Update Activation button depending on what version of Sysadmin you have installed. The PBX should reach out to our license server and update your licenses.
With some routers or firewalls, you may not see the license items get updated after a few seconds, and will need to press the button a second time.
Check your list of registered modules again, and you should see the newly licensed modules.
NOTE: You may have to perform the following step in the linux shell (after verifying that the license is showing in the deployment information in the portal) to get licensed modules to show up in the GUI, as some PBX's cache the license file in apache. If you see this issue, run the following command from the linux shell:
service httpd restartHow To Install Commercial Modules in FreePBX
On most systems, all commercial modules are preinstalled. Typically, you do not need to install a module after you purchase a license for it. The instructions below explain how to check whether modules are installed, and how to install them if needed.
How to Check Whether a Module is Installed
Log into your PBX GUI.
Go to Admin → Module Admin.
The table shows a list of modules along with their version, track, publisher, license, and status. Look for your module in the list.
If you find the module in the list and its status is "Enabled," the module is installed and ready for you to use (as long as it is licensed).
If you find the module in the list but its status is "Disabled," you need to enable the module. See the full Module Admin User Guide for info.
If you cannot find the module in the list, proceed with the installation instructions below.
How to Install a Commercial Module
Log into your PBX GUI.
Go to Admin → Module Admin.
Select the Commercial repository (button will be dark blue when selected).
Click the Check Online button.
The list will update to include commercial modules that are available but not installed.
In our example, the QXact Reports module is not installed.Click the arrow or the name of the module in order to expand the information for it.
Click the Install or Download and Install button, as appropriate, to select it. (The button is dark blue when selected.) This button does not actually perform the action, but it selects the action that will be performed.
In our example, we are downloading and installing QXact Reports.Click the Process button near the top of the screen.
The next page will summarize your selected actions. Click the Confirm button to confirm the actions.
Click the Return button that appears after the process is complete.
Click the Apply Config button.
Your module should now show as installed and enabled.
You can navigate to the module in the PBX GUI menu.
More Information on System Admin & Module Admin
The instructions above give a basic overview of how to update the license file of the PBX, check for enabled modules, and download and install new commercial modules.
More detailed user guides for the System Admin and Module Admin modules are available. These guides cover other features that are not explained here, including how to update modules. Click on one of the links below to go to the wiki for that module.