# System Requirements for 1-Touch for Linux

Note

Commvault SaaS does not offer the VirtualizeMe feature.

Verify that your environment meets the system requirements for 1-Touch on Linux.

## Operating System: Client

Important

Commvault software fully supports the most recent version of an operating system, until the vendor ends support. End-of-life Operating System versions are only supported on a best-case basis. For additional versioning requirements, please check the CommVault Obsolescence Policy.

## Supported Operating Systems

### AlmaLinux

- AlmaLinux 10.0

- AlmaLinux 9.x with glibc 2.34.x

- AlmaLinux 8.x

### Debian

- Debian 13.0

- Debian 12.0 with kernel 6.1.0-26

### Oracle Linux

- Oracle Linux 10.0

- Oracle Linux 9.x with glibc 2.34.x

- Oracle Linux 8.x with glibc 2.28.x

- Oracle Linux 7.x with glibc 2.17.x or a more recent version

### Red Hat Enterprise Linux/CentOS

- Red Hat Enterprise Linux 10

- Red Hat Enterprise Linux 9.x glibc 2.34.x

- Red Hat Enterprise Linux/CentOS 8.x with glibc 2.28.x

### Rocky Linux

- Rocky Linux 10.0

- Rocky Linux 9.x with glibc 2.34.x

- Rocky Linux 8.x

### SuSE Linux (SLES)

- SuSE Linux Enterprise Server 15 SP7

- SuSE Linux Enterprise Server 15 SP6 with glibc 2.31.x

- SuSE Linux Enterprise Server 15 SP5 with glibc 2.31.x

- SuSE Linux Enterprise Server 15 SP4 with glibc 2.31.x

- SuSE Linux Enterprise Server 15 SP3 with glibc 2.31.x

- SuSE Linux Enterprise Server 15 SP2 with glibc 2.26.x

- SuSE Linux Enterprise Server 15 SP1 with glibc 2.26.x

- SuSE Linux Enterprise Server 15 with glibc 2.26.x

- SuSE Linux Enterprise Server 12 with SP5 with glibc 2.22.x

### Ubuntu

- Ubuntu 24.04 LTS with glibc 2.39

- Ubuntu 22.04 LTS with glibc 2.35

- Ubuntu 20.04 LTS with glibc 2.31

- Ubuntu 18.04 LTS with glibc 2.27

## Hard Drive

5 GB of free disk space is required in the `iDataAgent/jobResults/` directory.

No additional disk space required beyond File System Agent disk space requirements.

## Memory (RAM)

8 GB, or minimum memory requirements of the applications running on the server, whichever is greater.

## Processors

- x86

- x64

- Power PC (PPC)

  PPC is supported only with ReaR. For more information, see Bare Metal Recovery for PPC Architecture Using 1-Touch for UNIX.

## Peripherals

A CD-ROM drive or the ability to boot from an ISO image file is required to boot the client for recovery.

## Operating System Utilities

1-Touch backups for UNIX computers require that the standard operating system utilities that are distributed with the Ubuntu and RHEL/SuSE Linux distributions. If the prerequisites for a system state (1-Touch) backup are not met, the backup job will continue to back up the file system data and report the error during the post-backup phase. This ensures that the data remains protected even when the 1-Touch phase fails.

### Debian and Ubuntu

arch | e2image | last | mv | swapon | kexec
awk | echo | ldd | netstat | sync | mkfs.vfat
basename | egrep | ln | openvt | tail | mkfs.xfs
bash | eject | locale | parted | tar |
cat | env | ls | passwd | tee |
chgrp | expr | lsmod | pidof | test |
chmod | false | lspci | ping | time |
chown | fdisk | lvdisplay | ping6 | top |
chroot | fgrep | lvm | ps | touch |
chvt | file | lvmdiskscan | pvcreate | tr |
cksum | find | lvscan | pvdisplay | true |
clear | fsck | mkdir | pvs | tset |
cp | fsck.ext2 | mke2fs | pvscan | tty |
cpio | fsck.ext3 | mkfifo | pwd | umount |
cut | getopt | mkfs | reboot | uname |
date | grep | mkfs.ext2 | rm | uptime |
dd | gunzip | mkfs.ext3 | rmdir | vgcfgbackup |
depmod | gzip | mkinitramfs | rmmod | vgcfgrestore |
df | head | mkswap | route | vgchange |
diff | host | modinfo | sdiff | vgcreate |
dir | hostname | modprobe | sed | vgdisplay |
dirname | ifconfig | mknod | sleep | vi |
dmesg | insmod | mktemp | stty | whereis |
du | kill | more | su | which |
e2fsck | killall | mount | swapoff | zcat |

