Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added

About FreePBX


Distro and AsteriskNOW-6.12.65


Stable Releases

Below is an outline of this version:

  • FreePBX Alpha 12
  • CentOS SHMZ OS 6.5 (Derived from CentOS)
  • Asterisk 11 or 1213
  • DAHDI 2.810

System Impact


The upgrade procedures outlined below will stop Asterisk and may also require a system reboot to fully apply. Perform the system upgrade using a scheduled maintenance window.

Release Notes

Click here to view the Release Notes Here


for 6.12.65


. This page contains release notes for all of the versions listed below.

Upgrade Scripts

titleUpgrade Scripts

Below the is a list of shell upgrade scripts officially released to update an existing FreePBX Distro 6.12.65 system to a specific minor release version. The scripts will update the entire distribution, including all FreePBX web components and all OS-level components (such as the kernel and kernel modules).

All upgrades need to be installed in numeric ascending order. Do not skip any available upgrade step. Upgrade scripts are not cumulative. Each upgrade script should be run in ascending order to get to the desired final version.

The upgrade path is one-way. These scripts cannot be used to downgrade the version of FreePBX Distro to an earlier version. The only way to reverse the effects of the upgrade procedure is to restore the system from a backup.

  • FreePBX Distro 6.12.65-1
    • (No Upgrade script, as this is the initial release version of this track.



How to Check the Current FreePBX Distro Version

You can check your current FreePBX Distro version by going to the Web GUI sysadmin module or. Or, from the Linux command line, do a:

Code Block
cat /etc/asterisk/freepbxdistro-version

on older systems and

cat /etc/schmooze/pbx-version

on newer systems



Option 1: Manual


Upgrade Using Version Upgrade Scripts


1.) Check the current FreePBX Distro version


. Display the current version file (as above) to confirm the current installed version of FreePBX Distro.




2.) Download and run the applicable upgrade script


. To install an update script via the Linux command line, use the following commands, substituting the proper scripts from above. Download the upgrade script matching the current version of FreePBX Distro installed, mark it as executable, and run it.


Code Block
cd ~
mkdir upgradescripts
cd upgradescripts

chmod +x

The FreePBX Distro upgrade script will update both FreePBX components (Asterisk, the FreePBX web GUI) and all base CentOS components.

Step 3: Specific script instructions

Note any special instructions displayed at the end of the upgrade if any are displayed, such as to reboot the system.


3.) Confirm the new FreePBX Distro version


Cat the updated (now current) version file (as above) to confirm the current installed version of FreePBX Distro is the expected newer version.



Option 2: Upgrade


Using Commercial System Administration Pro



If you have the sysadmin module installed and have also purchased the SysAdmin Pro commercial license


, you can use either the FreePBX web GUI to perform an update or run the following script from the command line


. This will automatically update your system to the latest version.


Command line

Code Block

Resolving OS


Configuration File Changes

Some upgrade scripts will result in .rpm package updates that need configuration files to be manually cleaned up afterwards. The general procedure is described in the page Cleaning up files from a RPM update.



Not available


Update Notes

    • Delete the default package fail2ban configuration file. FreePBX Distro generates a customized version of this file.

      Code Block
      rm /etc/fail2ban/jail.local.rpmnew
    • MySQL activity logging to /var/log/mysql/mysql.log is disabled in this release. This MySQL log file can be quite large, depending on server usage loads. Delete this file after the update to reclaim this disk space.

      Code Block
      rm /var/log/mysql/mysql.log
    • Replace the old version of /etc/dahdi/modules with the updated version of the file

      Code Block
      mv /etc/dahdi/modules.rpmnew /etc/dahdi/modules
    • The upgrade to 10.13.66 requires the ability for the MySQL root user to login to the database without a password. This is the default case. This can be tested by running "mysql" as the OS root user and see if the login happens without any password prompt. If you have set a password for the MySQL root user, create a /root/.my.cnf to supply the password so MySQL can be accessed without a password prompt. Ensure this file is only readable by the root user as it will have the password in plain text. Do this before running the upgrade script.

      Code Block
      Code Block
      # set the file to be read/write for root only
      chmod 600 /root/.my.cnf
    • Consider switching to Asterisk ver. 13 with asterisk-version-switch. Asterisk ver. 13 is the recommended version to use, and some features (such as presence state) are not supported on Asterisk 11.
    • After completing the upgrade to 10.13.66-1, continue with applying subsequent updates to the 10.13.66 track at FreePBX-Distro-10.13.66 to get fully current
    • Disable and then uninstall and remove obsolete modules such as "FreePBX ARI Framework" (the old user web GUI) and "FreePBX FOP Framework" (the old Flash Operator Panel). Uninstalling the "FreePBX ARI Framework" is needed as the uninstall creates a Web forward from the HTTP .../recordings URL to send users to the new .../ucp (User Control Panel) URL.
    • Log into the new FreePBX 13 web GUI and address any warnings or notifications in the web GUI

CentOS is a Trademark of Red Hat and we do not claim to have any relationship with either Red Hat or CentOS


Asterisk and AsteriskNOW are registered trademarks of Digium Inc.