Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Add Worker Nodes

Use the instructions provided in this topic to add additional worker nodes to your Routing Director deployment cluster.

A typical Routing Director deployment cluster has a minimum of four nodes with three primary and worker nodes and one worker-only node. If your deployment is running out of CPUs, memory, and/or disk space, or you are deploying more applications or scaling existing ones, you may have to increase your compute resources. You can add additional worker nodes to your existing Routing Director deployment cluster using Deployment Shell. Additional nodes help distribute workloads and also reduce the impact of a single node failure.

You must prepare and configure the additional nodes before you add it to the cluster.

Prepare the Node

To prepare a node you must create and configure the node VM.

  1. Download the OVA bundle, or the OVF and .vmdk bundle onto your computer.

  2. Log in to the hypervisor server where have installed Routing Director.

  3. Create the node VM.

    Depending on your hypervisor, perform the steps described in the following sections to create the VM.

  4. Configure the node VM

    Perform the following steps to configure the node VM.

    1. Connect to the node VM console. You are logged in as root automatically.

    2. You are prompted to change your password immediately. Enter and re-enter the new password. You are automatically logged out of the VM.

      Note:

      We recommend that you enter the same password for as the VMs in your existing cluster.

    3. When prompted, log in again as root user with the newly configured password.

    4. Configure the following information when prompted.

      Table 1: VM Configuration Wizard

      Prompt

      Action

      Do you want to set up a Hostname? (y/n)

      Enter y to configure a hostname.

      Please specify the Hostname

      Enter an identifying hostname for the VM. For example: node5. The hostname should be under 64 characters and can include alphanumeric and some special characters.

      If you do not enter a hostname, a default hostname in the format controller-<VM-IP-address-4th-octet> is assigned.

      Do you want to set up Static IP (preferred)? (y/n)

      Enter y to configure an IP address for the VM.

      Please specify the IP address in CIDR notation

      Enter the IP address in the CIDR notation. For example, 10.1.2.10/24.

      Your node VMs can be in the same subnet or in different subnets.

      Please specify the Gateway IP

      Enter the gateway IP address.

      Ensure that you enter the gateway IP address corresponding to the network of your node VM.

      Please specify the Primary DNS IP

      Enter the primary DNS IP address.

      Please specify the Secondary DNS IP

      Enter the secondary DNS IP address.

      Do you want to set up IPv6? (y/n)

      Enter y to configure IPv6 addresses.

      If you don't want to configure IPv6 addresses, enter n and proceed to Step 4.e.

      Please specify the IPv6 address in CIDR notation

      Enter the IPv6 address in the CIDR notation. For example, 2001:db8:1:2::10/64.

      Your node VMs can be in the same subnet or in different subnets.

      Please specify the Gateway IPv6

      Enter the gateway IPv6 address.

      Ensure that you enter the gateway IP address corresponding to the network of your node VM.

      Please specify the Primary DNS IPv6

      Enter the primary DNS IPv6 address.

      Please specify the Secondary DNS IPv6

      Enter the secondary DNS IPv6 address.

    5. When prompted if you are sure to proceed, review the information displayed, type y and press Enter.

      You are logged into Deployment Shell.

You have completed the node preparation steps and are ready to add the node to your cluster.

Add the Node

To add the node to your existing cluster.

  1. Log in to the installer node from which you deployed your existing Routing Director deployment cluster. You are placed in Deployment Shell, by default.

  2. Enter the configuration mode in Deployment Shell.

  3. Configure kubernetes 5 index for the worker node with the static IP address of the new node VM.

    Your index should be a number higher than the four nodes of your existing cluster.

  4. Regenerate the configuration files.

  5. Regenerate ssh keys on the cluster nodes.

    When prompted, enter the SSH password for all the existing VMs and the new VM. Enter the same password that you configured to log in to the VMs.

  6. Add the new node to the cluster.

  7. (Optional) Monitor the progress of the deployment.

See Also