| Info |
|---|
There is no direct inline upgrade path available for upgrading from any previous FreePBX versions to FreePBX 17 or PBXact 17. |
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The recommended upgrade path from any previous FreePBX version to FreePBX 17 is to use the "Backup & Restore" functionalitymodule. To do this, create a backup of your existing FreePBX system and then restore it onto the resulting backup archive to a newly installed FreePBX 17 system.
| Infonote |
|---|
FreePBX 17 comes with Asterisk 21 by default, which does not support chan_sip. For guidance on using FreePBX 17 with chan_sip, please refer to the "How to Use FreePBX 17 with chan_sip" wiki. |
How to Back Up Your FreePBX System
Following these steps will ensure that your new FreePBX 17 system has the same configuration as your existing setup.
How to Create a Backup from FreePBX 15/16
How to take Backup from FreePBX 15 / FreePBX 16 -
To take a full backup of your FreePBX 15+ system, use the Backup & Restore module. For detailed instructions on configuring and creating a full backup, please refer to the Using the Backup module for FreePBX 15+ wiki on Using the Backup Module.
How to Create a Backup from Legacy FreePBX (2.x/13/14)
To take a full backup of your FreePBX 2.x/13/14 system, use the Backup & Restore module. For detailed instructions on configuring and creating a full backup, please refer to the Using the Backup module wiki on Using the Backup Module.
How to Restore a Backup to a FreePBX 17 System
Please refer to the “Restore” steps as mentioned in the https://sangomakb.atlassian.net/wiki/spaces/PG/pages/20807752/Backup+and+Restore+FreePBX+15#Restore wiki.
Chan_sip to PJSIP Conversion During Data Restoration
The restore functionality in FreePBX 17 has been enhanced to support converting chan_sip devices to pjsip during the restoration restore process. Switching to pjsip is highly recommended.
...
Chan_sip to pjsip conversion option will only be visible if FreePBX 17 is running with Asterisk 21.
Restore via GUI
If the backup file contains the attempting to restore a backup archive that contains chan_sip extensions and/or trunks, then it will give prompt to ask for auto-conversion and restore or else we can cancel the restore process.the restore process will stop and prompt the admin to choose betweenContinue - Automatically convert the chan_sip extensions/trunks to their pjsip counterparts and continue with the restore or …
Cancel - Abort the restore completely which will allow the admin to downgrade asterisk and make the necessary config changes to continue using chan_sip (not recommended)
Restore via CLI
CLI also will give the similar prompt while restoring data.
Challenges and Solutions When Restoring to FreePBX 17 Due to Asterisk 21
The supported FreePBX 17 comes install script sets up a new system with Asterisk 21 by default, which . Asterisk 21 does not support:
chan_sip device driver
MacrosMacro dialplan application
Due to these limitations, restoring data from previous FreePBX systems may present challenges, such as:
Custom dial plans dialplan or AGI scripts using macros will not work after restoration.
chan_sip devices and trunks will not function.
Macros to GoSub
Users must manually update their custom dial plans or AGI scripts to convert all macros to GoSub to ensure compatibility with Asterisk 21.
Chan_sip to PJSIP Conversion
Convert all chan_sip devices and trunks to pjsip during the restoration process.
Using FreePBX 17 with a Different Asterisk Version
If you're not ready to use Asterisk 21, you can follow these steps to switch the Asterisk version before restoring your data:
...