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.


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:

  • If the installation package was distributed as a DVD, make sure to mount the DVD.


    On AIX 6.1 (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


  1. Log on to the computer as root.

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


    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.

  2. Run the following command from the installation package or mount point:


    To run the installation as a SUDO user with root privileges, run the following command:

    sudo ./cvpkgadd

    The welcome page appears.

  3. Click Next.

    The Install Task page appears.

  4. Select Install packages on this machine and then click Next.

  5. Follow the instructions in the installation wizard.

    If you want to install Commvault in decoupled mode, where the client does not establish connections with the CommServe computer, complete the following steps:

    1. When you reach the CommServe Host Name page, do not specify the host name, and then click Next.

    2. On the Decoupled Install page, select Yes and then click Next.


  • 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