### Oracle Linux, CentOS, RHEL, and SuSE Linux

arch | echo | last | mv | sync
awk | egrep | ldd | netstat | tail
basename | eject | ln | openvt | tar
bash | env | locale | parted | tee
cat | expr | ls | passwd | test
chgrp | false | lsmod | pidof | time
chmod | fdisk | lspci | ping | top
chown | fgrep | lvcreate | ping6 | touch
chroot | file | lvdisplay | ps | tr
chvt | find | lvm | pvcreate | true
cksum | fsck | lvmdiskscan | pvdisplay | tset
clear | fsck.ext2 | lvscan | pvs | tty
cp | fsck.ext3 | mkdir | pvscan | umount
cpio | gawk | mke2fs | pwd | uname
cut | getopt | mkfifo | reboot | uptime
date | grep | mkfs | rm | dd
grub or grub2 | mkfs.ext2 | rmdir | vgcfgbackup | depmod
gunzip | mkfs.ext3 | rmmod | vgcfgrestore | df
gzip | mkinitrd | dracut | route | vgchange | diff
head | mkswap | sdiff | vgcreate | dir
host | modinfo | sed | vgdisplay | dirname
hostname | modprobe | sleep | vi | dmesg
ifconfig | mknod | stty | whereis | du
insmod | mktemp | su | which | e2fsck
kill | more | swapoff | zcat | e2image
killall | mount | swapon |  |

## Driver Modules

The usb-storage module must not be blocked from the system.

## Bootloader

Commvault SaaS

- Only BIOS is supported.

- Support for UEFI is limited. UEFI secure boot is not supported.

Commvault software

- Only BIOS is supported.

- Support for UEFI is limited. For more information, see 1-Touch for Linux - UEFI.

## File System and Volume Managers

Commvault SaaS

- Linux Logical Volume Manager (LVM) Version 2: Unencrypted LVMs are supported. Thin volumes are not supported.

- B-tree File System (Btrfs): Only 1-Touch recovery on similar systems is supported.

- Second Extended File System (ext2)

- Third Extended File System (ext3)

- Fourth Extended File System (ext4)

- Reiser File System (reiserfs)

- XFS

Important

Mount and back up the snapshot data as snapshot volumes are not recovered as part of the 1-touch recovery.

Commvault software

- Linux Logical Volume Manager (LVM) Version 2: Unencrypted LVMs are supported. Thin volumes are not supported.

- B-tree File System (Btrfs): Only 1-Touch recovery on similar systems and VirtualizeME are supported.

- Second Extended File System (ext2)

- Third Extended File System (ext3)

- Fourth Extended File System (ext4)

- Reiser File System (reiserfs)

- XFS

Important

Mount and back up the snapshot data as snapshot volumes are not recovered as part of the 1-touch recovery.

## Virtual Machines

Commvault SaaS

- VMware

- Kernel-based VM for Linux (KVM)

Commvault software

- VMware

- Microsoft Hyper-V: Host operating system version of Microsoft Windows Server 2012 R2 Editions or a more recent version.

- Oracle VM: For Oracle VM and Citrix Xen guest VM, perform recovery using the 1-Touch for Linux - Single-Stage DVD procedure. For in-place restores of Citrix Xen guest VMs or for restores to another VM running on Citrix Xen, perform recovery using the 1-Touch for Linux - Single-Stage DVD procedure. To migrate Citrix Xen guest VMs to a non-Citrix Xen environment, see Migrating Citrix Xen Guest VMs to Another Hypervisor or Physical Host.

- Kernel-based VM for Linux (KVM)

- Citrix Xen guest VM: For Oracle VM and Citrix Xen guest VM, perform recovery using the 1-Touch for Linux - Single-Stage DVD procedure. For in-place restores of Citrix Xen guest VMs or for restores to another VM running on Citrix Xen, perform recovery using the 1-Touch for Linux - Single-Stage DVD procedure. To migrate Citrix Xen guest VMs to a non-Citrix Xen environment, see Migrating Citrix Xen Guest VMs to Another Hypervisor or Physical Host.

## Recovery Considerations

Commvault SaaS

### Client

- You need an additional computer to create bootable media from the backup. This computer can be the same computer or a different one with an Intel Pentium, x64, or a compatible processor.

- iSCSI disks are not supported for 1-Touch. These disks need to be manually unselected during interactive restores if any iSCSI disks are backed up.

- SAN disks are supported for 1-Touch recovery operations.

- Loop devices are not supported for 1-Touch, and they are not included in 1-Touch backups.

- 1-Touch recovery operations support native Linux multipathing. Vendor-specific multipath implementations are not supported.

