Installing Version 8 UNIX Clients on a Version 11 CommCell Environment

If you want to protect the file system data of a UNIX operating system that is not supported anymore by the latest Commvault versions, you can install the Commvault Version 8 software. You can use the UNIX computer with the V8 software only to perform basic backup and restore operations.

To use the V8 software, the UNIX computer must run one of the following operating systems:

Red Hat Linux 3.8
SuSE Linux 9.x
Ubuntu 7.x

Important

The UNIX File System Agent is the only V8 software supported in a V11 CommCell environment. Other V8 agents, including driver-based agents, and advanced features, such as firewall configurations, are not supported.

Before You Begin

Download the following Version 8 software from the Maintenance Advantage website:
- Installation DVD for UNIX, Linux, and Macintosh
- Service Pack 6 for the required UNIX operating systems
You must download the software to a location that is accessible by the computer where you want to install the V8 software.
To support the Commvault V8 software, your CommCell environment must meet the following requirements:
- The CommServe computer must have V11 Service Pack 4 installed.
- The CommServe computer and the MediaAgents must have open ports for V8 clients so that the clients can establish direct connections.
- If user authentication is enabled in your CommCell environment, you must provide your user credentials (user name and encrypted password) during the installation.
  
  To encrypt your password, complete the following steps:
  1. Log on to the CommServe computer.
  2. Create a folder to save the encrypted password in.
  3. From the command prompt, go to the Installation_Directory_Path/Base directory and run the following command:
```
 
SIMCallWrapper.exe -optype 100 -enc password -output C:\Folder_Name\pass.txt
```
    where C:\Folder_Name is the folder that you created and pass.txt is the file where you want to save the encrypted password.
To register the V8 client with your CommServe computer, you must provide an authentication code. To obtain an authentication code, contact deprecated@commvault.com.

Procedure

Log on to the computer as root.
To install the V8 software, mount the V8 installation DVD and then run the following command from the mount point:
```
cvpkgadd -decouple
```
Follow the instructions in the installation wizard, and make sure to select the UNIX File System Agent.

Note: The software is installed in decoupled mode. In decoupled mode, the computer does not establish connections with the V11 CommServe computer during the installation. The computer is registered later in the process.
Install V8 Service Pack 6.
Download the v8_install_script.zip, extract the cvpkgxml script, and copy the script to the installation directory (for example, /opt/simpana).
From the installation directory, run the script by using one of the following commands:
- For CommCell environments with user authentication, use the following command:
```
 
./cvpkgxml -cs-short CommServe_Name -cs CommServe_Hostname -user UserName -password EncryptedPassword
```
- For CommCell environments without user authentication, use the following command:
```
 
./cvpkgxml -cs-short CommServe_Name -cs CommServe_Hostname
```
where:
- CommServe_Hostname is the host name or fully qualified domain name of the CommServe computer.
- EncryptedPassword is the encrypted password that was saved in the location you specified. For example, C:\Folder_Name\pass.txt.
Copy the ic.xml file that was generated after running the cvpkgxml script to a location that is accessible by the CommServe computer.
Log on to the CommServe computer and retrieve the ic.xml file.
Open the command prompt, go to the Installation_Directory_Path/Base directory, and run the following command to register the V8 client:
```
 
SIMCallWrapper.exe -input ic_XML_file -output XML_output_file
```
where:
- ic_XML_file is the directory path where you saved the ic.xml file.
- XML_output_file is the directory path where you want to save the output of the SIMCallWrapper command. For example, C:\temp\output.xml
Log on to the CommServe by using the qlogin command and run the following qoperation command to authenticate the client registration:
```
 
qoperation execscript –sn QS_UpdateClientRelease.sql –si ClientName -si 8.0 -si AuthCode
```
where:
- ClientName is the name of the V8 client.
- AuthCode is the authentication code that you obtained as stated in the Before You Begin section.
Update the password of the V8 client in the CommServe database.
1. Download the UpdateV8ClientPassword.zipfile, extract the UpdateV8ClientPassword.sqle file, and then copy the script to the Installation_Directory_Path/Base directory on the CommServe computer.
2. From the CommServe computer, at the command line, go to the download location, and then type the following command:
```
 
Qscript -f UpdateV8ClientPassword.sqle -i ClientName ClientPassword AuthCode
```
  where:
  - ClientName is the name of the V8 client.
  - ClientPassword is the password stored in the ic.xml file.
  - AuthCode is the authentication code that you obtained as stated in the Before You Begin section.

Uninstalling Version 8 UNIX Clients

Installing Version 8 UNIX Clients on a Version 11 CommCell Environment

Before You Begin

Procedure

Related Topics