Creating a Laptop Backup Installation Package for UNIX

Use the following procedure to create a package configured for UNIX laptop computers.

Before You Begin

Download the latest Commvault software by using the Download Manager application. The application bundles an installation package with the software that you choose to download. You need the installation package to create the laptop package.

For more information, see Download Manager. During the creation of the installation package, make sure to include the File System Core.
Make sure that the computer where you plan to create the laptop package can connect to the CommServe computer. If there is no connectivity between the computers, the options to configure laptops, subclient policies and storage policies might not be available during the package creation.

Procedure

Log on to a UNIX computer as root.
Run the following command from the installation package or mount point:
```
./cvpkgadd
```
To run the installation as a SUDO user with root privileges, use the following command:
```
./sudo cvpkgadd
```
On the Install Task dialog, select Create custom package and click Next.
On the Custom Package Type dialog, select General package only and click Next.
On the Platform Selection dialog, select the operating systems that you want the laptop package to support, and click Next.
On the Package Selection dialog, select File System Core and click Next.
On the Custom Package Directory dialog, specify the location where you want to create the laptop package, and click Next.
On the Summary dialog, review your selections and click Next.
On the Record Answers dialog, select Yes to record your answers and click Next.
On the Instance Page dialog, type 1 to use Instance001. This configuration prevents users from installing multiple instances of the laptop package on the same computer.
On the Package Selection dialog, select File System Core to automatically select the software during the installation, and then click Next.
On the Client Host Information dialog, accept the default value and click Next.
On the Client Information dialog, accept the default value and click Next.
On the Install Directory dialog, specify the location where you want the laptop package to install the software, and then click Next.
On the Log Directory dialog, specify the location where you want the laptop package to create the logs, and then click Next.
On the Laptop & Desktop Backup dialog, select Yes and click Next.
On the UNIX Group Assignment dialog, specify whether you want to assign a dedicated UNIX group for all Commvault processes.
- If you want to assign a UNIX group, do the following:
  1. Select Yes and click Next.
  2. On the UNIX Group Selection dialog, enter the name of the UNIX group and click Next.
- If you do not want to assign a UNIX group, select No and click Next.
On the Permissions Details dialog, accept the default values. However, if you did not assign a dedicated UNIX group, you must set sufficient access permissions for other users (other than root users). Click Next to continue.
On the Install Agents for Restore Only dialog, select No and click Next.
On the Summary dialog, review your selections and click Next.
On the Configure the Client dialog, perform one of the following steps:
- If you can connect to the CommServe computer, configure the package with the necessary client settings. Select Yes and click Next.
- If you cannot connect to the CommServe computer, configure the package for decoupled installation. Select No, click Next, and continue with step 28.
  
  Note
  
  In a decoupled installation, the computer where the package is installed does not establish connections with the CommServe computer. After the installation, the computer must be registered. For information about registering the computer, see Registering Laptops.

On the Configure Firewall dialog, if there is no firewall between the laptop and the CommServe computer, select No and click Next.

If there is a firewall, select Yes, click Next, and use the following table to select the appropriate firewall configuration options.

Firewall Configuration	Action
Using Proxy (You have a firewall setup with proxy computer)	On the Configure Firewall dialog, select CommServe is reachable only through a proxy and click Next. On the CommServe Client Name dialog, enter the name of the CommServe client as it appears in the CommCell Console, and then click Next. On the CommServe Host Name dialog, enter the fully qualified domain name or IP address of the CommServe computer, and then click Next. On the Setting Proxy Connection to CommServe dialog, provide the following details of the proxy computer: For Proxy hostname or IP address, enter the hostname of the proxy through which the CommServe can be reached and press Enter. If the proxy is behind a port-forwarding gateway, then enter the host name or the IP address of the port-forwarding gateway. For Proxy short name, enter the client name of the Commvault proxy and press Enter. For Proxy HTTP/HTTPS tunnel port number, enter the tunnel port on which the proxy is expecting connections to the CommServe and press Enter. If the proxy is behind a port-forwarding gateway, then enter the port number of the port-forwarding gateway to reach the CommServe. On the Deciding If to Configure HTTP Proxy dialog, if the computer is not separated from the CommServe computer by a HTTP proxy, select No, click Next, and continue with step 24. If the computer is separated by a HTTP proxy, select Yes and click Next. On the Setting HTTP Proxy Configuration dialog, complete the following steps: For HTTP Proxy hostname or IP address, enter the hostname or IP address of the HTTP Proxy through which the CommServe can be reached. For HTTP Proxy port number, enter the port number of the HTTP Proxy through which the CommServe can be reached. Click Next and continue with Step 24.
One-Way Firewall - Client connects to the CommServe (You have a firewall setup without proxy computer)	On the Selecting Firewall Type dialog, select This machine can open connection to CommServe on a tunnel port and click Next. On the CommServe Client Name dialog, enter the name of the CommServe client as it appears in the CommCell Console, and then click Next. On the CommServe Host Name dialog, enter the fully qualified domain name or IP address of the CommServe computer, and then click Next. On the Port to Open Tunnel to CommServe dialog, enter the incoming port number through which the CommServe computer receives tunnel connection and click Next. On the Deciding If to Configure HTTP Proxy dialog, if the computer is not separated from the CommServe computer by a HTTP proxy, select No, click Next, and continue with step 24. If the computer is separated by a HTTP proxy, select Yes and click Next. On the Setting HTTP Proxy Configuration dialog, complete the following steps: For HTTP Proxy hostname or IP address, enter the hostname or IP address of the HTTP Proxy through which the CommServe can be reached. For HTTP Proxy port number, enter the port number of the HTTP Proxy through which the CommServe can be reached. Click Next and continue with Step 24.

