Quest has been named as an ASP "Ten Best Web Support Sites" award winner. Learn more.

Rapid Recovery 6.0.2 - Installation and Upgrade Guide

*** Legend Introduction to Dell Data Protection | Rapid Recovery Rapid Recovery system requirements Installing Rapid Recovery
Understanding Rapid Recovery components Installing the Rapid Recovery Core Installing the Rapid Recovery Agent software Installing the Rapid Recovery Central Management Console Automatically installing updates Uninstalling the Rapid Recovery Core Uninstalling the Rapid Recovery Agent software Uninstalling the AppAssure Agent software from a Linux machine Uninstalling the Rapid Recovery Central Management Console
Upgrading to Rapid Recovery

About installing the Agent software on Linux machines

When installing the Agent software on Linux machines that you want to protect, use the following guidance. After installation is complete, configure the Agent as described in the topic Configuring the Rapid Recovery Agent on a Linux machine.

CAUTION:
After configuring the newly installed Agent software on a Linux machine, restart the machine. Restarting ensures that the proper kernel driver version is used to protect your machine.

The method for installing and removing the Agent software on Linux machines has changed. As of release 6.0.1, the following factors apply:

  • One set of instructions applies to installations of Agent on a Linux machine with current access to the Internet. This is referred to as online installation. Instead of using shell scripts, package managers are used to install or remove the Rapid Recovery software from a repository referenced on the local Linux machine.
    Note: The repository is used for staging of files for the relevant package managers. This repository is not related to the Rapid Recovery repository.
  • If installing Agent on a Linux machine with no access to the Internet (such as an air-gapped or secured standalone machine), this is referred to as offline installation. For this process, you must first download an installation package from a Linux machine with Internet access, and then move those installation files to the secured computer for installation.

Because the various supported Linux distributions use different package managers for online installation, the procedure for installing, upgrading, or removing Agent on any supported Linux OS depends on the package manager used. The package managers, and the Linux distributions they support, are described in the following table.

Table 1. Package managers and the Linux distributions they support
Package Manager Linux Distribution
yum Linux distributions based on Red Hat Enterprise Linux (RHEL), including RHEL, CentOS, and Oracle Linux.
zypper SUSE Linux Enterprise Server (SLES) versions 11, 12
apt Linux distributions based on Debian, including Debian 7 or 8, and Ubuntu 12.04 and later

As a one-time setup step for each Linux machine, you must configure your local software repository to point to the location where the package manager obtains Dell Rapid Recovery installation files.

Note: This process is represented by steps 1 through 4 in each of the installation procedures. When upgrading future editions of the Rapid Recovery Agent on a Linux machine with the repository configured, you will not need to perform these steps.

After you configure a software repository on your Linux machine, the package manager is able to retrieve and install the packages needed for installation or removal of Rapid Recovery Agent software and related components, such as aamount (now called local mount), aavdisk (now called rapidrecovery-vdisk), and Mono (an open source, Ecma standard-compliant, .NET Framework-compatible tool set used for porting the Agent software to Linux platforms).

For each package manager, you can run the appropriate command at the command line to determine if it is configured to download Rapid Recovery packages. These commands are listed in the following table.

Table 2. Command to show package manager repository configuration
Package Manager Command to list configured repositories
yum yum replolist
zypper zypper repos
apt ls /etc/apt/sources.list.d

Previous versions of the AppAssure Agent software must be completely removed from a Linux machine before installing the Rapid Recovery Agent version and protecting the Linux machine using the Rapid Recovery Core. This is true for online or offline installations. Removing AppAssure Agent employs the use of shell scripts. The uninstall instructions differ, depending on the Linux distribution you are using. For more information on uninstalling AppAssure Agent from a Linux machine, see Uninstalling the AppAssure Agent software from a Linux machine.

Note: Removal of the new Rapid Recovery Agent software uses the package manager for each distribution. Therefore, if uninstalling a version of Rapid Recovery Agent, see the appropriate procedure under the topic Uninstalling the Rapid Recovery Agent software from a Linux machine.

If installing Rapid Recovery Agent on a Linux machine that has never had AppAssure Agent installed, determine the appropriate package manager from the preceding table. Then follow the appropriate installation procedure.

After configuring the newly installed Agent software on a Linux machine, you must restart the machine. Restarting ensures that the proper kernel driver version is used to protect your machine.

Thus, the installation process when upgrading from AppAssure to Rapid Recovery involves:

  • Removing the AppAssure Agent software (not required for first-time installations)
  • Determine the relevant package manager for your Linux distribution
  • Follow the procedure for installing Rapid Recovery Agent on the Linux machine, including configuring the software repository (steps 1 through 4 of the installation procedure)
  • Run the configuration utility to set port, configure users, add firewall exclusions, install the kernel module, and start the Agent service.
  • Restart the Linux machine

The instructions for installing the Agent software on a Linux machine differ slightly depending on the Linux distribution you are using. For more information about preparing for and installing the Agent software for a Linux machine connected to the Internet, see the appropriate topic. You can choose from the following sections:

For more information about preparing for and installing the Agent software for a Linux machine that is not connected to the Internet, see the topic:

See the following important information before you begin installation of Agent software.


Was this topic helpful?

[Select Rating]



Downloading the Linux distribution

You must download the distribution-specific 32-bit or 64-bit installer on every Linux machine that you want to protect. You can download the installers from the Dell Data Protection | Rapid Recovery License Portal at https://licenseportal.com. For more information, see the Dell Data Protection | Rapid Recovery License PortalUser Guide.


Was this topic helpful?

[Select Rating]



About security

Linux uses the Pluggable Authentication Module (PAM) to manage security. Once a user is authenticated through libpam, the user is only authorized to protect the machine if the user is in one of the following groups: sudo, admin, recovery, or wheel. For information on protecting a machine, see the section “Protecting a Machine” in the Dell Data Protection | Rapid Recovery User Guide.


Was this topic helpful?

[Select Rating]



Location of Linux Agent files

There are several files required to support the Rapid Recovery Agent software on a Linux machine. For all supported Linux distributions, these files are located in the following directories:

  • mono:
    /opt/apprecovery/mono
  • agent:
    /opt/apprecovery/agent
  • local mount:
    /opt/apprecovery/local_mount
  • rapidrecovery-vdisk and aavdctl:
    /usr/bin/aavdisk
  • configuration files for rapidrecovery-vdisk:
    /etc/apprecovery/aavdisk.conf
  • wrappers for agent and local_mount
    /usr/bin/agent
    /usr/bin/local_mount
  • autorun scripts for agent and rapidrecovery-vdisk:
    /etc/init.d/rapidrecovery-agent
    /etc/init.d/rapidrecovery-vdisk

Was this topic helpful?

[Select Rating]



Related Documents