Skip to content

Latest commit

 

History

History
106 lines (74 loc) · 3.86 KB

end-to-end-install.md

File metadata and controls

106 lines (74 loc) · 3.86 KB
title description keywords redirect_from
Deploy Enterprise Edition on Linux servers
Learn how to get a trial license and install Docker Enterprise Edition.
ucp, dtr, install, orchestration
/datacenter/try/
/datacenter/install/linux/

The best way to try Docker Enterprise Edition for yourself is to get the 30-day trial available at the Docker hub.

Once you get your trial license, you can install Docker EE on your Linux servers. Make sure all the hosts you want to manage with Docker EE have a minimum of:

  • Docker Enterprise Edition 17.06.2-ee-8. Values of n in the -ee- suffix must be 8 or higher
  • Linux kernel version 3.10 or higher
  • 4.00 GB of RAM
  • 3.00 GB of available disk space

Also, make sure the hosts are running one of the supported operating systems from the Compatibility Matrix.

Learn more about Docker EE system requirements.

Step 1: Install Docker EE Container Engine

Select a platform and click through to install the Docker Enterprise Edition container engine on all hosts you want to manage.

Step 2: Install Universal Control Plane

Docker Universal Control Plane (UCP) allows managing from a centralized place your images, applications, networks, and other computing resources.

Use ssh to log in to the host where you want to install UCP and run:

docker container run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  {{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }} install \
  --host-address <node-ip-address> \
  --interactive

This runs the install command in interactive mode, so that you're prompted for any necessary configuration values.

Learn more about the UCP installation.

What about Windows? When you have UCP installed, you can join Windows worker nodes to a swarm.

Step 3: License your installation

Now that UCP is installed, you need to license it. In your browser, navigate to the UCP web UI, log in with your administrator credentials and upload your license.

UCP login page{: .with-border}

Get a free trial license if you don't have one.

Step 4: Join more nodes to UCP

Join more nodes so that you can manage them from UCP. Go to the UCP web UI and navigate to the Nodes page.

Nodes page{: .with-border}

Click the Add Node button to add a new node.

Add node page{: .with-border}

Check Add node as a manager to join the node as a manager to provide replication and make UCP highly available. For a highly available installation, make sure you have 3, 5, or 7 manager nodes.

Copy the command to your clipboard, and run it on every node that you want to be managed by UCP. After you run the command in the node, the node will show up in the UP web UI.

Step 5: Install Docker Trusted Registry

Docker Trusted Registry (DTR) is a private image registry so that you can manage who has access to your Docker images. DTR needs to be installed on a node that is being managed by UCP.

Use ssh to log in to the host where you already installed UCP, and run:

docker container run -it --rm \
  {{ page.ucp_org }}/{{ page.dtr_repo }}:{{ page.dtr_version }} install \
  --ucp-node <node-hostname> \
  --ucp-insecure-tls

Where the --ucp-node is the hostname of the UCP node where you want to deploy DTR. --ucp-insecure-tls tells the installer to trust the certificates used by UCP.

Where to go next