6.7. Backing Up and Restoring Management Database¶
Node information, statistics, and configurations are stored in a database on the management node (the one with the admin panel). Backups of this database are created automatically via a daily
cron job that starts at 3:00 a.m. If the management node is not highly available, restoring such a backup recovers the node in case of failure or database corruption. Backup files are stored in the
/mnt/vstorage/webcp/backup/ directory. The retention policy for management node backups is as follows:
- All backups created within the last day are kept.
- From backups created within the last 7 days, the newest for each day is kept.
- From backups created within the last 7-14 days, the oldest one is kept.
- From backups created within the last 14-45 days, the oldest for each week is kept.
- Backups older than 45 days are deleted.
Database backups cannot be restored if management node high availability is enabled.
To back up the database manually, open the SETTINGS > Management node > BACKUP screen and click BACKUP NOW.
Once backup is completed, the Last backup date will be refreshed.
Do not rename the backup file! Otherwise you will not be able to restore the management database from it.
6.7.1. Restoring Management Database from Backup¶
You can restore a management node database from backup on the same management node or any node in the storage cluster.
vstorage-ui-backend service must be running on a single node in the storage cluster. If the management node database is restored on a different node, the previous management node must be re-deployed.
Run the following script on the node where the MN database will be restored:
# /usr/libexec/vstorage-ui-backend/bin/restore-management-node.sh \ -x <public_net_iface> -i <private_net_iface> \ -f /mnt/vstorage/webcp/backup/<backup_file>
<private_net_iface> are interfaces assigned the public and private networks, respectively. If required, you can specify the same network interface in both parameters. If the
-f option is omitted, the management node database will be restored from the latest backup.
To access the admin panel, use the public IP address of the node with the restored MN database.
126.96.36.199. Restoring with Existing Compute Cluster¶
If you have the compute cluster deployed, the management node database must be restored only on one of the compute nodes.
When restoring the MN database with the compute cluster, note the following limitations:
- If you create compute objects after the backup, they will be lost.
- If you modify or delete compute objects after the backup, they will be restored as follows:
- Compute objects used as configurations (flavors, storage policies, virtual networks, SSH keys) will be fully restored.
- All other compute objects (VMs, volumes, images, etc.) will be partially restored. They will be shown in the admin panel but unusable. You will only be able to remove them from the admin panel.
To restore the MN database on a compute node, run the restoration script with the
# /usr/libexec/vstorage-ui-backend/bin/restore-management-node.sh \ -x <public_net_iface> -i <private_net_iface> -n
<private_net_iface>are interfaces assigned the public and private networks, respectively.
-foption is omitted to restore the MN database from the latest backup.
-noption denotes that the compute cluster will be reconfigured to use another management node.
If you restore the MN database on the same node, omit the
After restoration, virtual machines that resided on the failed management node will be unmanageable in the admin panel and can only be deleted. However, you can rescue them using the
vinfra tool as follows:
- VMs with disabled high availability will appear in the “Active” state: evacuate them using the
vinfra service compute server evacuatecommand;
- VMs with enabled high availability will appear in the “Rebuild” state: first reset their state with the
vinfra service compute server reset-statecommand and then evacuate them running
vinfra service compute server evacuate.