Installing Commvault Locally on UNIX, Linux, and Macintosh Computers Using the Installation Package

You can install agents and other Commvault software by using the installation package that was created from the Download Manager application.

If installing on a clustered environment, install the software on all the physical nodes of the cluster.

Note

For 1-Touch installations, see Installing the 1-Touch Server.

Before You Begin

Verify that the installation package that was created from the Download Manager includes the software that you want to install. If some of the software is missing, create a new installation package and include the required software. For more information, see Downloading Software for UNIX, Linux, and Macintosh Computers Using the Download Manager.
Prepare your environment and gather information that you must provide during the installation, as follows:
- For CommCell Console installations, see "Before You Begin" in Installing the CommCell Console.
- For MediaAgents, see Plan the MediaAgent Installation and Preinstallation Checklist for the MediaAgent on UNIX.
- For agents, see Plan the Installation on UNIX, Linux, and Macintosh Computers and the preinstallation checklist for that agent.
- For tools, see "Before You Begin" in Installing Commvault Tools.
If the installation package was distributed as a DVD, make sure to mount the DVD.
Important

On AIX 7 (or later) computers, if the installation package was converted to an ISO image file, do not use the loopmount command to mount the ISO. Instead, use one of the following methods:
- Install the software by using the CommCell Console.
- Mount the ISO on a Linux computer, and then export the NFS share to the AIX computer.
- Create a custom package, and then copy it to the local disk on the AIX computer.
If you want to show the client certificate screen in the install wizard (by default, it is not shown) based on hook file, create a lock file by running the following command:

touch /tmp/cvpkgadd_unlock_clientcertificate

Procedure

Log on to the computer as root.

In a cluster environment, log on to a physical node of the cluster as root.

Note

If the computer does not have a root user defined, you can install the File System Agent, Oracle Agent, and DB2 Agent by using a non-root user. For more information, see Installation of UNIX Agents by a Non-Root User.
Run the following command from the installation package or mount point:
```
./cvpkgadd
```
To run the installation as a SUDO user with root privileges, run the following command:
```
sudo ./cvpkgadd
```
The welcome page appears.

Note

If the home directory is mounted as read-only or is not world-writable, use the -tmpdir world_writable_temp_folder option to add a temporary directory.
Click Next.

The Install Options page appears.
Select one of the following:
- Media kit - Create a new CommCell Group: Select this option if you plan to install the CommServe, install feature release updates, install additional agents on an existing CommServe computer, or repair an existing instance.
- Media kit - Join an existing CommCell Group: Select this option if you plan to install a new client, install feature release updates, or install additional agents on an existing client.
- Advanced – For package based selection
  
  Note
  
  To view roles and packages, see Installation Roles and Packages.
Follow the instructions in the installation wizard.
On the Server Information page, enter the following information in the CommServe/Gateway Name field:
- Gateway_Hostname (use this format if the tunnel port of the network gateway is 8403)
- Gateway_Hostname:Port_Number (use this format if the tunnel port of the network gateway is anything other than 8403)
  Note
  - If you want to use multiple network gateways, you can enter multiple hostname ports separated by a semi-colon (;). For example: Gateway_Hostname1:Port_Number1;Gateway_Hostname2:Port_Number2
  - If you want to enter the port as an IPv6 address, use the following format: [2001:db8::216:cbff:xx:xx]:8080
  - If you want to install Commvault in decoupled mode, when you reach the Server Information page, do the following:
    - Leave the CommServe/Gateway Name field blank.
    - Uncheck The server will connect to this computer to complete the installation.
    - Click Next. The Decoupled Install screen appears.
    - Click Yes.
Click Next.

Note

The Web Console package is not installed with the Command Center. To install the Web Console, you must select the Web Console package during the CommServe installation.
If you are installing the software in a cluster environment, repeat the installation procedure for each physical node on the cluster.
If you installed the software in decoupled mode, register the client with the CommServe computer.

What to Do Next

For CommCell Console installations, see "What To Do Next" in Installing the CommCell Console.
For MediaAgents, see Postinstallation Tasks for the MediaAgent.
For agents, see Postinstallation Tasks for Clients, and then refer to the "Getting Started" page of each agent that you installed to perform the required agent configurations.
For tools, see "What To Do Next" in Installing Commvault Tools.