This is a draft document that was built and uploaded automatically. It may document beta software and be incomplete or even incorrect. Use this document at your own risk.

Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
Administration Guide / Cluster Management / Backing Up Cluster Configuration and Data
Applies to SUSE Enterprise Storage 6

3 Backing Up Cluster Configuration and Data

This chapter explains which parts of the Ceph cluster you should back up in order to be able to restore its functionality.

3.1 Back Up Ceph Configuration

Back up the /etc/ceph directory. It contains crucial cluster configuration. You will need the backup of /etc/ceph for example when you need to replace the Admin Node.

3.2 Back Up Salt Configuration

You need to back up the /etc/salt/ directory. It contains the Salt configuration files, for example the Salt master key and accepted client keys.

The Salt files are not strictly required for backing up the Admin Node, but make redeploying the Salt cluster easier. If there is no backup of these files, the Salt minions need to be registered again at the new Admin Node.

Note
Note: Security of the Salt Master Private Key

Make sure that the backup of the Salt master private key is stored in a safe location. The Salt master key can be used to manipulate all cluster nodes.

After restoring the /etc/salt directory from a backup, restart the Salt services:

root@master # systemctl restart salt-master
root@master # systemctl restart salt-minion

3.3 Back Up DeepSea Configuration

All files required by DeepSea are stored in /srv/pillar/, /srv/salt/ and /etc/salt/master.d.

If you need to redeploy the Admin Node, install the DeepSea package on the new node and move the backed up data back into the directories. DeepSea can then be used again without any further changes being required. Before using DeepSea again, make sure that all Salt minions are correctly registered on the Admin Node.

3.4 Back Up Custom Configurations

  • Prometheus data and customization.

  • Grafana customization.

  • Verify that you have a record of existing openATTIC users so that you can create new accounts for these users in the Ceph Dashboard.

  • Manual changes to ceph.conf outside of DeepSea.

  • Manual changes to the iSCSI configuration outside of DeepSea.

  • Ceph keys.

  • CRUSH Map and CRUSH rules. Save the decompiled CRUSH Map including CRUSH rules into crushmap-backup.txt by running the following command:

    cephadm@adm > ceph osd getcrushmap | crushtool -d - -o crushmap-backup.txt
  • Samba Gateway configuration. If you are using a single gateway, backup /etc/samba/smb.conf. If you are using HA setup, backup also CTDB and Pacemaker configuration files. Refer to Chapter 29, Exporting Ceph Data via Samba for details on what configuration is used by Samba Gateways.

  • NFS Ganesha configuration. Only needed when using HA setup. Refer to Chapter 30, NFS Ganesha: Export Ceph Data via NFS for details on what configuration is used by NFS Ganesha.