Remove a Rancher installation on NetApp HCI

Contributors netapp-pcarriga netapp-amitha Download PDF of this page

If you accidentally deploy Rancher on NetApp HCI with incorrect information (such as an incorrect Rancher server FQDN), you need to remove the installation and then redeploy. Follow these steps to remove the Rancher installation on NetApp HCI instance.

This action does not delete the user clusters.

Tip You might want to retain the user clusters. If you do retain them, you can later migrate them to another Rancher implementation. If you want to delete the user clusters, you should do that first before deleting the Rancher server; otherwise, deleting the user clusters after the Rancher server is deleted is more difficult.

Remove Rancher on NetApp HCI using NetApp Hybrid Cloud Control

You can use NetApp Hybrid Cloud Control web UI to remove the three virtual machines that were set up during deployment to host the Rancher server.

Steps
  1. Open a web browser and browse to the IP address of the management node:

    https://<ManagementNodeIP>
  2. Log in to NetApp Hybrid Cloud Control by providing the storage cluster administrator credentials.

  3. From the Dashboard, click the menu on the upper right.

  4. Select Configure.

    Rancher Configuration page
  5. In the Rancher Server Clusters pane, click Configure Rancher Server Clusters.

  6. Select the Actions menu for the Rancher installation you need to remove.

    Caution Clicking Delete immediately removes the Rancher on NetApp HCI management cluster.
  7. Select Delete.

Remove Rancher on NetApp HCI using the REST API

You can use the NetApp Hybrid Cloud Control REST API to remove the three virtual machines that were set up during deployment to host the Rancher server.

Steps
  1. Enter the management node IP address followed by /k8sdeployer/api/:

    https://[IP address]/k8sdeployer/api/
  2. Click Authorize or any lock icon and enter cluster admin credentials for permissions to use APIs.

    1. Enter the cluster user name and password.

    2. Select Request body from the type drop-down list if the value is not already selected.

    3. Enter the client ID as mnode-client if the value is not already populated.

    4. Do not enter a value for the client secret.

    5. Click Authorize to begin a session.

    6. Close the window.

  3. Close the Available authorizations dialog box.

  4. Click POST/destroy.

  5. Click Try it out.

  6. In the request body text box, enter the Rancher server FQDN as the serverURL value.

  7. Click Execute.

    After several minutes, the Rancher server virtual machines should no longer be visible in the Hosts and Clusters list in vSphere Client. After removal, you can use NetApp Hybrid Cloud Control to redeploy Rancher on NetApp HCI.

Find more Information