Uninstalling an Open Horizon agent

To uninstall an agent from IBM Hybrid Cloud Mesh (Mesh), you must first delete the Red Hat® Service Interconnect gateway that is linked to the agent.

1. On the Gateways page in the Mesh console, click the Red Hat Service Interconnect gateway that is linked to the agent.
2. In the Connected namespaces section, click the namespace where the gateway is running.
3. On the Namespace details page, click Edit .
4. Click Disconnect, then click Next. Then click Save changes to disconnect the gateway from the namespace.
5. In the Health field on the Gateways page, check the status of the gateway.
   When the gateway has a Not deployed status, you can delete the gateway.
6. On the Edge gateway details page, click Delete gateway.
   When the gateway is deleted, the following notification is displayed:

   The <gateway name> was successfully deleted.

7. Check that the gateway is deleted.
   For example, use the palmctl CLI to run a command like this:

   palmctl get gateway --name gw1

   If the gateway was successfully deleted, output that is similar to the following example is displayed:

   [ERROR] gateway with name gw1 not found

   You can now uninstall the current agent.

8. Prepare the agent-uninstall.sh script.
   The script is located in the folder where the agent installation package was extracted to when the agent was originally installed.

   Or you can download the script by running the following command:

   wget https://raw.githubusercontent.com/open-horizon/anax/master/agent-install/agent-uninstall.sh

9. Change the permissions so that the script can run:

   chmod +x agent-uninstall.sh

10. Uninstall the agent by running the following command:

    sudo -s -E ./agent-uninstall.sh -m <agent_namespace> -k -d -u $HZN_EXCHANGE_USER_AUTH

11. Check that the agent is uninstalled by running a command like this:
    In a Kubernetes environment:

    kubectl get deployment -n <agent_namespace> agent

    In an OpenShift® Container Platform environment:

    oc get deployment -n <agent_namespace> agent

    If the agent is successfully uninstalled, the output looks like this:

    Error from server (NotFound): deployments.apps "agent" not found

    Error from server (NotFound): deployments.apps "agent" not found