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

THIS IS BETA SOFTWARE. PLEASE DO NOT RUN THIS ON YOUR PRODUCTION SYSTEMS.

THIS ONLY WORKS ON THE OFFICIAL FREEPBX DISTRO AT THIS TIME

Please open tickets for issues at issues.freepbx.org

Summary

This allows you to upgrade the Official Distro from 6 to SNG7, and in the process upgrade FreePBX (or PBXact etc) from 13 to 14.

Supported Platforms

  • FreePBX Distro
  • PBXact Distro
  • Other compatible distros

Prerequisites

  • 64bit Operating System on current machine (see note below)
  • At least 10gb of available space in /
  • Internet connectivity (about 200mb of data needs to be downloaded)


SNG7 is a 64 bit only operating system. Unfortunately, It is not possible to convert a 32 bit operating system to 64 on the fly, If you are currently running a 32 bit operating system, the simplest way to upgrade is to use the FreePBX Conversion tool, which will allow you to do a live backup of a running machine and restore it to a new 14 machines.

Preparation

The Upgrade is managed by a RPM.  Simply install the RPM with the  following command

yum -y install http://package1.sangoma.net/distro-upgrade-1707-17.sng7.noarch.rpm

Starting Upgrade

The RPM installed above creates the file 'distro-upgrade' which validates the machine, and then starts downloading the requirements.  This does not cause any outage, and can be run at any time. After installing this, you can reboot the machine at any time and the upgrade will be automatically started.

distro-upgrade

Output

[root@localhost ~]# distro-upgrade
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                                            ┃
┃        Sangoma 6 to 7 Upgrade Tool         ┃
┃                                            ┃
┃    Distro Upgrade - Version 1707-2.sng7    ┃
┃    Build Date: 2017-06-21                  ┃
┃                                            ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

 Checking prerequsites...
        Checking bitsize of machine     [ ✔ ] - x86_64
        Checking available disk space   [ ✔ ] - 13G Available
 All prerequsites passed!

Are you ready to upgrade your machine to SNG7? This process requires
two reboots, and will download approximately 200mb of files before
starting. There will be no interruption to service until this machine
is rebooted.

Download files required for upgrade [Yn]?

Note that this can be run while the machine is up and processing calls. There is no outage until you reboot the machine. The speed of this is purely related to your internet connection speed. You may interrupt and restart the upgrade at any time, and it will resume downloading.

Download files required for upgrade [Yn]? y
######### Starting setup upgrade on Fri Jun 23 20:38:04 IST 2017 #########
######### Creating upgrade repofile #########
######### Installing needed packages #########
######### Running preupgrade #########
######### Running upgrade-tool #########
######### Downloading sangoma-release rpm #########
######### Updating packages.list #########
######### Verified sangoma-release in package.list #########
######### Reboot to finish this stage of the upgrade #########
######### Finished setup upgrade on Fri Jun 23 20:43:05 IST 2017 #########
Preparations complete!

Please reboot your machine when convenient. This machine will install all the new
and upgraded packages, and then reboot for a second time automatically. After the
second reboot, it will then continue the upgrade process automatically. When the
upgrade is complete, you will be presented with a standard login prompt.
[root@localhost ~]#

Perform Update

First Reboot (Stage 1)

You need to reboot the machine, which will then perform the upgrade. The 'system upgrade' option will be automatically selected. You can select a previous kernel if you do not want to upgrade at this time.

After selecting 'System Upgrade' the machine will upgrade all the required packages

The speed of the upgrade depends on your machine.  Note that the package 'selinux-policy-targeted' will take a long period of time to run. This is expected, as it needs to check and possibly re-label every file on the system. 

When the first stage of the upgrade is finished, the machine will reboot and will continue the upgrade process.

Second Reboot (Stage 2)

After the Core OS has been upgraded, the machine will reboot into Stage 2, which finishes the upgrade.

This also upgrades all the PBX Modules

When the upgrade is finished you will be presented with a Login prompt, and you can log into your system.


 _____              ____  ______  __
|  ___| __ ___  ___|  _ \| __ ) \/ /
| |_ | '__/ _ \/ _ \ |_) |  _ \\  /
|  _|| | |  __/  __/  __/| |_) /  \
|_|  |_|  \___|\___|_|   |____/_/\_\

NOTICE! You have 5 notifications! Please log into the UI to see them!

Current Network Configuration
+-----------+-------------------+--------------------------+
| Interface | MAC Address       | IP Addresses             |
+-----------+-------------------+--------------------------+
| eth0      | 00:50:56:B4:86:DB | 10.195.1.11              |
|           |                   | fe80::250:56ff:feb4:86db |
+-----------+-------------------+--------------------------+

Please note most tasks should be handled through the GUI.
You can access the GUI by typing one of the above IPs in to your web browser.
For support please visit:
    http://www.freepbx.org/support-and-professional-services

[root@upgrade1 ~]#

Troubleshooting

In the event that something goes wrong with the upgrade, please open a ticket at issues.freepbx.org and attach at the very least the following log files:

  • /var/log/sngupdate
  • /var/log/post_sngupdate


  • No labels

9 Comments

  1. I had to also perform yum update before I could let it rip. the distro-upgrade told me that there were pending updates. I was able to get the pending yum update executed, and re-ran distro-upgrade and them it was able to continue after the prerequisites were met. 

  2. Unfortunately I'm getting what seems to be a sysadmin license error after the process completes.  Unfortunately I didn't grab the upgrade logs to submit as I ran out of time this morning and had to revert back to my snapshot to get the phones up and running again.  I will be doing some additional testing this weekend and will grab the logs then.

    Has anyone else seen this?

    http://imgur.com/a/oqaos

    1. That means you still have old commercial modules on the system which are not compatible with the new version of PHP.

      1. Hi Bryan.  Thanks for the info.  Based on the screenshot, I assume it's the SysAdmin module that needs to be removed and then later updated?

        1. While sysadmin is the culprit in this case, as part of the upgrade we remove all commercial modules (using rm) and then upgrade them to new versions later in the script.

          1. This morning I disabled the SysAdmin and Endpoint modules before doing the upgrade (I did not remove them, only disabled them).  The upgrade completed, and phone functionality was restored, however the web GUI would not load.  Something was causing Apache to fail loading.

            Console access did not give me any errors either, until I ran the command to re-enable all disabled modules, and then I got the same PHP error from the screenshot above.

            As another test, I reverted back to my snapshot and tried the upgrade again, this time with the SysAdmin module enabled (and Endpoint disabled).  Phone functionality failed and I received the same PHP error as above.

            You mentioned above "as part of the upgrade we remove all commercial modules", but I'm wondering if I should remove the two I have before I even attempt the update.

            1. Christopher Phillips This is more easily discussed in either the forums or if you have a ticket open I'd be happy to go take a look there rather than here in the wiki.

  3. I have two servers in HA running under Distro 6.  Are there plans to include an upgrade to SNG7 like this for HA systems?  ( I know HA is not currently supported in 7).

    Thank you!

    Seth

    1. Seth, When SNG7 has a comparable solution we can look at removing the restriction from our distro-upgrade process.