From 891f9c042b7d0b1717cfbb0784aaf75da09b3d0d Mon Sep 17 00:00:00 2001 From: Sebastiaan van Steenis Date: Fri, 14 Sep 2018 19:09:51 +0200 Subject: [PATCH] Add requirement on static IPs for nodes --- content/rancher/v2.x/en/faq/technical/_index.md | 8 ++++++++ .../rancher/v2.x/en/installation/requirements/_index.md | 8 +++++++- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/content/rancher/v2.x/en/faq/technical/_index.md b/content/rancher/v2.x/en/faq/technical/_index.md index ad6ece2eb43..65efc292e8f 100644 --- a/content/rancher/v2.x/en/faq/technical/_index.md +++ b/content/rancher/v2.x/en/faq/technical/_index.md @@ -93,3 +93,11 @@ The UI consists of static files, and works based on responses of the API. That m * Visit `https://your_rancher_ip/v3` and browse the API options. * Capture the API calls when using the UI (Most commonly used for this is [Chrome Developer Tools](https://developers.google.com/web/tools/chrome-devtools/#network) but you can use anything you like) + +### The IP address of a node changed, how can I recover? + +A node is required to have a static IP configured (or a reserved IP via DHCP). If the IP of a node has changed, you will have to remove it from the cluster and readd it. After it is removed, Rancher will update the cluster to the correct state. If the cluster is no longer in `Provisioning` state, the node is removed from the cluster. + +When the IP address of the node changed, Rancher lost connection to the node, so it will be unable to clean the node properly. See [Cleaning cluster nodes]({{< baseurl >}}/rancher/v2.x/en/faq/cleaning-cluster-nodes/) to clean the node. + +When the node is removed from the cluster, and the node is cleaned, you can readd the node to the cluster. diff --git a/content/rancher/v2.x/en/installation/requirements/_index.md b/content/rancher/v2.x/en/installation/requirements/_index.md index 8ece0125632..24ae9ae5a6b 100644 --- a/content/rancher/v2.x/en/installation/requirements/_index.md +++ b/content/rancher/v2.x/en/installation/requirements/_index.md @@ -68,7 +68,13 @@ If you are using RancherOS, make sure you switch the Docker engine to a supporte [Docker Documentation: Installation Instructions](https://docs.docker.com/) {{% /tab %}} -{{% tab "Ports" %}} +{{% tab "Networking" %}} + +

Node IP address

+ +Each node used (either for the Single Node Install, High Availability (HA) Install or nodes that are used in clusters) should have a static IP configured. In case of DHCP, the nodes should have a DHCP reservation to make sure the node gets the same IP allocated. + +

Port requirements

When deploying Rancher in an HA cluster, certain ports on your nodes must be open to allow communication with Rancher. The ports that must be open change according to the type of machines hosting your cluster nodes. For example, if your are deploying Rancher on nodes hosted by an IaaS, port `22` must be open for SSH. The following diagram depicts the ports that are opened for each [cluster type]({{< baseurl >}}/rancher/v2.x/en/cluster-provisioning).