Content Comparison

...

Release Notes

Click here to view the Release Notes for 6.12.65. This page contains release notes for all of the versions listed below.

...

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

cat /etc/asterisk/freepbxdistro-version
 
on older systems and
 
cat /etc/schmooze/pbx-version
 
on newer systems

Upgrade Option 1: Manual Upgrade Using Version Upgrade Scripts

...

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.

cd ~
mkdir upgradescripts
cd upgradescripts
 
wget http://upgrades.freepbxdistro.org/stable/6.12.65/upgrade-6.12.65-2.sh
chmod +x upgrade-6.12.65-2.sh
./upgrade-6.12.65-2.sh

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

...

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.

Web GUI

• See System Admin

Command line

/usr/sbin/sysadmin_update_system

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.

Specific Update Notes

• upgrade-6.12.65-14.sh

  • 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

• upgrade-6.12.65-17.sh

  • 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

• upgrade-10.13.66-1.sh

  • 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
    [client] user=root password=mysecret

    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

...