docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Improves docs for upgrading 

* fixes #1880
This commit is contained in:
Joao Fernandes 2016-05-04 15:01:47 -07:00
parent 53acf5b769
commit 080d64bf75
1 changed files with 36 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
install/upgrade/upgrade-major.md
View File

@ -52,46 +52,56 @@ For this, you can use the `docker/dtr migrate` command. This command
migrates configurations, accounts, and repository metadata. It doesn't migrate migrates configurations, accounts, and repository metadata. It doesn't migrate
the images that are on the storage backend used by DTR 1.4.3. the images that are on the storage backend used by DTR 1.4.3.
To find what options are available on the migrate command, check the reference To start the migration:
documentation, or run:
```bash 1. Log into the host running DTR 1.4.3 using ssh.
$ docker run --rm -it docker/dtr migrate --help
```
To start the migration, on the host running DTR 1.4.3, run: 2. Use the docker/dtr migrate command.
```bash When you run the docker/dtr migrate command, Docker pulls the necessary
# Get the certificates used by UCP images from Docker Hub. If the the host where DTR 1.4.3 is not connected
$ curl https://$UCP_HOST/ca > ucpca.crt to the internet, you need to
[download the images to the host](../install-dtr-offline.md).
# Get the certificates used by DTR 2.0 from the settings page Then run the migrate command:
# Migrate configurations, accounts, and repository metadata ```bash
docker run -it --rm \ # Get the certificates used by UCP
-v /var/run/docker.sock:/var/run/docker.sock \ $ curl https://$UCP_HOST/ca > ucpca.crt
docker/dtr migrate \
--ucp-url $UCP_HOST --ucp-ca "$(cat ucpca.crt)" \
--dtr-load-balancer https://$DTR_HOST --dtr-ca "$(cat dtrca.crt)"
```
## Step 4. Test your installation # Migrate configurations, accounts, and repository metadata
docker run -it --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
docker/dtr migrate \
--ucp-url $UCP_HOST --ucp-ca "$(cat ucpca.crt)" \
--dtr-load-balancer https://$DTR_HOST \
--dtr-ca "$(cat dtrca.crt)"
```
## Step 4. Validate your configurations
After the migration finishes, test your DTR 2.0 installation to make sure it is After the migration finishes, test your DTR 2.0 installation to make sure it is
properly configured. properly configured.
In your browser navigate to the DTR **Settings page**, and check that DTR 2.0: In your browser navigate to the DTR 2.0 **Settings page**, and check that DTR:
* Is correctly licensed, * Is correctly licensed,
* The storage backend is correctly configured, * The storage backend is correctly configured,
* User authentication is correctly configured. * The user authentication method is correctly configured.
You need to manually transfer the following settings: You need to manually configure the following settings:
* Domain name
* Certificates
You should also validate that you can now push and pull images to DTR 2.0. * Domain name,
* Certificates.
## Step 5. join replicas to your cluster You can find the certificates of DTR 1.4.3 under `/usr/local/etc/dtr/ssl`.
## Step 5. Test your installation
Now that you have a working installation of DTR 2.0, you should test that you
can push and pull images to it.
[Learn how to push and pull images](../../repos-and-images/push-and-pull-images.md).
## Step 6. Join replicas to your cluster
This step is optional. This step is optional.
@ -149,7 +159,7 @@ replicas:
3, 5, or 7 replicas. 3, 5, or 7 replicas.
[Learn more about high availability](../../high-availability/high-availability.md) [Learn more about high availability](../../high-availability/high-availability.md)
## Step 6. Decommission DTR 1.4.3 ## Step 7. Decommission DTR 1.4.3
Once you've fully tested your new installation, you can uninstall DTR 1.4.3 Once you've fully tested your new installation, you can uninstall DTR 1.4.3
by deleting `/usr/local/etc/dtr` and `/var/local/dtr` and removing all dtr by deleting `/usr/local/etc/dtr` and `/var/local/dtr` and removing all dtr