Uninstalling the Server Agent

The Server Agent can be removed from network computers in the same way you remove other program files on each of the supported platforms. The uninstall program attempts to stop the agent and then removes the client program files, services, and shortcuts.

NOTE  You should stop the agent before attempting to uninstall it.

Depending on the version of the Server Agent that you are uninstalling, including older versions, some files are left behind but can be removed manually. For example, during an MSI uninstall of Server Agent 15.2, the msvcr120.dll file is removed. However, if you are uninstalling an older, upgraded version, the uninstaller is unaware of this file and does not remove it. In addition, all of the sq3 files are also left behind intentionally. If you want to remove these files, simply delete the Venafi directory and any sub-folders.

Files

Description

msvcr120.dll

During an MSI uninstall of Server Agent version 15.2, the msvcr120.dll is removed. However, when uninstalling an upgraded version of the agent using an older MSI, the installer is not aware of the msvcr120.dll, and so it is not removed.

If you do not plan to reinstall the Server Agent, you can either delete the msvcr120.dll file from the Venafi directory, or you can delete the entire directory (which will also remove all sq3 files).

*.sq3

To make reinstall easier, all *.sq3 files are left behind during uninstall. For example, leaving the configuration files in place eliminates the need to re-register the Server Agent following an uninstall and reinstall.

If you do not plan to reinstall the Server Agent, you can either delete all of the sq3 files from the Venafi directory, or you can delete the entire Venafi directory (which will also remove the msvcr120.dll file).

On Windows systems, the uninstall does not remove the client’s local database. On Unix- and Linux-based systems, you can remove the client’s local database using the --all option—which is optional and removes all data during the uninstall process—in the uninstall command as follows:

./venafi-agent-version-platform.bundle --uninstall --all

IMPORTANT  When uninstalling a NIX bundle, you must use the bundle that matches the version you currently have installed. However, keep in mind that the bundle you have installed could be a different bundle than the one you used to deploy, which can happen in cases where the agent's were upgraded through Trust Protection Platform.

Server Agent uninstall commands

Platform

To launch the uninstall...

Supported Windows 64-bit
  1. Log in to the Windows system as a user with administrative permissions.
  2. Click Start > Control Panel > Programs and Features.
  3. Select Server Agent, and then click Uninstall.
  4. When the uninstall completes, click Finish.

AIX

./venafi-agent-24.3.0-ibm-ppc.bundle --uninstall [--all]

Solaris (SPARC)

./venafi-agent-24.3.0-sun-sparc.bundle --uninstall [--all]

RedHat Enterprise and SUSE Linux

./venafi-agent-24.3.0-linux-x86.bundle --uninstall [--all]

Linux kernel

./venafi-agent-24.3.0-linux-x86.bundle --uninstall [--all]