Versions Compared

Version Old Version 1 New Version 2
Changes made by

Kelli Higdon

Kelli Higdon

Saved on

Key

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

...

Note

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

Release Notes Here

...

You can check your current FreePBX Distro version by going to the Web GUI sysadmin module 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

Upgrade option 1: Manual upgrade using version upgrade scripts

...

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
 
wget http://upgrades.freepbxdistro.org/stable/5.211.65/upgrade-5.211.65-2.sh
chmod +x upgrade-5.211.65-2.sh
./upgrade-5.211.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 sysadmin module installed and have also purchased the SysAdmin Pro commercial license for the sysadmin module, you can use either the FreePBX web GUI to perform an update or run the following script from the command line to auto-update your system to the latest version.

Web GUI

Command line

Code Block
/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-5.211.65-4.sh

    • ntp.conf: this file is updated in this release to disable NTP server functionality due to concerns about keeping this component securely configured. Delete the old saved file to clean up

      Code Block
      rm /etc/ntp.conf.rpmsave

    • Important: Any devices that may have been using the FreePBX Distro server to get time information (such as phones) should be reconfigured to use a different NTP server by editing the NTP server settings distributed to phones by EndPoint Manager (OSS or Commercial)

  • upgrade-5.211.65-15.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

    • Delete the old file "/etc/httpd/conf.d/freepbx.conf.rpmsave" to clean up

      Code Block
      rm /etc/httpd/conf.d/freepbx.conf.rpmsave

    • 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-5.211.65-18.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

    • Reboot as instructed

...