Rapid Recovery 6.3 - Installation and Upgrade Guide

Uninstalling the AppAssure Agent software from a Linux machine

1. Open a terminal session with root access.
2. If you do not have access to the installer script, proceed to step 6.
3. If you have access to the installer script, change to the directory that includes the AppAssure installation script, for example:
   cd /home/AppAssure/
4. Run the following command to identify the specific build number of the Agent software you want to remove:

   cat /var/log/appassure/appassure*.log | grep "Agent Version" | awk '{print $3}' | tail -n1

   For example, you may have AppAssure Agent version 5.4.3.106 installed.
5. Based on the Linux distribution installed, run the following command, modifying it to specify the build number you identified in the previous step:

   Distribution	Command
   RHEL and CentOS	bash appassure-installer_rhel_amd64_5.x.x.xxxxx.sh -u
   SLES	bash appassure-installer_sles_amd64_5.x.x.xxxxx.sh -u
   Ubuntu	bash appassure-installer_ubuntu_amd64_5.x.x.xxxxx.sh -u

   For example, if uninstalling AppAssure Agent version 5.4.3.106, the modified command is:

   • For 32-bit RHEL or CentOS:
     bash appassure-installer_ubuntu_i386_5.4.3.106.sh -u
   • For 64-bit RHEL or CentOS:
     bash appassure-installer_ubuntu_amd64_5.4.3.106.sh -u
   • For 32-bit SUSE Linux Enterprise Server (SLES):
     bash appassure-installer_sles_i386_5.4.3.106.sh -u
   • For 64-bit SLES:
     bash appassure-installer_sles_amd64_5.4.3.106.sh -u
   • For 32-bit Debian and Ubuntu:
     bash appassure-installer_ubuntu_i386_5.4.3.106.sh -u
   • For 64-bit Debian and Ubuntu:
     bash appassure-installer_ubuntu_amd64_5.4.3.106.sh -u
   The system removes the AppAssure Agent files and directories.
6. Alternatively, to remove the AppAssure Agent software manually without the use of the script, run one of the commands below:
   1. For Debian and Ubuntu: dpkg --force-all -P appassure-vss appassure-vdisk appassure-mono appassure-agent
   2. For CentOS, Oracle Linux, RHEL, and SLES: rpm --nodeps -e appassure-vss appassure-agent appassure-mono appassure-vdisk
   The AppAssure Agent components specified are removed from the system.

Backing up and restoring the AppAssure agent ID

1. On the Linux machine from which you intend to remove AppAssure Agent, open a command prompt. Type the following command and then press Enter:
   sudo cp -p /root/.mono/registry/CurrentUser/software/apprecovery/agent/agentid/values.xml ~/values-backup.xml
   A file named values-backup.xml containing your unique agent ID is saved to the specified location.
2. Remove AppAssure Agent following the steps specific to the appropriate Linux distribution. For more information, see Uninstalling the AppAssure Agent software from a Linux machine.
3. Install Rapid Recovery Agent online using the appropriate package manager, or offline using the appropriate steps. For more information, see About installing the Agent software on Linux machines.
4. Run the appropriate configuration steps for the updated Linux machine. For more information, see Configuring the Rapid Recovery Agent on a Linux machine.
5. Copy the values-backup.xml file to the new location by typing the following command and then pressing Enter:
   sudo mv ~/values-backup.xml /root/.mono/registry/CurrentUser/software/apprecovery/agent/agentid/values.xml
6. Restart the rapidrecovery-agent service or reboot the machine.
   The original agent ID for that machine is now associated with the updated Rapid Recovery Agent software.

Uninstalling the Rapid Recovery Central Management Console

1. On the Windows server from which you want to uninstall the Rapid Recovery Central Management Console, open the Control Panel, click Programs and Features, and then click Uninstall a Program.
2. In the Programs and Features window, double-click the installed Rapid Recovery Central Management Console instance; for example:

   	Central Console-X64-6.x.x.xxxxx.exe

   The Rapid Recovery Central Management Console Installation Wizard appears, showing the Repair/Remove page.

3. Select Remove, and then click Next.

   The Remove Options page appears.

4. Select Uninstall configuration settings and data including all backup images and change logs, and then click Uninstall.

   The Progress page appears. You can view the progress of the uninstall action on the Progress page.

   When the uninstall is complete, the Completed page appears.

5. Click Finish to close the wizard and exit.

About the Local Mount Utility

The Local Mount Utility (LMU) is a downloadable Windows-based application that lets you mount a Rapid Recovery recovery point in any of the three available modes on any compatible Windows machine. The light-weight utility can be installed on the same 32-bit and 64-bit Windows operating systems as the Rapid Recovery Agent software, but it does not have to be installed on the same machine as the Agent. The LMU includes the rapidrecovery-vdisk (formerly aavdisk) and aavstor drivers, but it does not run as a service. When you install the utility, by default, it is installed in the directory C:\Program Files\AppRecovery\Local Mount Utility and a shortcut appears on the machine’s desktop.

While the utility was designed for remote access to a Rapid Recovery Core machine, you can also install the LMU on the same machine as a Rapid Recovery Core. When it runs on a Core, the application recognizes and displays all mounts from that Core, including mounts performed through the Rapid Recovery Core Console. Likewise, mounts performed on the LMU also appear in the Core Console.

When the LMU is installed on the same machine as Mailbox Restore, the LMU automatically launches Mailbox Restore when you use it to open an Exchange database. Mailbox Restore is the Rapid Recovery application used to restore Microsoft Exchange data stores and items. You can install it upon installation of the LMU or the Rapid Recovery Core. For more information about Mailbox Restore, see the latest release of the Rapid Recovery Mailbox Restore for Exchange User Guide.