Documentation forWeb Help Desk

Uninstall WHD

You may need to uninstall WHD to resolve an issue, end your evaluation, or move the application to a new server during a migration. Be sure to deactivate your WHD license before you uninstall the application.

See Install WHD to reinstall the software.

Before you begin

Before you uninstall WHD, SolarWinds recommends the following:

  1. Back up your existing database to preserve your data. If you need help with backups, check your vendor's site for documentation and instructions.

    If you have your database on a virtual machine (VM), create a snapshot or copy of your VM.

    If you need software to perform backups and maintenance for Microsoft SQL Server databases, you can install SQL Management Studio Express for your specific SQL Server version on your database server.

    Use the ollowing links to download the installation:

  2. Back up the product folders. Create copies and backups of your product folders. You may have customizations in these folders specific to your installations.

Deactivate the license

To avoid losing your license, deactivate the license before you uninstall the software. This process removes the license activation and server assignment. When you are finished, your license is parked and available when you need it.

  1. Log in to the WHD Console as an administrator.
  2. Click Setup > General > License.
  3. In License Settings, click the padlock.
  4. Click Deactivate.

Uninstall the software

Uninstall WHD based on the operating system running on the host server.

Uninstall WHD server running on Microsoft Windows Server

  1. Navigate to Windows Control Panel > Programs and Features.
  2. Right-click WHD and click Uninstall.
  3. Delete all files from the following location:

    C:\Program Files\WebHelpDesk

    If needed, run C:\Program Files\WebHelpDesk\UNINSTALL.bat as Administrator. The uninstaller stops and removes WHD-Caddy, WHD-Frontend, WHD-Backend, and WHD-PostgreSQL services, then removes application files.

    WHD is uninstalled from the server.

  4. Restart the server.

Uninstall WHD server running on macOS

Choose a method:

Uninstall using Terminal

  1. Open a terminal window.

  2. Decide whether you need to keep data and config.

    • If you don't need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh

    • If you do need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh --keep-data

  3. When prompted, type Y (yes) to complete the uninstall.

    WHD is uninstalled from the server.

  4. Restart the server.

Uninstall using GUI

  1. Open a terminal window.

  2. Decide whether you need to keep data and config.

    • If you don't need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh

    • If you do need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh --keep-data

  3. When prompted, type Y (yes) to complete the uninstall.

  4. WHD is uninstalled from the server.

  5. Restart the server.

Uninstall WHD server running on Red Hat Enterprise Linux 64-bit

  1. Open a terminal window.

  2. Decide whether to keep data and config.

    • If you don't need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh.

    • If you do need to keep data and config:

      Run: sudo bash /opt/webhelpdesk/uninstall.sh --keep-data.

  3. When prompted, type Y (yes) to complete the uninstall.

    The uninstaller stops/disables whd-caddy, whd-frontend, whd-backend, and whd-pgsql services and removes service unit files and RPM package registration:

    /opt/webhelpdesk

    WHD is uninstalled from the server.

  4. Restart the server.