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

Introduction

In FreePBX 15+ our backup module was redesigned for simplicity, flexibility and maintainability.  Storage options are now handled in the Filestore module which offers more options to keep your data safe. You can now backup per module. This allows you to create custom backups of just the data you need. You can also divide your modules in to different backups for data that may change more often. With each module handling the data it owns we can now do cross-version backup and restore (15+).

Creating backup jobs

Storage

If you are migrating from a previous version, your backup jobs will migrate on install including creating Filestore locations.

On a new install, the first step is to create a Filestore location. For information on doing this please see the Filestore documentation Here.


Backup Job Creation

Step 1: Click on the "Add Backup" button

Step 2: Give your backup a name and description.

Step 3: Click the "Modules" button

Step 4a: Choose the modules to backup. You can click the box in the header to select all.

Some modules will have their own settings which will be available by clicking the plus symbol.

Step 4b: Click "Save Changes"

Step4c: Add Custom directory to backup file.

This is an important step if we need to add any custom data/files to backup file. By default it shows "ASTETCDIR" to include *_custom.conf files into the backup. We can remove this directory as well.

Also by default, "call recording" files are not added to the Backup file. To add Call Recordings, we just need to add "__ASTSPOOLDIR__/monitor" directory as a Customer Directory.

Step 5: Select your notification preferences. If there is no email address notifications will be disabled. Note that notifications emails may be filtered as spam by your Mail Server/provider. If this happens you can typically whitelist the sender email address.

Step 6: Choose where to store the backup. You can select as many locations as desired.

If you would like to save the backup jobs like <filestore-path>/<backup-job-name>/<backup-file> then enable " " option. By default this option is set to NO which means backup file will always store to "filestore" defined path i.e. "<filestore-path>/<backup-file>"

Step 7: Run this backup automatically. To do so, set enabled to "Yes" and select the schedule. Only the options available to the selection type will be enabled. By default these are all set randomly.

Step 8: Maintenance. Backups can be limited by number of runs to only keep the last 'X' backups. They can also be kept until they reach a certain age.  For "Delete After Runs" 0 is unlimited.

Step 9: Warm Spare setup. See documentation HERE for warm spare setup.

Step 10: Save your backup.

The grid

aSelect where you want to be from the tabs
bButton to create a new backup
cThe name of your backup.
dA description of the backup
eBackup actions. Edit, Run, Show CLI command and Delete
fSearch for your backup job in cases where you have many backups to filter through.

Backup CLI:

You can copy the command from the ">_" icon and run the backup from an ssh session. A list is also available in the CLI by running 'fwconsole backup --list':

To run a backup use the "Backup ID" from the command above like this:

Restore

On a new install you can run the restore by uploading a backup file, or restore a previously saved backup on an existing install. From this window you can also download and delete stored backups.

After running or uploading a backup you will go to a confirmation screen.

Here you will see the description of the backup job to be run including the modules backed up, and choose whether to run the restore or go back to the restore page.

Restore CLI

You can restore the backup from the command line by using the '–restore' flag followed by the backup file name (depending on which directory you are located, you may want to use the full path of the backup file location, e.g. '/tmp/backup/remote-backup-1532726097.tar.gz').

Note the same warnings from the UI apply but there is no confirmation on the CLI.

Restore CLI Options which supports Current and Legacy version of backup file 

There are a few options we have added to preserve the data on the server. When you apply the following options the data on the server will be preserved 

  1. --ignoremodules
    Ignoremodules option will be skip those modules from restore process. Multiple modules are allowed here separated by commas
    e.g.: fwconsole backup --restore ./restorefile-15323456.tar.gz --ignoremodules=certman,backup
  2. --skipbindport
    Pass this option along with restore command to preserver the bindport
    e.g.: fwconsole backup --restore ./restorefile-15323456.tar.gz --skipbindport
  3. --skipdns
    Pass this option along with restore command to preserve DNS settings
    e.g.: fwconsole backup --restore ./restorefile-15323456.tar.gz --skipdns
  4. --skipremotenat
    Pass this option along with restore command to preserve NAT settings
    e.g.: fwconsole backup --restore ./restorefile-15323456.tar.gz --skipremotenat
  5. --skiptrunksandroutes
    Pass this option along with restore command to preserve existing trunk AND outbound route settings and not overwrite with restored settings.
    e.g.: fwconsole backup --restore ./restorefile-15323456.tar.gz --skiptrunkandroutes

Note that all of the above flags can be used simultaneously when executing the restore command.



15+ CLI Commands

Please refer to fwconsole commands (15+)#Backup to know details about Backup module related CLI commands applicable for FreePBX 15+ systems.


 removed/breaking change

To see what is in inside the backup files, you may check the manifest. The manifest is returned in JSON format and can be processed through automated methods. Note that backups are PHAR files and can be natively accessed through PHP's PharData class.





  • No labels