Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: bump Asterisk version from 21 to 22

...

Note

FreePBX 17 comes with Asterisk 21 22 by default, which does not support chan_sip. For guidance on using FreePBX 17 with chan_sip, please refer to the wiki page Using FreePBX 17 with chan_sip https://sangomakb.atlassian.net/wiki/spaces/FP/pages/242581508 .

How to Back Up Your FreePBX System

...

Chan_sip to pjsip conversion option will only be visible if FreePBX 17 is running with Asterisk 21+.

  1. Restore via GUI
    If attempting to restore a backup archive that contains chan_sip extensions and/or trunks, then the restore process will stop and prompt the admin to choose between

    1. Continue - Automatically convert the chan_sip extensions/trunks to their pjsip counterparts and continue with the restore or …

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

      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

...

22

The supported FreePBX 17 install script sets up a new system with Asterisk 21 22 by default. Asterisk 21 22 does not support:

  • chan_sip device driver

  • Macro dialplan application

...

Users must manually update their custom dial plans or AGI scripts to convert all macros to GoSub to ensure compatibility with Asterisk 2122.

Chan_sip to PJSIP Conversion

...

If you're not ready to use Asterisk 2122, you can follow these steps to switch the Asterisk version before restoring your data:

  1. Install FreePBX 17, which by default comes with Asterisk 2122.

  2. Use the "asterisk-version-switch" tool to change the Asterisk version to any version lower than 21 that supports both chan_sip and macros.

  3. Restore your data.

...