查看“备份和还原模块配置”的源代码

'''Using the Backup module'''

THIS WIKI HAS BEEN UPDATED FOR VERSION 13 OF YOUR PBX GUI.


'''Overview'''

It is critical that you have a backup procedure in place. We offer a support&nbsp;package that includes automated offsite backups.&nbsp;This module is used to backup your PBX phone system settings and configurations. If you have&nbsp;a support contract that includes offsite backups, the backup will be defined here. Please do not&nbsp;remove or edit the backup marked "Schmooze POMPs", or your backups will no longer be sent to us&nbsp;for offsite storage.

Backing up your PBX is a crucial step in the setup process. You have several ways to automate this&nbsp;process, or you can do an "on the fly" backup as needed.

'''Logging in'''

Logging into the Backup and Restore module and you will see a screen like the one below.&nbsp;

* On the top menu click '''Admin'''
* In the drop down click '''Backup & Restore'''

On the right side you will see a list of all the different sections of the backup module on the top.

At&nbsp;the bottom of the list will be all the current backup jobs you have created.

http://wiki.freepbx.org/download/attachments/26509506/backup-restore-home-screen.png

'''Backups'''

The Backups section of the backup module is where you actually define a backup job.&nbsp;You can create as many backup jobs as you want and set when and how often they should run,&nbsp;what should be included in the backup, and where to store it.

'''Restores'''

The Restore section of the backup module is where you restore from a backup.&nbsp;You can restore from a backup on your local computer or from any defined FTP, SSH or Local&nbsp;storage server.

'''Servers'''

The Servers section is where you define any PBX servers or database tables that you want to backup configurations from. You also define Linux boxes or FTP servers you want to&nbsp;store the backups on.

'''Templates'''

Templates are used to create groups of files, directories, or databases that you want to include in a backup. We have defined some standard templates for you already, but you can&nbsp;add your own custom templates. When creating a backup job, you can drag one or&nbsp;more templates into it to define what is going to be backed up.

'''Backup Settings'''

Click the '''New Backup''' button to create a new backup, or click an existing backup to edit its settings.

http://wiki.freepbx.org/download/attachments/26509506/backup-name-description.png

'''Backup Name'''

Give your backup job a name to easily identify it.

'''Description'''

Here you can optionally define a longer description or add notes.

'''Status Email'''

If defined, the system will send status updates to this e-mail address when the backup task is run.

'''Backup Items'''

http://wiki.freepbx.org/download/attachments/26509506/backup-items-drag-list.png

'''Items'''

This is where you choose what will actually be backed up. On the right side you&nbsp;will see a list of standard templates that are included with your PBX. The most standard&nbsp;template you would want to use for a normal daily backup is the&nbsp;'''Full Backup'''.

To include the full backup template, drag it from the&nbsp;'''Templates''' bin to the&nbsp;'''Items&nbsp;'''bin.

APPLICATION NOTE

Advanced users can also press http://wiki.freepbx.org/download/attachments/26509506/plus-sign.png to add your own files or directory paths to be included in a backup.

Please see templates section on how to modify or create your own templates.

Once you add an item, you will see the items that will be backed up, as well as any exclusions:

http://wiki.freepbx.org/download/attachments/26509506/backup-items.png

APPLICATION NOTE

The Full Backup template does not include any voicemails, custom music on hold, or system prompt recordings. If you want these to be included, drag the “System Audio” and “Voicemail Templates” from the '''Templates''' bin to the '''Items''' bin.

'''Hooks'''

Hooks allow you to base the backup job on the following actions in order to execute a custom&nbsp;script at the location defined for each action. This is for advanced users who would like to customize the following actions.

APPLICATION NOTE

Make sure your script has execute&nbsp;permissions for the Asterisk user.

http://wiki.freepbx.org/download/attachments/26509506/backup-hooks.png

'''Pre-Backup Hook'''

Hook to run before starting the actual backup.

'''Post-Backup Hook'''

Hook to run after completing the backup.

'''Pre-Restore Hook'''

Hook to run before starting the actual restore of the backup.

'''Post-Restore Hook'''

Hook to run after completing the restore of the backup.

'''Backup Server'''

This is where you choose which server to back up. This can be&nbsp;the local PBX that the backup module is on, or it could be another PBX as defined in the&nbsp;servers section of the backup module. Please see the server section for more information&nbsp;on defining other servers. Most of the time you will pick “This Server,” since that is&nbsp;what we want to back up.

http://wiki.freepbx.org/download/attachments/26509506/backup-server.png

'''''''''Storage Location'''

Storage locations are servers that have been set up to store the actual backup on. By&nbsp;default we include the local server as a storage location.

Local Storage: The backup tarball file is stored in "/var/spool/asterisk/backup/(backupjobname)/*.tgz" on the local machine

The&nbsp;'''Available Servers''' list shows servers that have been set up to store the backup&nbsp;as defined in the servers section of the backup module. Please see server section for&nbsp;more information on defining other servers.

http://wiki.freepbx.org/download/attachments/26509506/storage-servers.png

The '''Storage Servers''' list defines where to store the backups. Drag one or more storage servers from the&nbsp;'''Available Servers''' bin to the&nbsp;'''Storage Servers''' bin.

http://wiki.freepbx.org/download/attachments/26509506/selected-server.png

'''Backup Schedule'''

http://wiki.freepbx.org/download/attachments/26509506/backup-schedule.png

'''Never'''

Never run the backup

'''Hourly'''

Every hour at the top of the hour

'''Daily'''

Every day at midnight

'''Weekly'''

Every Sunday at midnight

'''Monthly'''

This first of each month at midnight

'''Annually'''

January 1st at midnight

'''Reboot'''

