This process is mandatory for machines that are booted by using the Universal Extensible Firmware Interface (UEFI) boot loader.
This process is recommended for physical machines that are booted by using the BIOS boot loader.
Overview of the 1-Touch Recovery Process
The 1-Touch Recovery process for Linux using a single-stage DVD involves the following steps:
-
Prerequisites: Ensure all requirements are met, including system requirements, software installation, and obtaining the necessary DVD4 image.
-
ISO Creation: Generate a per-client, per-backup bootable ISO using the DVD4 image and the
create_1tchbootcd.shscript. -
Boot the Client: Use the generated ISO to boot the client machine.
-
Recovery Process: Follow the interactive recovery steps to restore the system.
Before You Begin
-
Verify that the computer in which you wish to install the software meets the minimum requirements specified in System Requirements.
- A minimum of 8 GB free space is required for the system recovery directory,
<install_dir>/iDataAgent/systemrecovery, on the client where the single-stage ISO is being created.
- A minimum of 8 GB free space is required for the system recovery directory,
-
Download the DVD4 image from store.commvault.com. This image is a required input for creating the bootable ISO.
-
Ensure you have access to a Linux machine (can be different from the backed-up client) that is part of the same CommCell as the client computer.
Procedure
Step 1: Create the Bootable ISO
You can restore to a computer with the same or different storage configuration as the backed-up computer using the following procedure. Note that Virtualize Me for Linux is not supported for systems booted via UEFI.
-
Log on to any Linux client computer that is in the same CommCell as the client computer that was backed up. This computer can be the same computer that was backed up or a different Linux machine.
-
Navigate to the system recovery directory:
# cd $[install_dir/iDataAgent/systemrecovery]For example,
/opt/commvault/iDataAgent/systemrecovery. -
Run the following command to create the bootable ISO:
# ./create_1tchbootcd.sh [options]Example usage:
./create_1tchbootcd.sh -s <Source Client name> -c <CommServe Host name> -u <CommCell user name> -n <1-Touch DVD4ISO path>Sample values:
./create_1tchbootcd.sh -s SLES12SP5BIOS -c DemoCommcell -u admin -n /DVD4.iso -v 2Key Parameters:
-
-s: Source client name. -
-c: CommServe host name. -
-u: CommCell user name. -
-n: Path to the DVD4 image. -
-v: Version of UEFI files to include in the ISO. Use-v 2for compatibility with most UEFI systems (recommended).
Important
The
-vparameter defaults to version 1. For UEFI environments, you must specify-v 2; otherwise, the ISO may fail to boot. -
-
To check user permissions to view the client, run the following commands:
# cd $[install_dir/Base/] # ./qlogin # ./qlist client
Step 2: Boot the Client Using the Boot Media
-
Boot the client computer using the generated bootable ISO.
-
On the Network Config page, enter the IP address, network, and name server details of the network specified in the client information checklist. Select Next and press Enter.
-
On the Client Config page, enter the short name of the client and select the fully qualified client host name from the Current Client HostName selection box. Ensure the hostname is resolvable from the CommServe and the MediaAgent to the client being recovered. Select Next and press Enter.
-
If you want to clone the client computer, select the Clone client with new name check box and enter the new client name. Otherwise, continue with the next step.
-
On the CommServe Config page, enter the details of the CommServe and the MediaAgent as specified in the client information checklist. Select Next and press Enter.
Step 3: Perform the Recovery
-
The recovery process will boot into the kernel restored from the backup of the source client. After boot-up completes, the GUI will restart and perform a temporary Commvault client install.
-
Follow the on-screen instructions to configure multipathing, select mount points, and choose backup jobs for recovery.
-
On the Network Persistence page, choose whether to persist the network configuration used during recovery onto the computer after it boots up. Select Next and press Enter.
-
Press Enter to complete the recovery process.
-
Remove the boot media and reboot the computer.
Best Practices
-
Maintain a dedicated Linux VM with the DVD4 image and access to the CommServe to pre-create boot media. This ensures quick recovery in critical scenarios.
-
If you are using the same client to generate the boot media, generate the boot media periodically after the backup completes, especially if there were changes to the mount points, network, or storage devices on the client.
-
Move the generated
.isoout of the client computer and burn it to physical media or store it in a safe location. -
As subsequent backups include the previously generated boot media, you can recover an earlier generated boot media by performing an out-of-place restore of the file from the CommServe.