Planning a Client Installation on UNIX, Linux, and Macintosh Computers

Use the following information to prepare for the installation of agents or other Commvault software on UNIX, Linux, and Macintosh computers.

1. Review Requirements

Review Commvault package requirements. For more information, see Commvault Packages Available for UNIX, Linux, and Macintosh Computers.

2. Download the Software

Choose one of the following methods to download the software:

3. Collect Cluster Environment Details

If you plan to install a Commvault package on a cluster environment, review the following information to prepare for the installation.


To determine whether the package can be installed on a cluster environment, see Cluster Configuration - Support.

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.

4. Determine the Configurations that Meet Your Requirements

Every environment has different requirements. Consider the following additional configurations and information prior to completing your installation planning:

Change the Branding of the Installation Package

You can have the installation wizard display your company name and a different software name, and adjust other branding settings.

For more information, see Changing the Branding Settings of a UNIX Installation Package.

Create User Groups on Macintosh Computers

You can create a user group with permissions to install the software.

For more information, see Creating User Groups to Install or Upgrade Commvault on a Macintosh Computer.

Enable Secure UNIX Access Permissions

You can enable the smart default UNIX access permissions behavior using an additional setting.

For more information, see Enabling Secure UNIX Access Permissions.

Install Restore-Only Agents

If you plan to use the client computer only as a destination for restoring backup data, you can install the agent in restore-only mode.

For more information, see Installation of Restore Only Agents.

Install 32-Bit or 64-Bit Agents

By default, 64-bit agents are installed on UNIX computers. Note the following:

  • On FreeBSD and Linux computers, if the installation program detects that the computer has a 32-bit operating system, the program automatically installs 32-bit agents.


    If you have a 64-bit Linux computer and you need to protect 32-bit applications, you can configure the installation program to install 32-bit agents. For more information, see Enabling 32-Bit Installations on 64-Bit Linux Computers.

  • AIX and Solaris computers must have a 64-bit operating system. Commvault does not support installations on 32-bit operating systems.

Install as a Non-Root User

If the computer where you want to run the installation does not have a root user defined, you can install agents as a non-root user.

For more information, see Installation of UNIX Agents by a Non-Root User.

On Macintosh clients, you cannot perform installation as a non-root user. You must install as root user or a SUDO user with root privileges.

Install as a SUDO User With Root Privileges

If you want to install as a SUDO user, add the SUDO user to the /etc/sudoers file.

For more information, see Adding SUDO Users with Root Privileges on a UNIX Client.

Install in a Predefined Directory or Mount Point

If you want to install in a predefined directory, review the considerations described in Installation of UNIX Agents in a Predefined Directory.

Install Commvault in a New Instance

If Commvault is already installed on the computer, but your environment requires a separate instance of the software, you can install Commvault in a new instance.

For more information, see Multi-Instance Installations.

Install Commvault on Computers Sharing the Same Host Name

If you want to use the same host name and CVD port number on multiple computers during the installation, you can configure the CommServe computer to allow clients that have the same host name and CVD port.

For more information, see Allowing a Duplicate Hostname and CVD Port During Client Installation.

Review Database Service Restart Requirement for Database Agents

If you plan to install database agents, the database services might need a restart to complete the agent installation. The installation wizard provides the required options to restart database services during the installation.

To determine whether your agent requires a database service restart, see Database Service Restart Requirements when Deploying UNIX Agents.