Manage backup and restore

Overview

You can back up and restore the OP5 Monitor configuration from the OP5 Monitor user interface. Advanced users can perform more extensive backup and restore tasks from the command line.

Back up and restore from the OP5 Monitor user interface

Create a new backup

To back up the OP5 Monitor configuration:

  1. Click Manage > Backup/Restore.
  2. Click Save your current op5 Monitor configuration.
  3. Click Yes in the confirmation prompt to continue, or Close to exit without backing up.

    OP5 Monitor saves your new backup as a tar.gz file, including the date and time of backup:

    Note: OP5 Monitor prefixes user-created backups with backup- and system-created backups with nacoma-.

    You can now perform one of the following:

    • Download the backup by clicking on it.
    • View the contents of the backup file, restore the backup, or delete the backup, by clicking the relevant icon in the Actions column.

Restore a backup

You can restore any of the configuration backups you created previously.

To restore a backup:

  1. Manage > Backup/Restore.
  2. Click the Restore icon next to the backup you want to restore.
  3. Click Yes in the confirmation prompt to continue, or Close to exit without restoring.
  4. After restoring, OP5 Monitor prompts you to restart. Click Restart now to restart or Close to exit without applying the new configuration.

Back up and restore from the command line

OP5 Monitor comes with a backup script called op5-backup. It creates backups of the OP5 Monitor installation, but it does not back up the operating system or Logger data.

op5-backup supports local, FTP, and SFTP or SCP backups. You can save local backups to a mounted share.

For help on op5-backup, type the following command:

# op5-backup -h

Configuration file

The configuration for op5-backup is located in file /etc/op5-backup/main.conf. You can use it to configure details such as where to store backup files.

Create a backup

Create a full backup

A full backup backs up any of the following installed components:

  • op5-system
  • op5-monitor
  • op5-plugins
  • op5-logserver
  • DokuWiki
  • Trapper

To run a full backup of your OP5 server, type the following command:

# op5-backup

To run an interactive backup, use the -i option:

# op5-backup -i

OP5 Monitor stores the backup file in the location specified in the configuration file.

Create a custom backup

You can use a custom backup to include or exclude different modules from your backup.

To see a list of modules, type the following command:

# ls /etc/op5-backup/modules/legacy

To create a backup that excludes specific module types, type the following:

# op5-backup ? -<module1> -<module2>

To create a backup that includes only specific module types, type the following:

# op5-backup ? +<module1> +<module2>

Create a change arch backup

Change arch backups are used for backing up on one architecture and restoring to another, for example, backing up a 32-bit system and restoring it to a 64-bit system.

Warning: A change arch backup converts all graphs. In a large installation with a lot of history this can take up to a couple of hours.

To create a change arch backup, type the following:

# op5-backup -m charch

It is also possible to include or exclude specific modules, as described in Create a custom backup.

For example, to create a backup of the system configuration module on a 32-bit system, to be restored to a 64-bit system, type the following:

# op5-backup -m charch ? -op5-system

Restore a backup

To restore a full backup, type the following:

# op5-restore -b <path to backup file>

Caution: You must perform a full restore using a local terminal, not SSH.

Verify a backup

It is good practice to verify backups, especially manual backups.

You so this using SSH or the OP5 Monitor server console, with the following command:

# tar vft <backup-file>

The output varies, depending on the modules you backed up. For example:

rw-r r- root/root 1476847 2013-05-08 08:23 dokuwiki.tar.gz
rw-r r- root/root 514982 2013-05-08 08:23 migrate.tar.gz
rw-r r- root/root 296954 2013-05-08 08:23 nagios-plugins.tar.gz
rw-r r- root/root 1052 2013-05-08 08:23 op5-geomap.tar.gz
rw-r r- root/root 26274 2013-05-08 08:23 op5-logserver-3.tar.gz
rw-r r- root/root 27206917 2013-05-08 08:24 op5-monitor.tar.gz
rw-r r- root/root 142 2013-05-08 08:24 op5-notify.tar.gz
rw-r r- root/root 409 2013-05-08 08:24 op5-synergy.tar.gz
rw-r r- root/root 203002 2013-05-08 08:24 op5-system.tar.gz
rw-r r- root/root 1917 2013-05-08 08:24 ssh.tar.gz
rw-r r- root/root 4 2013-05-08 08:24 version
rw-r r- root/root 16 2013-05-08 08:24 timestamp
rw-r r- root/root 7 2013-05-08 08:24 architecture
rw-r r- root/root 8 2013-05-08 08:24 mode
rw-r r- root/root 7 2013-05-08 08:24 archive
drwxr-xr-x root/root 0 2013-05-08 08:24 modules/
rw-r r- root/root 147 2013-05-08 08:23 modules/op5-geomap
rw-r r- root/root 3284 2013-05-08 08:23 modules/op5-monitor
rw-r r- root/root 136 2013-05-08 08:24 modules/op5-notify
rw-r r- root/root 518 2013-05-08 08:24 modules/op5-system
rw-r r- root/root 865 2013-05-08 08:23 modules/op5-logserver-3
rw-r r- root/root 5813 2013-05-08 08:23 modules/migrate
rw-r r- root/root 116 2013-05-08 08:24 modules/ssh
rw-r r- root/root 165 2013-05-08 08:24 modules/op5-synergy
rw-r r- root/root 646 2013-05-08 08:23 modules/dokuwiki
rw-r r- root/root 177 2013-05-08 08:23 modules/nagios-plugins

Delete a backup

You delete a backup by deleting the backup file:

# rm <backup-file>

Schedule a backup using cron

You can schedule a backup on your Linux server using cron. For more information on cron, see your Linux vendor documentation.

In this example, we will schedule a backup to run daily at 1:30 AM and place the file in the /root directory. For more options, see Syntax.

  1. Open the crontab file for editing, by running the following command as root:
    # crontab -e
  2. Add the following line and save the file:
    30 01 * * * root /usr/sbin/op5-backup >/dev/null 2>&1

Syntax

# Example of job definition:
# .---------------- minute (0 - 59)
# |  .------------- hour (0 - 23)
# |  |  .---------- day of month (1 - 31)
# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
# |  |  |  |  |
# *  *  *  *  * user-name  command to be executed