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

4.1 KiB
Raw Blame History

title description keywords redirect_from
Deploy DDC on Linux servers Learn how to get a trial license and install Docker Datacenter datacenter, ucp, dtr, install, orchestration
/datacenter/try/

The best way to try Docker Datacenter for yourself is to get the 30-day trial available at the Docker Store.

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

  • Docker Enterprise Edition version 17.06 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 these operating systems:

  • CentOS 7.1 or 7.2
  • Red Hat Enterprise Linux 7.0, 7.1, 7.2, or 7.3
  • Ubuntu 14.04 LTS or 16.04 LTS
  • SUSE Linux Enterprise 12
  • Oracle Linux 7.3

Learn more about the Docker Datacenter system requirements

Step 1: Install Docker EE Container Engine

Install the Docker Enterprise Edition container engine on all hosts you want to manage by following these instructions.

Access Docker EE for Beta testing

For the Beta release, install Docker EE version 17.06.1-ee-1-rc4. The packages are available in the test channel of the Docker Store repo, and your Beta license gives you access to this channel. For Windows worker nodes, download the zip archive at download.docker.com.

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_latest_image }} 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.

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.

{: .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.

{: .with-border}

Click the Add Node button to add a new node.

{: .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_latest_image }} 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