Restore from a backupEstimated reading time: 4 minutes
This topic applies to Docker Enterprise.
The Docker Enterprise platform business, including products, customers, and employees, has been acquired by Mirantis, inc., effective 13-November-2019. For more information on the acquisition and how it may affect you and your business, refer to the Docker Enterprise Customer FAQ.
Restore DTR data
If your DTR has a majority of unhealthy replicas, the one way to restore it to a working state is by restoring from an existing backup.
To restore DTR, you need to:
- Stop any DTR containers that might be running
- Restore the images from a backup
- Restore DTR metadata from a backup
- Re-fetch the vulnerability database
You need to restore DTR on the same UCP cluster where you’ve created the backup. If you restore on a different UCP cluster, all DTR resources will be owned by users that don’t exist, so you’ll not be able to manage the resources, even though they’re stored in the DTR data store.
When restoring, you need to use the same version of the
that you’ve used when creating the update. Other versions are not guaranteed
Remove DTR containers
Start by removing any DTR container that is still running:
$ docker container run \ --rm \ --tty \ --interactive \ docker/dtr:2.7.4 destroy \ --ucp-insecure-tls
If you had DTR configured to store images on the local filesystem, you can extract your backup:
sudo tar -xf dtr-image-backup.tar -C /var/lib/docker/volumes
If you’re using a different storage backend, follow the best practices recommended for that system.
Restore DTR metadata
You can restore the DTR metadata using
docker/dtr restore command. This
performs a fresh installation of DTR, and reconfigures it with
the configuration created during a backup.
Load your UCP client bundle and run the following command, replacing the placeholders for the real values:
read -sp 'ucp password: ' UCP_PASSWORD;
This prompts you for the UCP password. Next, run the following to restore DTR from your backup. You can learn more about the supported flags in docker/dtr restore .
$ docker container run \ --rm \ --interactive \ --env UCP_PASSWORD=$UCP_PASSWORD \ docker/dtr:2.7.4 restore \ --ucp-url <ucp-url> \ --ucp-insecure-tls \ --ucp-username <ucp-username> \ --ucp-node <hostname> \ --replica-id <replica-id> \ --dtr-use-default-storage \ --dtr-external-url <dtr-external-url> < dtr-metadata-backup.tar
<ucp-url>is the URL you use to access UCP
<ucp-username>is the username of a UCP administrator
<hostname>is the hostname of the node where you’ve restored the images
<replica-id>is the ID of the replica you backed up
<dtr-external-url>is the URL that clients use to access DTR
You also need at least one flag specifying the storage backend:
If you’re using a cloud storage provider, set the
flag. This flag will tell DTR to either use the cloud provider, or use local
storage if no cloud provider storage is configured.
DTR 2.5 and below
If you’re using NFS as a storage backend, also include
part of your restore command, otherwise DTR is restored but starts using a
local volume to persist your Docker images.
DTR 2.5 (with experimental online garbage collection) and DTR 2.6.0-2.6.3
When running DTR 2.5 (with experimental online garbage collection) and 2.6.0 to 2.6.3, there is an issue with reconfiguring and restoring DTR with
--nfs-storage-urlwhich leads to erased tags. Make sure to back up your DTR metadata before you proceed. To work around the
--nfs-storage-urlflag issue, manually create a storage volume on each DTR node. To restore DTR from an existing backup, use
--dtr-storage-volumeand the new volume. See Restore to a Local NFS Volume for Docker’s recommended recovery strategy.
Re-fetch the vulnerability database
If you’re scanning images, you now need to download the vulnerability database.
After you successfully restore DTR, you can join new replicas the same way you would after a fresh installation. Learn more.