Documentation

Configuration Backup and Restore

Please note that this feature is in beta testing and not yet recommended for production use

Bug reports or suggestions are always welcome on our forum

The current configuration of Rockstor can be saved at any time and restored to any previously saved point. This is a particularly useful feature when making extensive configuration changes as it provides the possibility to revert to a known good configuration. Once a configuration backup has been generated and downloaded it can also be used in system migration scenarios.

Following state information is saved as part of a backup

  • Users and Groups
  • Samba configuration
  • NFS configuration
  • AFP configuration
  • Service configurations (ntp, smartd etc..)

Since Rockstor can dynamically detects Pool, Share and Snapshot information after an external change like a reinstall, there is no need to save this information. While the above list covers the essentials of the whole state, the following state information is not currently saved to a backup. There are plans to add these states to the list of saved states in the future.

  • Appliance configurations
  • Dashboard customizations
  • Network interface settings
  • Schedule task configuration
  • Rock-on configuration

This feature is found in the Config Backups section on the System page.

_images/conf_backup.png

In the above there are no previous configuration backups.

Creating a Configuration Backup

Simply click on the Backup Current Config button and a new configuration backup will be saved and named according to the date and time it was taken.

_images/conf_backup_taken.png

This shows a single save point; It’s recommended that you download the backup and save it somewhere safe and secure. In case of a reinstall, you can upload it and restore the system to this save point as explained below.

Note the icons in the actions column. Mouse over tooltips assist with identifying these icons and their function.

Possible Actions

By using the Bin, Download, and Play icons in the action column it is possible to:-

  • Bin / dispose of a particular configuration backup
  • Download a particular backup file to you local machine
  • Play / Restore the selected configuration

Note that it is also possible to upload a previously downloaded configuration and then apply / play back that configuration.

Restoring a Configuration Backup

Restoring a previously saved configuration is done by using the Play icon in the Actions column of the chosen configuration; or by uploading a previously downloaded configuration file and then applying / playing back that configuration in the same way ie:-

_images/conf_uploaded.png

Note in the above listing we have several saved configurations.The config named my-rockstor-config5.json.gz is an example of an uploaded configuration that was renamed locally after having been downloaded previously and is now ready to be applied using the Play icon as usual.

All configuration backups are stored in zipped json format in the /opt/rockstor/static/config-backups directory