1. Knowledge Base
  2. Backend Operations

Zmanda Uninstall Information Consolidated

This article is for Amanda Enterprise (AE) and Zmanda Recovery Manager For MySQL (ZRM)

  • Caution: The processes in this document will require the use of commands that, if used incorrectly, can delete important files or otherwise render your computer unusable without notice. Use these commands exactly as given unless directed otherwise. Always read through these instructions thoroughly before putting them into action.*

Some programs, (notably ZRM & AE) use some of the same directories, be sure you remove only the directories containing the files you no longer need if you have these programs installed on the same machine.

Amanda Enterprise Uninstall

To uninstall the Amanda Enterprise (hereafter called AE) client or server from a *nix system, follow the steps below in the order given.

  1. Run the following command to uninstall AE.# /opt/zmanda/amanda/uninstall
  2. Remove any left over directories and files.# rm -rf /etc/amandates/ # rm -rf /etc/amanda/
    • BE SURE to make a copy of the above directory if you want to keep your old configurations prior to deleting it.
    # rm -rf /opt/zmc/ # rm -rf /opt/zmanda/ # rm -rf /var/lib/amanda/
    • BE SURE to make a copy of the above directory if you have a vtapes folder in it that contains any needed data.
  3. Find and kill any AE processes left over using the kill command below.# ps -ef |grep -e amanda -e zmc -e zmanda
  4. Once you complete the above, run the following commands to ensure that AE is completely uninstalled.# rpm -qa |grep amanda # rpm -qa |grep zmc # rpm –ga |grep zmanda

AE Manual Uninstall

Sometimes if AE is unable to finish installing or uninstalling correctly, it may be necessary to uninstall the program manually. The instructions below will help you to do this.

  1. Run the following commands as the root user to remove the AE files and folders.# rm -rf /etc/amandates/ # rm -rf /etc/amanda/
    • BE SURE to make a copy of the above directory if you want to keep your old configurations prior to deleting it.
    # rm -rf /opt/zmc/ # rm -rf /opt/zmanda/ # rm -rf /var/lib/amanda/
    • BE SURE to make a copy of the above directory if you have a vtapes folder in it that contains any needed data.
  2. Find and kill any AE processes left over using the kill command below.# ps -ef |grep -e amanda -e zmc -e zmanda
  3. Remove the following packages with your Package Manager. This will require root permissions. Commands vary per package manager, please find your system and build the command from there.
     
    • Usage Example – # yum remove zmc_aee

    RHEL/CentOS – # yum remove <PackageName>
    Debian/Ubuntu – $ sudo apt-get remove --purge <PackageName>
    SUSE – # zypper remove <PackageName>
    Fedora – # dnf remove <PackageName>
    Solaris – # /usr/sbin/pkgrm <PackageName>
    Oracle – # /#rpm -e <PackageName>
     
    • Package Names

    amanda_enterprise-backup_server
    amanda_enterprise-extensions-server
    zmc_aee
  4. Once you complete the above, run the following commands to ensure that AE is completely uninstalled.# rpm -qa |grep amanda # rpm -qa |grep zmc # rpm –ga |grep zmanda

Zmanda Recovery Manager Uninstall

To uninstall the Zmanda Recovery Manager (hereafter called ZMC) server from a *nix system, please follow these steps in the order given.

  1. Run the following command as the root user to uninstall ZRM.# /opt/zmanda/zrm/uninstall
  2. Remove any left over directories and files.# rm -rf /etc/mysql-zrm/
    • BE SURE to make a copy of /etc/mysql-zrm/mysql-zrm.conf if you want to keep your old configurations prior to deleting the above directory.
    # rm -rf /etc/zmanda/zmc/ # rm -rf /opt/zmanda/common/ # rm -rf /opt/zmanda/zrm/
  3. Find and kill any ZRM processes left over using the kill command below.# ps -ef |grep -e zrm -e zmc -e zmanda
  4. Once you complete the above please run the following commands to ensure that AE is completely uninstalled.# rpm -qa |grep zmanda # rpm -qa |grep zmc # rpm –ga |grep zrm

ZRM Manual Uninstall

