-
Title
Linux - Configuring the Rapid Recovery Agent after Install -
Description
After the installation of the Rapid Recovery Agent, changes to the OS could require the program settings to be altered. For instance, if a new supported kernel is installed, Agent configuration could be updated. This article describes how to update the configuration of the Rapid Recovery Agent on all supported Linux distributions. -
Resolution
To configure Rapid Recovery Agent, follow these steps:
_ __ _
| '_ \__ _ _ __ _ __| |
| |_)/ _' | '_ \| |/ _' |_ __
| ._ \(_| | |_) | | (_| | '_ \___ ___ __ _ _ ___ _ ___ __
|_| \_\_,_| .__/|_|\__,_| |_)/ _ \/ _\/ \ \ / / _ \| '_\ \ / /
|_| | ._ \ __/| (__| ()\ ' /| __/| | \ ' /
|_| \_\_| \___/\___/\_/ \__| |_| |_|
configuration utility
=====================
Choose an item for configuration:
[1] port - Configure Rapid Recovery Agent port(s) (currently: management - 8006, data - 8009);
[2] user - Configure users that are allowed to protect this machine (currently: Not configured);
[3] firewall - Add firewall exclusions for ports used by Rapid Recovery Agent (No firewall detected or firewall is disabled);
[4] module - Install Rapid Recovery kernel module(s) into supported kernel(s) ('all' may be used to skip kernel(s) selection stage) (Not configured for current kernel);
[5] start - Start Rapid Recovery Agent and Rapid Recovery vdisk (should be called after all configuration is done);
[6] kernel - Show all kernel modules, where rapidrecovery-vss is installed;
[7] vault - Enable or disable vault repository that contains obsolete OS packages (on/off may be used, current state: off);
[?] help - Print help;
[0] quit - Quit;
?>- Open a terminal session with root access, or use sudo (as demonstrated in the example below).
- Launch the configuration utility by typing the following command, and then press Enter:
sudo /usr/bin/rapidrecovery-config
The configuration utility starts. The utility lists several configuration options, each with an index number to enter for the appropriate configuration step.
- To update the Agent port, type 1 followed by the new port number, and then press Enter. The default port is 8006. For instance, to change the default port from 8006 to 8008, run the following command:
1 8008
NOTE: If the Agent Service is running, it will restart after the port change. This may result in the interruption of any running job including snapshot transfer. Make sure no jobs are running before changing the port.
- To configure which accounts can be used to add the Agent to a Core, type 2 followed by a list of the usernames separated by commas. For example, if using accounts michael, administrator, and test_user1, type the following command:
2 michael,administrator,test_user1
NOTE: The root account is not allowed.
- The utility list the detected firewall configuration managers (e.g. lokkit or firewalld), on line 3. To add exclusion rules for the Agent port (configured on step 3), type 3 followed by the firewall configuration manager and press the Enter key. For example,
3 firewalld
- Rapid Recovery Agent cannot function property without a kernel module. Type 4 and then press Enter, to query the list of compatible kernel modules. A sub-shell returns all kernel modules compatible for installation. For example, the following could be returned:
Configure the appropriate Rapid Recovery kernel module. For example, to enter kernel modules for 3.16.0-23 and 3.16.0-34, type 1 4. Please notice that the indices are separated by a space. To use all kernel modules, enter all and press Enter.
Searching for all available for installation kernels.
This might take a while, depending on the Internet connection speed.
Kernels compatible for module installation:0 - linux-image-3.16.0.23-generic
1 - linux-image-3.16.0.31-generic
2 - linux-image-3.16.0.33-generic
3 - linux-image-3.16.0.34-genericInput indices of the kernel modules you wish to install, delimited by space; use 'all' to install into all supported kernels, or 'q' to quit.
- Type 5 and press Enter to start the Rapid Recovery Agent service.
- Type 6 to list all kernel modules where rapidrecovery-vss is installed.
- Enter 0 to exit the configuration utility.
- After updating the configuration, reboot the system. Restarting ensures that the proper kernel module version is used to protect the machine.