Uninstall Gateway Hub nodes

Overview

This document guides you through how to uninstall nodes in a Gateway Hub installation. To perform uninstall commands, you need the JSON configuration file you used to install Gateway Hub.

Uninstall nodes

You can uninstall Gateway Hub using the hubctl command. This command uninstalls all the nodes specified in the installation JSON in the hosts list or linked hosts_file.

For more information about the installation JSON, see Install.

In environments where you cannot connect to all nodes in the cluster, you can remove specific nodes by editing the hosts list or linked hosts_file. This allows you to uninstall the Gateway Hub in stages.

Caution: You cannot perform partial uninstallations. Removing a node unexpectedly will break the cluster.

To uninstall Gateway Hub, run:

hubctl setup uninstall config.json

This lists the nodes selected for removal and prompt for confirmation.

######################################################
#                      WARNING!                      #
#                                                    #
# Running this command will REMOVE and DELETE all    #
# Gateway Hub binaries and data from the nodes       #
# listed below.                                      #
######################################################
hub-node.example.com

Are you sure you wish to do this? [y/N]

Performing the uninstallation stops all processes and removes all programs and data associated with Gateway Hub on each node. You must also reboot each node to ensure temporary files and other miscellanea are removed.