PBX Platforms
Page tree
Skip to end of metadata
Go to start of metadata

About FreePBX Distro and AsteriskNOW-10.13.66 releases

Below is an outline of this version

  • FreePBX 13
  • SHMZ OS 6.6 (Derived from CentOS)
  • Asterisk 11 or 13
  • DAHDI 2.11

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 for these versions.

Upgrade Scripts

Upgrade Scripts

Below is a list of shell upgrade scripts officially released to update an existing FreePBX Distro 10.13.66 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 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.

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, 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

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. Upgrade scripts should be run as the Linux root user.

# download the upgrade script
mkdir /root/upgradescripts
cd /root/upgradescripts
wget https://upgrades.freepbxdistro.org/stable/10.13.66/upgrade-10.13.66-2.sh

 
# make the script executable
chmod +x *.sh
 
# change back to / to avoid some script warnings and run the script
cd /
/root/upgradescripts/upgrade-10.13.66-2.sh

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

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.

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

Upgrade Option 2: Upgrade Using Commercial System Administration Pro Module

If you have the sysadmin module installed and have also purchased the SysAdmin Pro commercial license for it, you can use either the FreePBX web GUI to perform an update, or you can run the script shown below from the command line to auto-update your system to the latest version.

Using the Web GUI

Using the 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

  • none yet 

 

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.

  • No labels

8 Comments

  1. hecatae

    upgrade from 6.12.65 requires the ability to login to mysql without password.

    solution is to edit /etc/my.cnf

    add:

    client

    user=root

    password=your mysql root password

  2. Jerry Riggin

    This process does NOT upgrade Asterisk.  If you want to upgrade to 13, you should do it before this process so the dependencies will be correct.  You will see errors like this:

    Unable to install module arimanager:
    - Requires engine asterisk (>= 12), you have: asterisk 11.20.0

    and (this because arimanager failed?):

    The following error(s) occured:
    - Failed to install User Control Panel due to the following conflicting module(s): FreePBX ARI Framework
    Unable to resolve dependencies for module webrtc:

    So if you want 13, run script "asterisk-version-switch" to upgrade before upgrading freePBX.

    Also, after the upgrade to 10.13.66-1, the SysAdminPro module throws this error when you try to upgrade to 10.13.66-6:

    Whoops\Exception\ErrorException
    Undefined index: version
    File:/var/www/html/admin/modules/sysadmin/Sysadmin.class.php:271

    Running "fwconsole r" resolves this issue.

  3. rymes

    FWIW, the suggestion above to run "fwconsole r" did not resolve my issues updating through the system admin module. There is a bug open for this problem: FREEPBX-10599 - Getting issue details... STATUS

  4. Jerry Riggin

    Try this:

    run "amportal a s" 
    fwconsole chown
    fwconsole ma refreshsignatures
    fwconsole r 

    1. rymes

      I'll give that a try, but I have nothing to update at this point, as I upgraded using the CLI.

  5. jlg89

    IMO it's not a great idea to make auto-updates a paid-only feature, but then again devs gotta eat too. At any rate, there are other ways to skin that cat. Login as root, save the following as an executable script, and use cron to run it as often as you feel the need:

     

    #!/bin/bash
    ugdir=/root/upgradescripts
    if [ ! -d $ugdir ]
    then
     mkdir $ugdir
    fi
    version=`cat /etc/schmooze/pbx-version`
    base=`echo $version | cut -f1 -d'-'`
    build=`echo $version | cut -f2 -d'-'`
    echo ""
    echo ----------------------------------------
    echo Current FreePBX version is $version
    echo Checking for updates...
    echo ----------------------------------------
    echo ""
    error=0
    while [ $error = 0 ]
    do
     build=`expr $build + 1`
     wget http://upgrades.freepbxdistro.org/stable/$base/upgrade-$base-$build.sh -O $ugdir/upgrade-$base-$build.sh
     error=$?
     if [ $error = 0 ]
     then
      chmod +x $ugdir/upgrade-$base-$build.sh
      $ugdir/upgrade-$base-$build.sh
     fi
    done
    echo ""
    echo ----------------------------------------
    echo Finished.
    echo ----------------------------------------
    echo ""
     

    1. David Adamski

      This is wonderful. Thank you.

      I have one question: Should the upgrade start with with $build instead of $build +1?

      While I would think starting with the next build number up from currently installed make sense, the wiki above says "Download the upgrade script matching the current version of FreePBX Distro installed" (emphasis mine)

      But, if your script is doing the job correctly, then I'd guess the wiki needs to be made clearer....Or maybe I'm missing something.

      Let me know your thoughts.

      Thanks again.

  6. PA SI

    Asterisk have posted 2 security advisories of CVE-2017-17090 (AST-2017-013) and AST-2017-012.
    The fixes for these advisory require Asterisk 13.18.3 and 13.18.4 respectively.
    I am running the latest FreePBX patch 10.13.66-22; however, this version come with the latest Asterisk of 13.18.0.
    I am wondering if FreePBX has any plan to provide the next update for the version 10 with newer Asterisk?