Revision as of 16:12, 15 November 2016

Backup and Restore

The appliance Backup and Restore menu option can be found on the Main Menu of the Appliance Console Management Interface (CMI). To access the Backup and Restore menu, login to the Appliance using PuTTY.

By default, full backups are made daily on each Swivel appliance at 4 a.m. This section details how to retrieve backups, how to produce various backup types manually and how to restore backups from both this version of the appliance and older versions.

Retrieving Backups from the Appliance

Backups can be retrieved either manually or automatically from the appliance.

Using WinSCP

Connect to the IP address or hostname of the appliance using the default credentials of Username: admin and Password: lockbox (unless you’ve changed the default password in which case use your new password)

Once connected you will be in the /home/admin/ directory. From here, navigate up to the /backups directory in the root of the disk (/).

From here you can Download the backup files. Daily backups are stored in /backups/swivel

Using FTP

From the Backup and Restore Menu, select “Configure FTP”. Enter the server, username, password and destination directory as prompted. Selecting “Forcibly Send Latest Backup Over FTP” sends the latest backup to your entries and can be used to confirm you have entered them correctly. If an FTP server is provided here, the daily backup will attempt to send the just-made backup to your FTP server just after it creates it.

Taking a Backup

Full Backup

From the Backup and Restore Menu, select “Backup”, then “Full Backup”. This backup type backs up the Tomcat config, Keystore, Webapps, External Database, Swivel home, Swivel config, networking, webmin, mon, heartbeat, sendmail, scripts, drbd, ssh, snmp, profile, user home, database config, tomcat logs.

Application Only Backup

From the Backup and Restore Menu, select “Backup”, then “Application Only Backup”. This backup type backs up the Tomcat config, the keystore, Swivel home, Webapps and the database.

System Only Backup

From the Backup and Restore Menu, select “Backup”, then “System Only Backup”. This backup type backs up the Tomcat config, the keystore, Swivel config, networking, webmin, mon, heartbeat, sendmail, scripts, drbd, ssh, snmp, profile, user home, database config and tomcat logs. Essentially, the full backup without the application-only items (but with the Tomcat configuration and keystore).

Create Restore Point

From the Backup and Restore Menu, select “Backup”, then “Create Restore Point”. This is the same as a full backup, but has a given name, is never purged, and is stored in the /backups/restore folder.

Restoring from a Backup

Full Restore

From the Backup and Restore Menu, select “Restore”, then “Full Restore”. This can attempt to restore from FULL backups stored in /backups/swivel. It tries to restore everything.

Application Only Restore

From the Backup and Restore Menu, select “Restore”, then “Application Only Restore”. This can attempt to restore from FULL or APP backups stored in /backups/swivel. It tries to restore only the Tomcat config, the keystore, Swivel home, Webapps and the database.

System Only Restore

From the Backup and Restore Menu, select “Restore”, then “System Only Restore”. This can attempt to restore from FULL or SYS backups stored in /backups/swivel. It tries to restore only the Tomcat config, the keystore, Swivel config, networking, webmin, mon, heartbeat, sendmail, scripts, drbd, ssh, snmp, profile, user home, database config and tomcat logs.

Restore Point Restore

From the Backup and Restore Menu, select “Restore”, then “Restore Point Restore”. This can attempt to restore from backups stored in /backups/restore. It tries to restore everything.

Restore from older version

Obtain a backup from the v2 appliance you wish to restore from, and place it in /backups/old (e.g. by using WinSCP).

Next, from the Backup and Restore Menu, select “Restore”, then “Restore from Older Version”.

The process will:

• Attempt to restore the Swivel Home, the keystore, the database, mon, heartbeat, snmp, drbd, the relevant items from pinsafe.conf, ssh, some networking items.
• Give you the option to replace the version of Swivel with the one found in the backup, although this is not recommended, since you may as well upgrade at this point.

For a HA Appliance Pair with ‘Appliance’ or ‘MySQL 5’ database type

Restore the backup from each appliance as above, but be sure to perform a DB Sync via the Database CMI menu afterwards. Give the machine a reboot prior to finish the restore process.

For a DR Appliance with ‘Appliance’ or ‘MySQL 5’ database type

Restore the backup as above, but be sure to perform a DB Sync with the Primary unit via the Database CMI menu afterwards. Give the machine a reboot prior to finish the restore process.

For a Single Appliance with ‘Internal’ database type

Restore the backup as above. Give the machine a reboot prior to finish the restore process.

For a Enterprise HA Appliance Pair with ‘Appliance’ or ‘MySQL 5’ database type

Restore the backup from each appliance as above, but be sure to perform a DB Sync via the Database CMI menu afterwards. Give the machine a reboot prior to finish the restore process.

Purging Old Backups

From the Backup and Restore Menu, select “Purge Old Backups”. Purging will get rid of any backups older than the number of days you specify to keep. You will be presented with the local system time and date. If the current date shown is wrong, you should proceed carefully as deletion of these backup archives cannot be undone.