- 1-Touch recovery does not support disk block size mismatches between the source and destination systems. Recovery from a source system that uses a 512-byte block size to a destination system that uses a 4 KB block size, or vice versa, is not supported. The restore cannot correctly format the destination disk, even when you use manual disk mapping with `webadm`. For a successful recovery, the destination system must use the same disk block size as the source system.

- For VMware ESX 6 or more recent versions, set the Virtual Machine compatibility to ESXi 5.5 and later (VM version 10) during the creation of the virtual machine.

- Itanium (IA64) processor is not supported.

- FCoE (Fibre Channel over Ethernet) is not supported.

- 1-Touch recovery operations are supported on clients with Linux kernel executable in vmlinuz-* format.

- 1-Touch recovery operations are supported for LUKS-encrypted disks with LUKS version 1.6.4 or more recent versions. After the first phase, provide the passkey for encrypted disks in plain format by entering the following command on an alternate terminal:

  `create /tmp/override/cryptFile.key`

  where the cryptFile.key format is:

  encrypted_disk_name p passkey_in_plain_format

  Note

  Entries for LUKS-encrypted partitions and LV's will be excluded from the final fstab.

  Example

  For an encrypted disk /dev/sdb1 opened as luks1 during backup, the key file must be in the following format:

  /dev/mapper/luks1 p passkey

  Note

  - 1-Touch restore for LUKS encrypted device is only supported when encryption is done using passphrase.

  - To open multiple devices, add an entry for each device on a new line.

- Booting a HPE ProLiant DL380 Gen10 hardware with a 1-Touch ISO file attached via iLO fails. Use a different method to attach the ISO.

- Booting the destination machine from a 1-Touch ISO file on a bootable USB is not supported.

Commvault software

### CommServe

- To enable 1-Touch recovery, the Force per-client certificate authentication on CommServe option has to be turned off on the CommServe at least for the duration of the recovery. This option can be accessed from the CommServe Control Panel by clicking on Certificate Administration.

### Client

- iSCSI disks are supported for VirtualizeME. All the backed up iSCSI disks will be re-created as regular SCSI disks on the virtual machine if they are selected during restores.

- iSCSI disks are not supported for 1-Touch. These disks need to be manually unselected during interactive restores if any iSCSI disks are backed up.

- SAN disks are supported for 1-Touch and VirtualizeME. For VirtualizeME, as FC HBA (Fibre Channel Host Bus Adapter) virtualization is not supported, multipath SAN disks will be re-created as regular SCSI disks.

- Loop devices are not supported for 1-Touch, and they are not included in 1-Touch backups.

- 1-Touch supports native Linux multipathing. Vendor-specific multipath implementations are not supported.

- 1-Touch recovery does not support disk block size mismatches between the source and destination systems. Recovery from a source system that uses a 512-byte block size to a destination system that uses a 4 KB block size, or vice versa, is not supported. The restore cannot correctly format the destination disk, even when you use manual disk mapping with `webadm`. For a successful recovery, the destination system must use the same disk block size as the source system.

- 1-Touch recovery and VirtualizeME for Hyper-V is not supported if the virtual machine is generated using the Generation 2 specification.

- For VMware ESX 6 or more recent versions, set the Virtual Machine compatibility to ESXi 5.5 and later (VM version 10) during the creation of the virtual machine.

- Itanium (IA64) processor is not supported.

- FCoE (Fibre Channel over Ethernet) is not supported.

- 1-Touch recovery is supported on clients with Linux kernel executable in vmlinuz-* format.

- 1-Touch recovery is supported for LUKS-encrypted disks with LUKS version 1.6.4 or more recent versions. After the first phase of 1-Touch recovery, provide the passkey for encrypted disks in plain format by entering the following command on an alternate terminal:

  `create /tmp/override/cryptFile.key`

  where the cryptFile.key format is:

  encrypted_disk_name p passkey_in_plain_format

  Note

  Entries for LUKS-encrypted partitions and LV's will be excluded from the final fstab.

  Example

  For an encrypted disk /dev/sdb1 opened as luks1 during backup, the key file must be in the following format:

  /dev/mapper/luks1 p passkey

  Note

  - 1-Touch restore for LUKS encrypted device is only supported when encryption is done using passphrase.

  - To open multiple devices, add an entry for each device on a new line.

- Booting a HPE ProLiant DL380 Gen10 hardware with a 1-Touch ISO file attached via iLO fails. Use a different method to attach the ISO.

- Booting the destination machine from a 1-Touch ISO file on a bootable USB is not supported.

## DISCLAIMER

Certain third-party software and service releases (together, "Releases") may not be supported by Commvault. You are solely responsible for ensuring Commvault’s products and services are compatible with any such Releases.

×

Loading...