1-Touch for Linux - Single Stage DVD

Overview

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.

System Requirements

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.

Deployment

You need to install the File System iDataAgent on the client computer. For more information, refer to Deployment.

Configuration

After you install the File System iDataAgent, you need to enable 1-Touch for the default subclient. For more information, refer to Configuration.

Recovery

You can restore to a computer which has the same or different storage configuration as that of the backed up computer using the following interactive recovery procedure. Virtualize Me for Linux is not supported for systems booted via UEFI.

Unlike traditional Linux 1-Touch recovery, you cannot use the DVD04.iso for recovery directly. Use the following steps to generate a per client per backup boot media that can be used to perform 1-Touch recovery of the 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.
Run the following commands:
```
 
# cd <install_dir>/iDataAgent/systemrecovery
```
For example, /opt/commvault/iDataAgent/systemrecovery.
```
# ./create_1tchbootcd.sh <options>
```
where the usage is:

./create_1tchbootcd.sh [-m <mode>] -s <src_client> [-d <dst_client>] -c <cs_hostname> -u <csusername> [-o <cspassword>] [-p <copy precedence>] [-b <backupsetname>] [-i <instance>] [-t <totime>] [-r <map file containing source files and their destination in the DVD's initrd>] -n <dvd4.iso path> [-l <dest_directory>] [-v 2] [-R <response xml file>] [-A] [-S]

where,
- mode: 0=interactive(default) 1=silent.
- instance: instance on current machine.
- totime: for job restore in format YYYY/MM/DD hh:mm:ss.
- -d defaults to client on which this script is executed.
- -l directory to store final DVD on. Defaults to iDataAgent.
- -v defaults to version 1 of UEFI files to be included in ISO.
- -R specifies 1-Touch response XML used during restore to be embedded in Single Stage ISO.
- -A will not ask popup question when [-R response xml] file is detected during response file detect step.
- -r is used to copy additional files in Single Stage ISO using a Map file. File contents should be in the format /root/examples/lvm.comf#etc/lvm/lvm.conf OR /root/module.ko.xz#lib/modules/isofs.ko.xz#cmd="chroot./sbin/depmod
- -S instruction to skip (remove) device filters from lvm.conf
  
  Note
  
  Using the -S option will update lvm.conf only during restore, and not on the recovered server.
Example

./create_1tchbootcd.sh -s <Source Client name> -c <Commserve Host name> -u <Commcell user name> -n <1-Touch DVD4ISO path>

Usage with sample values

./create_1tchbootcd.sh -s SLES12SP5BIOS -c DemoCommcell -u admin -n /DVD4.iso

To check the user permissions to view the client, run the following commands:
```
 
# cd install_dir/Base/
# ./qlogin
# ./qlist client
```
Keep the Client Information Checklist ready. For more information, see Configuration - 1-Touch for Linux.
Boot the client computer using the boot media.
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 then select the fully qualified client host name from the Current Client HostName selection box. It contains values of all of the host names entered on the previous Network Config page and the client host name present in the recovery response xml file, and also the host names resolved via nslookup for each of the IP address configured on the Network Config page. You can also manually enter a new client host name as specified in the client information checklist. This host name will be used during recovery and will persist on the machine after the recovery completes.

Make sure that the hostname is resolvable from the CommServe and the MediaAgent to the client being recovered. This field may be left blank to enable installation of the client being recovered with an IP instead of a host name.

Select Next and press Enter.

If you want to clone the client computer, select the Clone client with new name check box, and then 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.
The recovery process will now boot into the kernel that was restored from the backup of the source client. After the boot up completes, the GUI will restart and perform a temporary Commvault client install before showing up the Multipath Settings page.

Select Next and press Enter.
- If you want to enable Linux native multipathing, select the Configure multipathing during recovery check box.
By default, the selection will be made based on the configuration of the backed up computer.
On the Mountpoint Selection page, select Next and press Enter.

By default, the system mount points are selected for restore. You can select the other mount points that you want to recover.
On the Job Selection page, select Next and press Enter.

By default the system state and the file system data, backed up during the most recent backup will be restored. You can select a backup job to restore the system state data and a backup job to restore the file system data.
On the Network Persistence page, you can choose to persist the network configuration used during the recovery onto the computer after it boots up. The options available are:
- No: Do not persist any configuration. Upon reboot, the computer will have the network configuration of the backed up computer
- Yes Persist config only for those NICs configured during recovery: Persist the network configuration of only those NICs that were enabled and configured during the recovery. By default, this option is selected.
- Yes Persist config for ALL NICs as seen during recovery: Persist the network configuration for all NICs detected during recovery. An empty configuration file will be created for the NICs that were detected but not configured during the process of this recovery.
Select Next and press Enter.
Press Enter.
Remove the boot media and reboot the computer.

Best Practices

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 mountpoints/network/storage devices on the client.
If you are using the same client to generate the boot media, move the generated .iso out of the client computer and burn it to a physical media or store it at a safe location.
As subsequent backups back up the previously generated boot media, even if the client computer crashes due to a hardware issue or because of any other reason, you can always recover an earlier generated boot media by performing an out-of-place restore of the file by browsing the contents from the CommServe.

FAQ

If I change the boot loader from BIOS to UEFI or vice versa, can I perform 1-Touch recovery with the new boot loader?

Yes. You need to perform a new 1-Touch backup when you change the boot loader from BIOS to UEFI or vice versa to be able to perform 1-Touch recovery.

For more FAQs, refer to Frequently Asked Questions - 1-Touch for Linux.