How To Restart Your Server

This page outlines the steps necessary to shut down an on-premise, multi-server installation. Read these instructions in their entirety before beginning the shutdown process.

Note: Kubernetes commands refer to servers as “nodes”; as such, this document will do the same.

  1. Connect to the first node in your maintenance window and open a command prompt.
  2. Run the following command to get a list of all nodes in the cluster: $ kubectl get nodes
    Ensure that the Status column displays a value of Ready for each node.
  1. Run the command below to cordon off the first of the nodes you are NOT currently connected to. This prevents any new pods from being scheduled on the cordoned node.
    $ kubectl cordon [NAME]
  2. Retrieve the nodes again to ensure the cordon has completed successfully by running the following command: $ kubectl get nodes
    If the cordon was successful, the Status column will display a value of Ready, SchedulingDisabled for the cordoned node.
  1. Run the command below to drain the cordoned node. This will evict all pods that are not part of daemonsets from the drained node. Kubernetes will attempt to (barring resource and affinity constraints) put the pods onto one of the other nodes in the cluster.
    $ kubectl drain [NAME] --ignore-daemonsets --delete-emptydir-data
  2. Run the following commands to ensure that the Kinetic Platform is still running:
    $ kubectl get pods -l -A -o wide
    $ kubectl get pods -n kinetic -o wide
    $ kubectl get pods -n ingress-nginx -o wide
  3. For each of the commands you run in Step 6, check the Ready column. Ensure that it contains a value of X/Y, where X and Y are the same number. This indicates that all containers are up.
  4. For each of the comments you run in Step 6, ensure that the Node column does not contain the node that we cordoned and drained. The one exception to this is the log-collector node, as it is a daemonset and will always be present on every node in the cluster.
  1. Optional: We recommend removing the node from the Load Balancer. This will guarantee that no traffic is being sent to the node that will be being restarted.
  2. Follow your usual maintenance process to restart the node you cordoned and drained.
  3. Run the following command to monitor the status of each node: kubectl get nodes -w
  4. Ensure that the node you restarted displays a Status of NotReady, SchedulingDisabled. Do not make any additional changes until the status of the restarted node changes to Ready.
  5. If you removed the node from the Load Balancer in Step 9, re-add the node back into the Load Balancer.
  6. Repeat Steps 1 through 11 for the each additional node in your maintenance cycle.

    Make sure you shell into a different node before repeating the above steps for the node you shelled into in Step 1.