docs/reference/restore.md

3.4 KiB

dockerhubenterprise/dtr restore

Install and restore DTR from an existing backup

Usage

docker run -i --rm dockerhubenterprise/dtr \
    restore [command options] < backup.tar

Description

This command performs a fresh installation of DTR, and reconfigures it with configuration data from a tar file generated by the 'backup' command.

This command does not restore Docker images. You should implement a separate restore procedure for the Docker images stored in your registry, taking in consideration whether your DTR installation is configured to store images on the local filesystem or using a cloud provider.

After restoring, you can add more DTR replicas by using the the 'join' command.

Options

Option Description
--ucp-url The UCP URL including domain and port
--ucp-username The UCP administrator username
--ucp-password The UCP administrator password
--debug Enable debug mode for additional logging
--hub-username Username to use when pulling images
--hub-password Password to use when pulling images
--http-proxy The HTTP proxy used for outgoing requests
--https-proxy The HTTPS proxy used for outgoing requests
--no-proxy Don't use a proxy for these domains. Format acme.org[, acme.com]
--replica-http-port The public HTTP port for the DTR replica. Default is 80
--replica-https-port The public HTTPS port for the DTR replica. Default is 443
--log-protocol The protocol for sending container logs: tcp, tcp+tls, udp or internal. Default: internal
--log-host Endpoint to send logs to, required if --log-protocol is tcp or udp
--log-level Log level for container logs. Default: INFO
--log-tls-ca-cert PEM-encoded TLS CA cert for DTR logging driver. Ignored if the logging protocol is not tcp+tls
--log-tls-cert PEM-encoded TLS cert for DTR logging driver. Ignored if the logging protocol is not tcp+tls
--log-tls-key PEM-encoded TLS key for DTR logging driver. Ignored if the address protocol is not tcp+tls
--log-tls-skip-verify Disable TLS verification for the logging service. Ignored if the logging address is not tcp+tls
--dtr-external-url URL of the host or load balancer clients use to reach DTR. Format https://host[:port]
--dtr-storage-volume Full path or volume name to store Docker images in the local filesystem
--nfs-storage-url NFS to store Docker images. Requires NFS client libraries. Format nfs://<ip
--enable-pprof Enables pprof profiling of the server
--etcd-heartbeat-interval Frequency in milliseconds that the key-value store leader notifies followers
--etcd-election-timeout Timeout in milliseconds for key-value store membership
--etcd-snapshot-count Number of changes between key-value store snapshots
--ucp-insecure-tls Disable TLS verification for UCP
--ucp-ca Use a PEM-encoded TLS CA certificate for UCP
--ucp-node The hostname of the node to install DTR
--replica-id Assign an ID to the DTR replica. By default the ID is random
--config-only Backup/restore only the configurations of DTR and not the database