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: 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 #systemctlrestart salt-masterroot@master #systemctlrestart 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.confoutside 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.txtby running the following command:cephadm@adm >ceph osd getcrushmap | crushtool -d - -o crushmap-backup.txtSamba 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.