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:
- If you plan to install from the CommCell Console, no action is required. The Commvault software is automatically downloaded during the installation.
Note: Before you use the CommCell Console to perform installations, you must review some prerequisites in Prerequisites for Installations Using the CommCell Console.
- If you plan to use the installation package, create an installation package with the required software. See Downloading Software for UNIX, Linux, and Macintosh Computers Using the Download Manager.
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.
Note: 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.
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.
Note: 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.
Last modified: 2/6/2020 4:49:42 PM