Use this procedure to install the core Commvault platform services in a Linux environment.
Note
This page covers basic platform installation. For production deployment, see Deployment.
Supported Linux operating systems
New installations on Windows aren't supported.
-
Red Hat Enterprise Linux 9.7-8.2
-
Rocky Linux 9.7-8.9
Hardware requirements
Use the following workload sizing guidance as a general estimate for deployment planning. You can combine physical servers, VMs, and laptops in the same deployment environment.
| Environment size | Typical workload size | CPU cores | Memory | Platform storage | Network |
|---|---|---|---|---|---|
| Small | 25 servers, 100 VMs, or 200 laptops | 4 | 24 GB | 100 GB | 1 Gbps |
| Medium | 500 servers, 1000 VMs, or 5000 laptops | 8 | 32 GB | 200 GB | 10 Gbps |
| Large | 2500 servers, 5000 VMs, or 10,000 laptops | 12 | 64 GB | 300 GB SSD | 10 Gbps |
| Extra large | 10,000 servers, 20,000 VMs, or 50,000 laptops | 16 | 128 GB | 500 GB enterprise-class SSD | 10 |
Download the installation media
-
From support.commvault.com or cloud.commvault.com, download the Linux installation media kit for the Commvault release that you're installing.
-
If needed, copy the installation media to the target system before starting the installation workflow.
The following video shows how to download the software:
Install the platform
Most customers can complete the installation by using the default installation settings.
-
Sign in to the Linux host by using an account with root or sudo privileges.
-
Mount or extract the installation media.
-
Start the installation program.
-
Select the platform components to install.
Most customers install:
-
CommServe services
-
MediaAgent services
-
Access node infrastructure
-
-
Configure installation settings.
Most customers can use the default values during the initial deployment.
-
Review the installation summary.
-
Complete the installation workflow.
-
Verify that platform services are running.
During installation, the installer configures required platform services, initializes database components, creates service accounts and directories, and applies communication settings automatically.
Installation duration depends on infrastructure performance, storage throughput, and selected platform components.
Validate the deployment
A healthy deployment includes running platform services, successful administrative access, operational storage communication, and no critical installation errors.
After installation:
-
Verify that you can access the platform.
-
Confirm that platform services are running.
-
Review installation logs for errors or warnings.
-
Validate storage communication.
-
Verify database connectivity.
-
Verify that platform jobs and services report healthy status.
Troubleshoot common installation failures
If installation fails:
-
Review installation logs for dependency failures, communication problems, filesystem issues, and service startup errors.
-
Verify that the target system uses a supported Linux operating system and filesystem configuration.
-
Verify that all required Linux package dependencies are installed.
-
Confirm DNS resolution, hostname resolution, and network connectivity between platform components.
-
Verify firewall connectivity and confirm that required network communication isn't blocked.
-
Validate storage availability, filesystem configuration, and available storage capacity.
-
Resolve any identified errors and restart the installation workflow.