Preinstallation Checklist for the MediaAgent on UNIX, Linux, and Macintosh

The MediaAgent manages the transmission of data between clients and backup media. The backup media is a storage device where you want to store the backed up data. For more information, see MediaAgent - Overview.

Use this preinstallation checklist to gather all of the information you will need during the installation.

Determine the Installation Location

Based on your environment, install the MediaAgent on the appropriate computer.


Where to install the software


On the computer that is configured with the backup media.


On the physical nodes of the cluster that are configured with the backup media.

Collect Cluster Environment Details

If you plan to install the MediaAgent on a cluster environment, review the following checklist to prepare for the installation:

Review Network TCP Port Requirements

The physical nodes that host the cluster server must have the same port numbers configured. For example, if you have a cluster server VS1 and three physical computers configured to host VS1, then the three physical computers must have the same network TCP port numbers configured on the network interface used by VS1.

Select Physical Nodes to Install the Software

Select the physical nodes (active and passive) on which you want to install the package. In the event of a failure, the active node can fail over to one of the passive nodes.

Collect Domain Administrator Account Details

If you plan to use the CommCell Console to install the software remotely on the physical nodes, the installation program requires the user name and password of the Domain Administrator account. The Domain Administrator account must have full domain administrative rights on the active and all passive nodes where you plan to perform the installation.

Windows fresh push installs with credentials that have the "Deny log on locally" and "Deny log on through Remote Desktop Services" restrictions are supported. But those accounts still need access to the admin share and remote registry.

Gather Installation Data

Refer to the items in this section to gather the information that you will need during the installation. Record the information before you begin installing the software, so you can refer to it during the installation.

You can install the MediaAgent using either the CommCell Console or the installation package created by the Download Manager. Any checklist item that applies to only one of these installation methods is noted.

Commvault package to install

  • For installations using the CommCell Console, install the MediaAgent package, which is listed under the Server category.

  • For installations using the installation package, install the MediaAgent package.


If the File System Agent is not installed on the computer, the File System Core and File System packages are automatically installed with the package you selected. The File System Agent will not consume any license.

To gather the required information for the File System Agent, refer to the Gather Installation Data section in the Preinstallation Checklist for the UNIX, Linux and Macintosh File System Agent.

Client computer details

If the File System Agent or another package is already installed on the computer, you are not required to gather all the computer details again. The level of detail depends on how the package you selected is installed, as follows:

  • For installations using the CommCell Console, the installation program requests only the name of the client computer.

  • For installations using the installation package, the installation program reads the details from the previous installation.

Index Directory

Select a directory where Commvault can store the index of your backups.

For best indexing results, the directory should be in a dedicated volume, and the overall path length, including the directory name, must be limited to 75 characters. For other recommendations, see Indexing Best Practices.