Fix install instructions

This commit is contained in:
Joao Fernandes 2016-10-06 23:38:27 -07:00
parent 68192431f4
commit c4972c812e
2 changed files with 48 additions and 20 deletions

View File

@ -43,14 +43,39 @@ install, configure, and backup DTR.
To install DTR: To install DTR:
1. Download a UCP client bundle. 1. Get the DTR package.
```bash
$ wget https://packages.docker.com/caas/ucp-2.0.0-beta1_dtr-2.1.0-beta1.tar.gz -O docker-datacenter.tar.gz
```
2. Transfer the package to the nodes.
Now that you have the DTR package in your machine, you can transfer it to the
nodes that you want to install DTR. For each node run:
```bash
$ scp docker-datacenter.tag.gz <user>@<host>:/tmp
```
3. Load the images.
Once the package is on the nodes where you want to install DTR, you can use
the `docker load` command, to load the images from the .tar file. Log
into each node where you plan on installing DTR and run:
```bash
$ docker load < /tmp/docker-datacenter.tar.gz
```
4. Download a UCP client bundle.
Having a UCP client bundle allows you to run Docker commands on a swarm Having a UCP client bundle allows you to run Docker commands on a swarm
being managed by UCP. being managed by UCP.
[Download a UCP client bundle](https://docs.docker.com/ucp/access-ucp/cli-based-access/) [Download a UCP client bundle](https://docs.docker.com/ucp/access-ucp/cli-based-access/)
and set up your CLI client to use it. and set up your CLI client to use it.
2. Run the following commands to install DTR. 5. Run the following commands to install DTR.
```bash ```bash
# Get the certificates used by UCP # Get the certificates used by UCP
@ -58,15 +83,18 @@ To install DTR:
# Install DTR # Install DTR
$ docker run -it --rm \ $ docker run -it --rm \
docker/dtr install \ docker/dtr:2.0.0-beta1 install \
--ucp-node <hostname> \
--ucp-ca "$(cat ucp-ca.pem)" --ucp-ca "$(cat ucp-ca.pem)"
``` ```
Where the `--ucp-node` is the hostname of the node where you've previously
loaded the DTR images.
The install command has other flags for customizing DTR at install time. The install command has other flags for customizing DTR at install time.
Check the [reference documentation to learn more](../reference/install.md). Check the [reference documentation to learn more](../reference/install.md).
3. Check that DTR is running. 6. Check that DTR is running.
In your browser, navigate to the the Docker **Universal Control Plane** In your browser, navigate to the the Docker **Universal Control Plane**
web UI, and navigate to the **Applications** screen. DTR should be listed web UI, and navigate to the **Applications** screen. DTR should be listed
@ -113,9 +141,11 @@ you're going to install these replicas also need to be managed by UCP.
To add replicas to a DTR cluster, use the `docker/dtr join` command. To add To add replicas to a DTR cluster, use the `docker/dtr join` command. To add
replicas: replicas:
1. Load you UCP user bundle. 1. Make sure the DTR images are loaded into the node.
2. Run the join command. 2. Load you UCP user bundle.
3. Run the join command.
When you join a replica to a DTR cluster, you need to specify the When you join a replica to a DTR cluster, you need to specify the
ID of a replica that is already part of the cluster. You can find an ID of a replica that is already part of the cluster. You can find an
@ -132,7 +162,7 @@ replicas:
--ucp-ca "$(cat ucp-ca.pem)" --ucp-ca "$(cat ucp-ca.pem)"
``` ```
3. Check that all replicas are running. 4. Check that all replicas are running.
In your browser, navigate to the the Docker **Universal Control Plane** In your browser, navigate to the the Docker **Universal Control Plane**
web UI, and navigate to the **Applications** screen. All replicas should web UI, and navigate to the **Applications** screen. All replicas should

View File

@ -27,25 +27,25 @@ copy that package to the nodes where youll install DTR.
Docker Datacenter components: Docker Datacenter components:
```bash ```bash
$ wget https://packages.docker.com/caas/ucp-1.1.2_dtr-2.0.3.tar.gz -O docker-datacenter.tar.gz $ wget https://packages.docker.com/caas/ucp-2.0.0-beta1_dtr-2.1.0-beta1.tar.gz -O docker-datacenter.tar.gz
``` ```
2. Transfer the package to the offline node. 2. Transfer the package to the offline nodes.
Now that you have the DTR package file, transfer it to the node where you Now that you have the DTR package in your machine, you can transfer it to the
want to install Docker Trusted Registry. You can use the `scp` command nodes that you want to install DTR. For each node run:
for this.
```bash ```bash
$ scp docker-datacenter.tag.gz $USER@$DTR_HOST:/tmp $ scp docker-datacenter.tag.gz <user>@<host>:/tmp
``` ```
3. Login into the host where you transferred the images. 3. Login into the nodes where you transferred the images.
4. Load the images. 4. Load the images.
Once the package is on the node where you want to install DTR, you can use Once the package is on the nodes where you want to install DTR, you can use
the `docker load` command, to load the images from the .tar file. the `docker load` command, to load the images from the .tar file. On each
node, run:
```bash ```bash
$ docker load < /tmp/docker-datacenter.tar.gz $ docker load < /tmp/docker-datacenter.tar.gz
@ -53,10 +53,8 @@ copy that package to the nodes where youll install DTR.
5. Install DTR. 5. Install DTR.
Now that the offline node has all the images needed to install UCP, Now that the offline node has all the images needed to install DTR,
you can [install DTR that host](index.md). Make sure to you can [install DTR that host](index.md).
also copy the images to any other nodes you want to install DTR
replicas onto.
## Where to go next ## Where to go next