installDSDriver - Extract IBM Data Server Driver components command

Installs IBM® Data Server Driver (ds driver) components and creates db2profile and db2cshrc files.

On Linux® and UNIX operating systems, the installDSDriver command installs and upgrades all the components of the IBM Data Server Driver in the specified directory and removes the .tar files that were extracted.

The installDSDriver command from the 32-bit IBM Data Server Driver Package software creates the db2profile file for the Bash or Korn shell and the db2cshrc file for the C shell. The db2profile and db2cshrc files are created under the root installation path (INSTALL_PATH) of the IBM Data Server Driver Package software.

The installDSDriver command from the 64-bit IBM Data Server Driver Package software creates following script files under the root installation path (INSTALL_PATH) of the IBM Data Server Driver Package software:

The db2profile file for the 64-bit Bash or Korn shell environment.
The db2profile32 file for the 32-bit Bash or Korn shell environment.
The db2cshrc file for the 64-bit C shell environment.
The db2cshrc32 file for the 32-bit C shell environment.

Authorization

None

Prerequisite

The unzip utility must be installed on the operating system before running the command.

Command syntax

Command parameters

-h

Displays usage information.

-upgrade <existing-dsdriver-path>

Upgrades existing IBM Data Server Driver Package software installation specified in the <existing-dsdriver-path> path. All user created files are preserved in the existing IBM Data Server Driver Package software installation path, that includes following files:

The db2cli.ini file.
The db2dsdriver.cfg file.
The Db2® connect license file.

If the -upgrade <existing-dsdriver-path> option is not specified, the installDSDriver script installs the IBM Data Server Driver as a new installation.

-installdtrc

Tells the installDSDriver script to copy platform-specific DTRC client library files from the specified network drive path to the installed ds driver location during ds driver installation. Takes the location of a bulk deploy root directory as the input. A message is displayed to the standard output and log file to indicate whether the files are successfully copied:

- Copying DTRC
          bulk deploy library files...--> SUCCESSFUL.

If the files are not copied successfully, the following message is displayed:

- Copying DTRC
          bulk deploy library files...--> FAILED.

This option is provided only with the IBM data server driver package.

Usage notes

The installDSDriver script from the 64-bit IBM Data Server Driver Package software installs both 32-bit and 64-bit drivers and removes both 32-bit and 64-bit tar files.
For the 32-bit IBM Data Server Driver Package software installation, the db2profile file is for the Bash or Korn shell and the db2cshrc file is for the C shell.

To run the db2profile or db2cshrc script from the installation path, you can issue the following commands:

Korn or Bash shell environment:
```
$ . ./db2profile
```
C shell environment:
```
source ./db2cshrc
```

To configure the 32-bit drivers after installing the 64-bit IBM Data Server Driver Package software, run the db2profile32 or db2cshrc32 script from the installation path:

Korn or Bash shell environment:
```
$ . ./db2profile32
```
C shell environment:
```
source ./db2cshrc32
```

To install the DTRC client on several machines, the platform specific DTRC client library files from the network drive are automatically copied to the ds driver location during ds driver installation. For Linux and Unix, this is achieved through -installdtrc. If the DTRC bulk deploy library files already exist, installDSDriver will overwrite the existing DTRC library files. This is also supported during the upgrade of the installed dsdriver location. During the upgrade, you may use -installdtrc along with -upgrade to the copy or overwrite the DTRC bulk deploy library files. If copying the DTRC bulk deploy library file fails, the log file will be updated with the reason along with the required user response. The log file will be located inside the dsdriver directory. -installdtrc is only available from v11 onwards.

For Windows, the option of copying the DTRC bulk deploy library files during installation is provided only with the silent installation. Set the EI_BULK_DEPLOY_ROOT_DIRECTORY keyword to the path of the bulk deploy root directory.