Firewall Configuration

Action

Using Proxy

(You have a firewall setup with proxy computer)

On the Configure Firewall dialog, select CommServe is reachable only through a proxy and click Next.
On the CommServe Client Name dialog, enter the name of the CommServe client as it appears in the CommCell Console, and then click Next.
On the CommServe Host Name dialog, enter the fully qualified domain name or IP address of the CommServe computer, and then click Next.
On the Setting Proxy Connection to CommServe dialog, provide the following details of the proxy computer:
- For Proxy hostname or IP address, enter the hostname of the proxy through which the CommServe can be reached and press Enter. If the proxy is behind a port-forwarding gateway, then enter the host name or the IP address of the port-forwarding gateway.
- For Proxy short name, enter the client name of the Commvault proxy and press Enter.
- For Proxy HTTP/HTTPS tunnel port number, enter the tunnel port on which the proxy is expecting connections to the CommServe and press Enter. If the proxy is behind a port-forwarding gateway, then enter the port number of the port-forwarding gateway to reach the CommServe.
On the Deciding If to Configure HTTP Proxy dialog, if the computer is not separated from the CommServe computer by a HTTP proxy, select No, click Next, and continue with step 24.

If the computer is separated by a HTTP proxy, select Yes and click Next. On the Setting HTTP Proxy Configuration dialog, complete the following steps:
1. For HTTP Proxy hostname or IP address, enter the hostname or IP address of the HTTP Proxy through which the CommServe can be reached.
2. For HTTP Proxy port number, enter the port number of the HTTP Proxy through which the CommServe can be reached.
3. Click Next and continue with Step 24.

One-Way Firewall - Client connects to the CommServe

(You have a firewall setup without proxy computer)

On the Selecting Firewall Type dialog, select This machine can open connection to CommServe on a tunnel port and click Next.
On the CommServe Client Name dialog, enter the name of the CommServe client as it appears in the CommCell Console, and then click Next.
On the CommServe Host Name dialog, enter the fully qualified domain name or IP address of the CommServe computer, and then click Next.
On the Port to Open Tunnel to CommServe dialog, enter the incoming port number through which the CommServe computer receives tunnel connection and click Next.
On the Deciding If to Configure HTTP Proxy dialog, if the computer is not separated from the CommServe computer by a HTTP proxy, select No, click Next, and continue with step 24.

If the computer is separated by a HTTP proxy, select Yes and click Next. On the Setting HTTP Proxy Configuration dialog, complete the following steps:
1. For HTTP Proxy hostname or IP address, enter the hostname or IP address of the HTTP Proxy through which the CommServe can be reached.
2. For HTTP Proxy port number, enter the port number of the HTTP Proxy through which the CommServe can be reached.
3. Click Next and continue with Step 24.

On the CommServe Host Name dialog, enter the fully qualified domain name or IP address of the CommServe computer, and then click Next.
On the CommServe Per-Client Certificate dialog, if the CommServe requires a client certificate to register the computer, select Yes to provide the location where the client certificates are available. Click Next to continue.
If prompted, on the CommServe Authentication page, specify your CommCell credentials.

Note

This page is displayed only if you enabled user authentication on the CommServe computer.
On the Configure the Client Group dialog, if you want to associate the laptop to a client group, select the client group and click Next.
On the Configure the Subclient Policy dialog, select the laptop subclient policy and click Next.
On the Installation Status dialog, click Finish.

The laptop package is available in the location that you specified during the package creation.