Uninstalling a ZeroLock® Agent

The three methods with which to uninstall the ZeroLock Agent.

There are three (3) ways that an Agent can be uninstalled:

1.  ZeroLock Management Console

2.  Remove the Agent Container

3.  Command Line

ZeroLock Management Console

Using the ZeroLock Management Console (ZMC) there are two options with which to stop an Agent:  Deactivate or Uninstall.  On the ZeroLock dashboard scroll down to ENDPOINTS and select which agent you want to stop/uninstall by checking the box next to the endpoint.

Once the endpoint has been selected, from the ACTIONS drop-down menu select the action you want to perform. 

Selecting Deactivate Endpoint Protection will turn off but NOT uninstall the agent.   This option allows the reactivation of the agent and subsequent protection of the endpoint.  The endpoint status light will briefly turn red indicating the endpoint is offline and unprotected. The status will quickly change to yellow meaning it’s connected but unprotected.

The endpoint visual indicator at the top right of the screen will reflect the status of the endpoints. 

Selecting Activate Endpoint Protection from the ACTIONS menu will immediately return the endpoint to a state of protection (status=green).

Uninstall Endpoint Agent will immediately place the endpoint offline and in unprotected (status=red).  To re-install the agent, follow the steps outlined in ZeroLock Agent Installation.

On selection of Uninstall Endpoint Agent, a warning appears requiring selecting the Uninstall button to proceed.

Removing Agent Container

Complete the following steps to remove the ZeroLock agent container from an Endpoint.

1. On a terminal connected to the endpoint, stop the ZeroLock agent container.          Command: docker stop zerolock
2. If connected using SSH, the session will close when the agent is stopped in step 1 so you must reconnect.
3. Remove the container:    docker rm zerolock
4. Remove the docker volume:    docker volume rm zerolock_opt
5. Reboot

Command Line

To ensure the least disruption to the endpoint, uninstalling the ZeroLock Agent requires a three-step process.  First, we disable the ZeroLock service, reboot and then uninstall.

The steps below will walk you through this process.

1. On a terminal connected to the endpoint.
2. Disable the ZeroLock Agent:    sudo systemctl disable zerolock.service
3. Reboot endpoint:    sudo reboot
4. Once the reboot is complete, open a terminal session back to the endpoint.
5. Uninstall the ZeroLock agent:  

        Centos: sudo yum remove zerolock

        Ubuntu: sudo apt remove zerolock