Versions Compared

Key

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

...

Info

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 process. Switching to pjsip is highly recommended.

...

  1. Restore via GUI

    If the backup file contains the chan_sip extensions/trunks then it will give prompt to ask for auto-conversion and restore or else we can cancel the restore process.

    image-20240529-134921.png


  2. Restore via CLI
    CLI also will give the similar prompt while restoring data.

    image-20240529-135219.png

Challenges and Solutions When Restoring to FreePBX 17 Due to Asterisk 21

FreePBX 17 comes with Asterisk 21 by default, which does not support:

...

  • Custom dial plans 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:

...