Linux: Script to Install/Upgrade/Uninstall Rapid Recovery Linux Agent (4040663)

This article provides instructions on how to use a script to install, upgrade, or uninstall Rapid Recovery Linux Agents. The script will automatically detect and uninstall any existing AppAssure Linux agents as a first step.

For detailed information on upgrading AppAssure Linux Agents to Rapid Recovery, please refer to the Installation and Upgrade Guide, 

For more information on this topic, see:

• Rapid Recovery Administration: Module 4 – Agent Installation and Machine Protection

Note: By default, this script downloads and installs the latest version of the Rapid Recovery Linux Agent.

Steps to Use the Rapid Recovery Install Tool

1. Download the Install Tool on your Linux machine:

   Use one of the following commands:

   wget http://aainfo5.s3.amazonaws.com/Linux/rriu/rr_install_utility.sh

   OR

   curl -O http://aainfo5.s3.amazonaws.com/Linux/rriu/rr_install_utility.sh

2. Make the script executable:

   chmod +x rr_install_utility.sh

3. Run the script using one of the following options:

   • Install Only: Installs the Rapid Recovery 6.8 Linux agent without configuration. (Manual configuration required using the rapidrecovery-config tool).

     sudo ./rr_install_utility.sh --install-only -v 6.8.0

   • Install and Configure: Installs and configures the Rapid Recovery agent in one command. Note: A system reboot is recommended after the installation.

     sudo ./rr_install_utility.sh -u 'backup' -p 8006 -f ufw

   • Uninstall: Uninstalls the Rapid Recovery Linux agent and saves a copy of the AgentID XML file to a temporary folder.

     sudo ./rr_install_utility.sh --remove-rapidrecovery

4. Post-Installation: Remember to run the rapidrecovery-config tool as described in the guide Configuring the Rapid Recovery Agent on a Linux Machine .

Important Notes

• An active internet connection is required for the script to function. For offline installations, refer to Installing the Agent software on offline Linux machines.
• The script automatically removes AppAssure but retains a backup of the AgentID, ensuring connectivity to existing recovery points in the Core Console when upgrading.
• The script can also completely remove Rapid Recovery while keeping a backup of the AgentID, and it can install Rapid Recovery even if AppAssure is not installed.

Script Options

Usage Examples

• Install and Configure: Installs the Rapid Recovery Agent, configures it with ufw (Ubuntu Firewall) on port 8006 for user 'backup'.

  bash rr_install_utility.sh -f ufw -p 8006 -u 'backup'

• Install Only: Installs the Rapid Recovery Agent without configuration. To configure, use rapidrecovery-config manually or re-run the script with configuration options.

  bash rr_install_utility.sh --install-only

• Install Specific Version: Installs Rapid Recovery Agent version 6.8.0. Note: Downgrading is not supported. Uninstall any higher versions first using --remove-rapidrecovery.

  bash rr_install_utility.sh --install-only -v 6.8.0

• Install Latest Hotfix (Unconfigured): Installs the latest hotfix for version 6.6.0 without configuration.

  bash rr_install_utility.sh --hotfix 6.8.0 --install-only

• Install Latest Hotfix (Configured): Installs the latest hotfix for version 6.6.0 with configuration.

  bash rr_install_utility.sh --hotfix 6.8.0 -f lokkit -p 8006 -u 'backup'

• List Firewall Options: Lists valid firewall options for use with the -f option.

  bash rr_install_utility.sh --list-fw

Complete Uninstall: Completely uninstalls Rapid Recovery but retains the AgentID in the /tmp directory. (Note: Data in /tmp may be lost on reboot.)

bash rr_install_utility.sh --remove-rapidrecovery
 

Reference Material

• Rapid Recovery Administration: Module 4 – Agent Installation and Machine Protection
  This course covers how to install the Rapid Recovery agent software and protect machines with or without an agent. Free with maintenance.
• Installation and Upgrade Guide
  This guide provides detailed instructions on upgrading AppAssure Linux Agents to Rapid Recovery.
• Configuring the Rapid Recovery Agent on a Linux Machine
  Post-installation guide for setting up the Rapid Recovery agent on Linux.
• Installing the Agent software on offline Linux machines
  Instructions for installing the Rapid Recovery Agent on Linux machines without an active internet connection.