diff --git a/ee/ucp/admin/configure/_site/join-nodes/join-linux-nodes-to-cluster.html b/ee/ucp/admin/configure/_site/join-nodes/join-linux-nodes-to-cluster.html deleted file mode 100644 index d0836ae5c0..0000000000 --- a/ee/ucp/admin/configure/_site/join-nodes/join-linux-nodes-to-cluster.html +++ /dev/null @@ -1,143 +0,0 @@ -

Docker EE is designed for scaling horizontally as your applications grow in -size and usage. You can add or remove nodes from the cluster to scale it -to your needs. You can join Windows Server 2016, IBM z System, and Linux nodes -to the cluster.

- -

Because Docker EE leverages the clustering functionality provided by Docker -Engine, you use the docker swarm join -command to add more nodes to your cluster. When you join a new node, Docker EE -services start running on the node automatically.

- -

Node roles

- -

When you join a node to a cluster, you specify its role: manager or worker.

- - - -

Join a node to the cluster

- -

You can join Windows Server 2016, IBM z System, and Linux nodes to the cluster, -but only Linux nodes can be managers.

- -

To join nodes to the cluster, go to the Docker EE web UI and navigate to the -Nodes page.

- -
    -
  1. Click Add Node to add a new node.
  2. -
  3. Select the type of node to add, Windows or Linux.
  4. -
  5. Click Manager if you want to add the node as a manager.
  6. -
  7. Check the Use a custom listen address option to specify the address -and port where new node listens for inbound cluster management traffic.
  8. -
  9. Check the Use a custom listen address option to specify the -IP address that’s advertised to all members of the cluster for API access.
  10. -
- -

- -

Copy the displayed command, use SSH to log in to the host that you want to -join to the cluster, and run the docker swarm join command on the host.

- -

To add a Windows node, click Windows and follow the instructions in -Join Windows worker nodes to a cluster.

- -

After you run the join command in the node, the node is displayed on the -Nodes page in the Docker EE web UI. From there, you can change the node’s -cluster configuration, including its assigned orchestrator type. -Learn how to change the orchestrator for a node.

- -

Pause or drain a node

- -

Once a node is part of the cluster, you can configure the node’s availability -so that it is:

- - - -

Pause or drain a node from the Edit Node page:

- -
    -
  1. In the Docker EE web UI, browse to the Nodes page and select the node.
  2. -
  3. In the details pane, click Configure and select Details to open -the Edit Node page.
  4. -
  5. In the Availability section, click Active, Pause, or Drain.
  6. -
  7. Click Save to change the availability of the node.
  8. -
- -

- -

Promote or demote a node

- -

You can promote worker nodes to managers to make UCP fault tolerant. You can -also demote a manager node into a worker.

- -

To promote or demote a manager node:

- -
    -
  1. Navigate to the Nodes page, and click the node that you want to demote.
  2. -
  3. In the details pane, click Configure and select Details to open -the Edit Node page.
  4. -
  5. In the Role section, click Manager or Worker.
  6. -
  7. Click Save and wait until the operation completes.
  8. -
  9. Navigate to the Nodes page, and confirm that the node role has changed.
  10. -
- -

If you’re load-balancing user requests to Docker EE across multiple manager -nodes, don’t forget to remove these nodes from your load-balancing pool when -you demote them to workers.

- -

Remove a node from the cluster

- -

You can remove worker nodes from the cluster at any time:

- -
    -
  1. Navigate to the Nodes page and select the node.
  2. -
  3. In the details pane, click Actions and select Remove.
  4. -
  5. Click Confirm when you’re prompted.
  6. -
- -

Since manager nodes are important to the cluster overall health, you need to -be careful when removing one from the cluster.

- -

To remove a manager node:

- -
    -
  1. Make sure all nodes in the cluster are healthy. Don’t remove manager nodes -if that’s not the case.
  2. -
  3. Demote the manager node into a worker.
  4. -
  5. Now you can remove that node from the cluster.
  6. -
- -

Use the CLI to manage your nodes

- -

You can use the Docker CLI client to manage your nodes from the CLI. To do -this, configure your Docker CLI client with a UCP client bundle.

- -

Once you do that, you can start managing your UCP nodes:

- -
docker node ls
-