Sometimes if the ZRM is unable to finish installing or uninstalling correctly, it may be necessary to uninstall the program manually. The instructions below will help you to do this.

  1. Remove any left over directories and files.# rm -rf /etc/mysql-zrm/
    • BE SURE to make a copy of /etc/mysql-zrm/mysql-zrm.conf if you want to keep your old configurations prior to deleting the above directory.
    # rm -rf /etc/zmanda/zmc/ # rm -rf /opt/zmanda/common/ # rm -rf /opt/zmanda/zrm/
    • If you no longer want to keep your backups, you will also want to remove any directories you store them in, at this time.
  2. Find and kill any ZRM processes left over using the kill command below.# ps -ef |grep -e zrm -e zmc -e zmanda
  3. Remove the following packages with your Package Manager. This will require root permissions. Commands vary per package manager but the defaults are included below, please find your system and build the command from there.
     
    • Usage Example – # yum remove zmanda-zmctools

    RHEL/CentOS – # yum remove <PackageName>
    Debian/Ubuntu – $ apt-get remove --purge <PackageName>
    SUSE – # zypper remove <PackageName>
    Fedora – # dnf remove <PackageName>
    Solaris – # /usr/sbin/pkgrm <PackageName>
    Oracle – # /#rpm -e <PackageName>
     
    • Package Names

    MySQL-zrm-enterprise
    zmanda-zmctools
    zmc_zrm
  4. Once you complete the above please run the following commands to ensure that ZRM is completely uninstalled.# rpm -qa |grep zmanda # rpm -qa |grep zmc # rpm –ga |grep zrm

Zmanda Windows Client

The Zmanda Windows Client (hereafter known as ZWC) shares code with our parent company Carbonite’s full featured program Carbonite Server Backup. For this reason sometimes “ZWC Service” or “ZWC-Database” are sometimes listed as “Carbonite Server Backup Controller” and “Carbonite Server Database” respectively. Treat these Carbonite services exactly as you would the ZWC services in these instructions.

If an attempt to uninstall the ZWC has already been made, and it failed, please proceed to “The ZWC Installation Cleanup Tool” section below.

Otherwise, follow these steps to uninstall ZWC:

  1. Open the Add/Remove Programs section of the Windows Control Panel.
  2. Locate the Zmanda Client for Windows(x64).
  3. Choose “Uninstall”.

Once the previous version has been uninstalled, you may install ZWC.

If uninstallation fails, or if you continue to receive the conflicting Zmanda product error, please manually uninstall using the ZWC Cleanup Tool as described below.

  1. Locate the folder where you installed ZWC and delete any remaining program files and folders.
    1. If you have local backups, please copy this folder to another location before deletion.
  2. If you are using Windows Vista/Server 2008 or later, also delete all files and folders in C:\ProgramData\Zmanda\Zmanda Client for Windows(x64)\.
  3. Verify if any of the ZWC services are listed in the Windows Services Panel.
  4. Stop any of those services that are running.
    1. If more than one is listed, ZWC-Database should be stopped last.
  5. Run the ZWCInstallCleanup tool from an elevated command prompt.
    1. ZWCInstallCleanUp.exe for 32-bit machines
    2. ZWCInstallCleanUp-64.exe for 64-bit machines
  6. Refresh the Services list.
    1. If all of the leftover services are gone, retry your installation.
    2. If any services remain, continue to the next step.
  7. If one or more Services are still present, you must delete the service manually from an elevated command prompt with the command: sc delete name_of_service.
    1. Remove any spaces from the service name when using the sc delete command.
    2. EXAMPLE: sc delete ZWCService
  8. There will be one of three responses to the sc delete command.
    1. ACCESS DENIED: The command was not run from an elevated command prompt. The sc delete command must be run from an elevated command prompt. Please try again.
    2. SUCCESS: Refresh the Services list. If the deleted service is still present, a reboot of the system is required to complete the removal of the service.
    3. THE SERVICE HAS BEEN MARKED FOR DELETION: A reboot of the system is required to complete the removal of the service.
  9. Once all left over services have been removed, please retry your installation.
  10. If it still fails, open an elevated command prompt.
  11. Run the ZWCInstallCleanUp tool that corresponds to the previous ZWC installation from an elevated command prompt, and add the -D argument to the end.
    1. ZWCInstallCleanup.exe -D
    2. The -D argument causes the Cleanup tool to remove everything associated with ZWC, including all files, registry entries, services, and the amandabackup user. Backups on the local disk will be deleted also if they are in the default directo