This topic describes how to remove AppAssure Agent from a Linux machine for any supported distribution. Uninstalling AppAssure Agent is required before installing Rapid Recovery Agent.
|
|
NOTE: If you want the Linux machine to be able to connect to existing recovery points, before uninstalling, Quest recommends first backing up the unique agent ID. For more information, see Backing up and restoring the AppAssure Agent ID. |
The standard method to install or remove AppAssure Agent on a Linux machine is to run the appropriate AppAssure installer (a shell script). If you did not retain the installer, manual steps are included to remove AppAssure Agent .
|
|
NOTE: Quest recommends retaining the binary installer file for any currently installed Rapid Recovery software product. You can use this file in the future to reinstall, repair, or remove the software. |
For information about removing Rapid Recovery Agent, see Uninstalling the Rapid Recovery Agent software from a Linux machine.
Complete the following steps to uninstall the AppAssure Agent software from a Linux machine.
|
|
NOTE: The following steps apply to both 32-bit and 64-bit environments. For 32-bit RHEL, CentOS, Ubuntu, and SLES systems, the file extension in the steps below will change from “x86_64” to “i386”. |
- Open a terminal session with root access.
- If you do not have access to the installer script, proceed to step 6.
- If you have access to the installer script, change to the directory that includes the AppAssure installation script, for example:
cd /home/AppAssure/
- 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.
- Based on the Linux distribution installed, run the following command, modifying it to specify the build number you identified in the previous step:
| 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.
- Alternatively, to remove the AppAssure Agent software manually without the use of the script, run one of the commands below:
- For Debian and Ubuntu:
dpkg --force-all -P appassure-vss appassure-vdisk appassure-mono appassure-agent
- 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.
After AppAssure Agent is removed from the system, to protect your machine in the Rapid Recovery Core, install the AppAssure Agent software or use agentless protection.
When you remove the AppAssure Agent software in preparation for installing the more recent Rapid Recovery Agent, you also remove the unique identification number associated with that machine. This removal results in the inability to connect to the recovery points saved to the Core for that protected Linux machine.
Before removing AppAssure Agent , you can back up the agent ID values. Then you can install Rapid Recovery Agent and restore the settings.
Use the following procedure to back up agent ID values, and then to restore them afterward.
- 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.
- 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.
- 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.
- Run the appropriate configuration steps for the updated Linux machine. For more information, see Configuring the Rapid Recovery Agent on a Linux machine.
- 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
- 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.
Check the Rapid Recovery Core to see if the machine appears. If not, use the Protect Machine wizard to add the upgraded machine to protection in the Core.
|
|
NOTE: After updating Rapid Recovery Agent, the first snapshot will result in a base image, creating a new recovery point chain. |
The Central Management Console is not supported for Rapid Recovery release 6.2 and later. To manage multiple Cores, remove this component if applicable and use the QorePortal at https://qoreportal.quest.com/.
Complete the steps in this procedure to uninstall the Rapid Recovery Central Management Console.
- 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.
- 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.
- Select Remove, and then click Next.
The Remove Options page appears.
- 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.
- Click Finish to close the wizard and exit.
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.
|
|
NOTE: Linux machines use a command-line utility, local_mount, to query the Core for protected machines and their corresponding recovery points. Similarly, that tool lets users remotely mount a recovery point volume; lets users explore the volume contents at the file levels; and lets users restore a individual files or an entire volume from the recovery point, including BMR of the system volume. For more information, see the Rapid Recovery User Guide. |
The process to remove the AppAssure Agent software from a Linux machine uses a shell script. The uninstall instructions differ depending on the Linux distribution you are using.
Complete the steps in the following topics to uninstall the AppAssure Agent software from a Linux machine.