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

This KB explains how to install, upgrade, or uninstall your Rapid Recovery Linux Agents using a script.

This script will automatically detect and uninstall AppAssure Linux agents as its first step.

There is detailed documentation regarding upgrading your AppAssure Linux Agents to Rapid Recovery in our Installation and Upgrade Guide, 

Script guided Linux agent installation / upgrade / uninstall.

For more information on this topic, please see:

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

1. Download the RapidRecovery Install Tool on your Linux machine.

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 with: chmod +x rr_install_utility.sh

3. There are several ways you can run the script:

If you want to install the Rapid Recovery 6.8  Linux agent but do not want to configure the agent. (You will need to configure the agent manually by running the rapidrecovery-config tool).
Example: sudo ./rr_install_utility.sh --install-only -v 6.8.0

If you want to install and configure the Rapid Recovery agent in just one command. Note: You should reboot after this is finished.
Example: sudo ./rr_install_utility.sh -u 'backup' -p 8006 -f ufw

If you want to uninstall the Rapid Recovery Linux agent. Note: This will save a copy of the AgentID XML file to a temp folder.
Example: sudo ./rr_install_utility.sh --remove-rapidrecovery

4. Remember to run the rapidrecovery-config tool as described in the next guide Configuring the Rapid Recovery Agent on a Linux machine

Notes:

• You need a working internet connection on the Linux agent, for this script to work. If you do not have a active internet connection, then you will need to use the offline Linux install process, from the Install and Upgrade Guide.
• This script automatically removes AppAssure but it also creates a backup of the AgentID so that when you upgrade your core, it should still be connected to the old recovery points in the Core Console.
• Another feature of this script is that you can optionally use it to remove Rapid Recovery completely but still keep a backup of the AgentID. Also, this script can install the Rapid Recovery agent even if AppAssure is not already installed.

Options:

Usage Examples:

• This command installs the Rapid Recovery Agent and configures it to use the ufw(Ubuntu Firewall) firewall with port 8006 and the user account 'backup'.
  bash rr_install_utility.sh -f ufw -p 8006 -u john
• This command installs the Rapid Recovery Agent but does NOT configure it. You will manually need to run 'rapidrecovery-config' or run this script again with config options set.
  bash rr_install_utility.sh --install-only
• This command installs the Rapid Recovery Agent, release version 6.8.0, in case you need to install an older version. (Note: Downgrade does not work. If you already have a higher version agent installed, you will need to uninstall it first, either manually or with this script using the --remove-rapidrecovery switch. Upgrading the agent or fresh installs, however, should work.)
  bash rr_install_utility.sh --install-only -v 6.8.0
• Install latest Linux agent hotfix for 6.6.0 . Does not configure the agent.
  bash rr_install_utility.sh --hotfix 6.8.0 --install-only
• Install latest Linux agent hotfix for 6.6.0 and configure the agent.
  bash rr_install_utility.sh --hotfix 6.8.0 -f lokkit -p 8006 -u 'backup'
• List all valid firewall options to use with option (-f).
  bash rr_install_utility.sh --list-fw
• Completely uninstalls Rapid Recovery but keeps the agentID for backup inside the '/tmp' directory. (If you reboot, you may lose this)
  bash rr_install_utility.sh --remove-rapidrecovery