On a reboot command of the PBX an upgrade will be run.

'''Custom'''

Allows you to define your own schedule on when to run upgrades.

http://wiki.freepbx.org/download/attachments/26509506/custom-backup-schedule.png

'''Maintenance'''

Here we can define how many copies of the backup we want to keep and when they should&nbsp;be deleted

http://wiki.freepbx.org/download/attachments/26509506/maintenance.png

'''Delete After Time Frame'''

Here you can define increments, for example delete after 3&nbsp;months or 5 weeks.

'''Delete After Runs'''

Here you can define how many copies of the backup to delete versus&nbsp;deleting backups by time frame such as only keep fifteen. On the 16th backup the oldest&nbsp;backup will be deleted from the system. We recommend keeping 7-10 backups only to&nbsp;conserve hard drive space

'''Save'''

When you have things the way you want them, click the&nbsp;'''Save''' button.

http://wiki.freepbx.org/download/attachments/26509506/save-button.png

'''Run'''

You can manually run your backup at any time by visiting the '''Backups''' section and clicking the run button http://wiki.freepbx.org/download/attachments/26509506/backup-in-list.png

http://wiki.freepbx.org/download/attachments/26509506/backup-status.png



When you do this, a window will pop-up displaying the status of the backup.&nbsp;You should see "'''Backup successfully completed!'''"


'''Restore'''

In the Restore section, you can select a server to restore the backup from, or select a backup file on your local computer.

'''Restoring from a Server'''

Available servers are shown at the bottom of the list on the right side of the screen. Select a server.

http://wiki.freepbx.org/download/thumbnails/26509506/server-list-restore-from.png

Available backups will be displayed. Browse the folders to view available files.

http://wiki.freepbx.org/download/attachments/26509506/list-of-files.png

Browse the folders and select a backup to restore from. More details will be shown to the right.

http://wiki.freepbx.org/download/attachments/26509506/backup-to-restore-from.png

Click the&nbsp;'''Go!''' button. You will be taken to a page where you can select which items to restore.

Use the checkboxes to select which items you would like to restore, then click the&nbsp;'''Restore''' button.

http://wiki.freepbx.org/download/attachments/26509506/restore-selections.png

A window will pop up showing the status of the restore.

http://wiki.freepbx.org/download/attachments/26509506/running-restore.png

The status window will say&nbsp;'''Done!''' when the restore is complete.

http://wiki.freepbx.org/download/attachments/26509506/restore-complete.png

'''Restoring from a Local File'''

You can upload a backup file from your local computer if you have it stored on the same computer you are using to log into the Backup & Restore module.

In the '''Restore''' section of the Backup & Restore module, click the '''Browse''' button.

http://wiki.freepbx.org/download/thumbnails/26509506/browse-button.png

Select a file from your local computer.

Click the&nbsp;'''Restore''' button to begin the restore process.&nbsp;You will be taken to a page where you can select which items to restore.

Use the checkboxes to select which items you would like to restore, then click the&nbsp;'''Restore''' button.
http://wiki.freepbx.org/download/attachments/26509506/restore-selections.png

A window will pop up showing the status of the restore.

http://wiki.freepbx.org/download/attachments/26509506/running-restore.png

The status window will say&nbsp;'''Done!''' when the restore is complete.

http://wiki.freepbx.org/download/attachments/26509506/restore-complete.png

'''Servers'''

The Servers section shows the servers that have been created and allows you to create new&nbsp;servers.

http://wiki.freepbx.org/download/attachments/26509506/servers-main-page.png

'''Backup Server Types'''

'''Email'''

Sends a backup file as an email attachment.

'''FTP'''

Sends a backup file to an FTP server. The backup can be directly restored from the FTP server.

'''Local'''

This is the local PBX (server) that the backup is stored on. The backup job will be performed on this local server and can be restored from here as well.

'''MySQL Server'''

This is where we define where the MySQL server is located and how to log&nbsp;into it so we can back up the database.

'''SSH Server'''

This could be another PBX that you log into and perform the backup on. For&nbsp;example, if you have a warm spare backup box, you would set up the backup job on the warm spare to log into the production server, perform the backup on the production server, and then&nbsp;move the backup file to the backup server and restore it on a nightly basis.

APPLICATION NOTE

You can also define a SSH server for storing backups just like an FTP server, and using SCP to copy the files over to the SSH server. Any Linux box that supports SCP can be an SSH Server.

&nbsp;

'''Templates'''

The Templates section shows the templates that have been created and allows you to create or edit templates.

http://wiki.freepbx.org/download/attachments/26509506/templates-list.png

Templates that were included at install cannot be modified. You can create your own templates, but&nbsp;there typically is no need for this unless you need to want to simplify the process of including custom files, directories, or databases in a backup. You can create a template for the custom files, then drag that template into a backup job instead of adding the custom files to the backup one-by-one.

'''''''''Creating a Template'''

In the Templates section of the Backup & Restore module, click the&nbsp;'''New Template''' button.

When creating a template you will need to give it a name and optionally, a description.

http://wiki.freepbx.org/download/attachments/26509506/backup-template-name-desc.png

Click the plus sign button 
http://wiki.freepbx.org/download/attachments/26509506/plus-sign.png 
select which files, directories or databases will be included. Select the item type and then fill in the appropriate fields. Repeat the process for each type of item you would like to add to the template.

http://wiki.freepbx.org/download/attachments/26509506/menu-options-template.png



''The example below shows the four types of items that can be chosen from the drop-down menu.''

http://wiki.freepbx.org/download/attachments/26509506/template-custom-items.png

Click the&nbsp;'''Save''' button when finished.
http://wiki.freepbx.org/download/attachments/26509506/save-button.png

&nbsp;