You can deploy a VMware Linux access node using the Open Virtual Appliance (OVA) template provided by Commvault. You can use the Linux access node to perform VM backup, Live Browse and File Recovery operations, with support for ext2, ext3, ext4, XFS, JFS, HFS, HFS Plus, and Btrfs file systems (subvolumes). You can also browse VM data from a backup for the source VM.
Note
-
As needed, Commvault updates the OVA template to include operating system updates and enhancements. To ensure that the access node contains all features and critical security vulnerability fixes, you must decommission the existing client and deploy the latest Access Node and MediaAgent OVA template. You must also upgrade the CommServe server and Virtual Server Agent to the most recent Commvault service pack or install available HotFixes for the installed service pack.
-
You must decommission the existing client only if it was deployed in maintenance release of the respective Commvault service pack, prior to August 2024.
-
Starting 11.36 CU10 maintenance release, the template has the automatic OS updates feature enabled by default, which automatically installs all critical security vulnerability fixes without the need of decommissioning the client.
Before You Begin
-
Before creating the access node for Linux file restores, ensure that the CommServe server and Virtual Server Agent have the latest service pack updates.
-
To verify the supported VMware software versions, see System Requirements.
-
Ensure that the ESX server and datastore where you deploy the access node meets the following requirements:
-
2 vCPUs
-
16 GB of RAM
-
A 37 GB thin-provisioned or thick-provisioned disk
-
A 200 GB thin-provisioned or thick-provisioned disk
-
A 100 GB thin-provisioned or thick-provisioned disk
-
-
Verify that the VMware servers, the CommServe server and machine where you deploy the access node are able to communicate with each other.
-
If a firewall is used, see Configuring Firewall Settings for VSA with VMware.
-
The virtualization client must refer to a vCenter user with permissions defined as described in Permissions for vCenter User Accounts.
-
The following vSphere permissions are required to enable deployment or reconfiguration of a Linux access node:
Category
Available Permissions
vApp
Import
vApp
vApp application configuration
vApp
vApp instance configuration
-
The following Commvault permissions must be assigned to the CommServe user account:
Category
Permission
Usage
Global
Administrative Management
Enables the CommServe user (identified as CS User Name below) to deploy the Linux access node in the CommServe environment.
Client
Agent Management
Enables the Linux access node to be added to a client computer group.
-
The Linux access node supports live browse and restore of NTFS files from a Linux MediaAgent. For more information, see NTFS Live Browse for Restores Using a Linux MediaAgent.
-
Live recovery is only supported for recovery from backups using magnetic disk libraries, not from backups to tape libraries.
-
Live browse and file recovery operations are not supported for XFS realtime subvolumes.
-
The Linux access node supports NFS version 3 for guest file restores.
-
The Linux access node runs on Oracle Linux 9.x that supports Btrfs file systems.
-
To perform a live browse of files on RedHat Enterprise Linux or Oracle Linux 9.x VMs, you must deploy Commvault software Feature Release 24 or a corresponding recent version of the Access Node and MediaAgent OVA.
Procedure
-
Download the Access Node and MediaAgent OVA template for your appropriate Commvault release, and save it to a location that is accessible from the vCenter.
-
Right-click a Datacenter or cluster or ESXi host in vCenter and select Deploy OVF Template.
The Deploy OVF Template wizard appears and displays the Select an OVF template page.
Note
You must deploy the OVA from the vCenter, not from the ESXi host. Do not deploy the OVA inside a vApp.
-
Browse to the location of the Access Node and MediaAgent template file, select the file, and then click Next.
The Select a name and folder page appears.
-
Enter a name for the virtual machine (for example, VM_LinuxAccessNode), select a location, and then click Next.
The Select a compute resource page appears.
-
Select a resource pool (optional) and an ESX server, and then click Next.
The Review details page appears.
-
Review the template details, and then click Next.
The Configuration page appears.
-
Select a deployment configuration from the following options, and then click Next.
The Select storage page appears.
Size
Number of vCPUs
Memory Size
Software Installation Disk Size
Deduplication Storage Disk Size
Recommended Workload
Extra Small
2 virtual CPUs
16 GB
200 GB
100 GB
50TB BETB
Small
4 virtual CPUs
24 GB
300 GB
200 GB
100TB BETB
Medium
8 virtual CPUs
32 GB
400 GB
300 GB
150TB BETB
Large
12 virtual CPUs
48 GB
700 GB
600 GB
300TB BETB
Extra Large
16 virtual CPUs
64 GB
1.2 TB
1 TB
500TB BETB
-
Select the virtual disk format, select a datastore, and then click Next.
The Select networks page appears.
-
Select the source and destination networks, and then click Next.
The Customize template page appears.
-
Enter the following information:
-
Disk Size Configuration:
-
Software installation disk size: The disk size for software installation is set according to the sizing option selected. These values override the disk sizing options provided as part of our template.
-
Deduplication storage disk size: The disk size for deduplication is set according to the sizing option selected. These values override the disk sizing options provided as part of our template.
Note
Commvault recommends that you do not modify this value.
-
-
CS Configuration:
-
CS Hostname/IP: Host name or IP address for the CommServe system. This entry is case-sensitive.
Note
-
The host name for the CommServe is found in the CommServe Host Name field of the CommServe Client Properties dialog box (go to the CommCell Browser, right-click the CommServe client machine, click Properties, and then select the General tab). This entry is case-sensitive.
-
If a firewall is used, you must enter the Network Gateway Host Name in the CS Hostname/IP field.
-
-
CS Authcode: Users can use the auth code to register the Linux access node with CommServe. When using this field, you do not need to provide a username and password.
Note
For any CommCell (company), you can get the AuthCode from the Commcell (company) page under the Manage section.
-
Client Name: Short name for the virtual machine (for example, VM_LinuxAccessNode).
-
Client Hostname: Host name or IP address for the client. If you are using a static IP Address, then enter a resolvable hostname.
-
Client Group Name: Name of a client computer group; the Linux access node is assigned to this group if the group exists (the name is case sensitive and should not have any whitespaces).
-
-
Networking:
Note
Specify the following values if you are deploying the Linux access node using a static IP address or with DHCP server. These values override the DNS configuration obtained from the DHCP servers.
-
Use DHCP: Select this option or enter values for the Static IP Address, Netmask, and Gateway.
-
DNS Search Suffix: Identifiers for domains to be supported. You can enter multiple search suffixes separated by commas.
-
Primary DNS Server: IP address for the primary name server.
-
Secondary DNS Server: IP address for the secondary name server.
-
-
OS Configuration:
- New password for 'root': Password for the root user of the virtual machine.
-
Advanced Configuration (optional):
-
CS Username: User name for the CommCell Console.
-
CS Password: Password for the CommCell Console user.
-
Additional route configuration: Configuration to redirect traffic through a user-defined IP route.
-
Linux Timezone: Name of the timezone to be set for the client. This entry is case-sensitive and must match the exact name provided for UNIX operating systems.
-
NTP Server hostname: Fully-Qualified Domain Name(FQDN) of the NTP server with which the client will synchronize local time.
-
-
-
After verifying the information, click Next.
-
On the Ready to Complete dialog, review the deployment options and click Finish.
-
Power ON the VM.
Note
If you experience connection issues after deployment, you can add fully qualified host names and IP addresses for the access node and the CommServe server to the /etc/hosts files for both machines so that both systems can resolve host names locally.
What To Do Next
Perform the following additional tasks:
-
Review Cache Requirements to ensure that there is sufficient space for file recovery data.
-
Optional: Instead of deploying a separate Linux access node, you can convert a Linux MediaAgent to a Linux Access Node.
-
Optional: By default, automatic updates are applied daily for security updates. To modify the security level, perform the following steps after the access node has been deployed:
1. Modify the /etc/dnf/automatic.conf file to use one of the following options with the upgrade_type option, as shown in the last line of the following example:
[commands] # What kind of upgrade to perform: # default = all available upgrades # security = only the security upgrades upgrade_type = security
2. Run the systemctl restart dnf-automatic command to apply the specified upgrade level.