> # Installing the ODBC Client on Linux and UNIX

> If you are installing:

> - From a DVD, see one of the following sections:
> - "Installing on a Workstation without a DVD-ROM Drive"
> - "Installing on a Workstation with a DVD-ROM Drive"
> - From files downloaded from the Web, see "Installing From Downloaded Files"

> NOTE: Installation on Linux and UNIX automatically includes both the 32-bit and 64-bit ODBC Client.

> ### Installing on a Workstation without a DVD-ROM Drive

> Installing the ODBC Client on a UNIX workstation without a DVD-ROM drive involves the following steps:

> - Transferring files to your UNIX workstation
> - Extracting the files
> - Running the installation script
> - Setting up the SequeLink environment for your users

> If your workstation does not have a DVD-ROM drive, you must mount the DVD on another computer with a DVD-ROM drive and transfer the tar file in binary format to your UNIX workstation using file transfer software (for example, FTP). After the tar file is transferred to your UNIX workstation, extract the files from the tar file and run the installation script.

> See "Mounting Your DVD" for information on mounting the DVD.

> #### Transferring Files

> 1. Mount the DVD on a computer with a DVD-ROM drive and FTP capability.
> 2. Log on to the UNIX workstation where you want to install the ODBC Client software.
> 3. Create a temporary directory on the UNIX workstation. This directory will be used to run the installation script and can be deleted after installation. For example, enter:

> mkdir /tmp/sqlnk

> 4. On the system from which you will be transferring the files, change to the directory on the DVD that applies to your system and client. For example, to install the ODBC Client on Solaris, change to the sqlnk60/solaris/client/ directory on the DVD.
> 5. From this system, transfer the file slclient.tar in binary format using file transfer software to the temporary directory you created in Step 3.

> How you transfer files from another system to your UNIX workstation depends on your TCP/IP product and your system's operating system. For more information about transferring files, refer to the documentation supplied with your TCP/IP product.

> IMPORTANT: Transfer the files in binary format. If you transfer files in the wrong format, the installation will fail.

> #### Extracting ODBC Client Files

> On your UNIX workstation, access the tar file you transferred to the temporary directory and extract it. For example, enter:

>     tar -xvof slclient.tar

> #### Running the Installation Script

> When you run the ODBC installer, it prompts you for choices you need to make and information you need to supply. Default answers to questions are enclosed within square brackets, [ ]. To accept the default, press ENTER.

> To run the installation script:

> 1. Enter the following command to run the installation script:

> ksh unixpi.ksh

> 2. The product information summary is displayed.

> NOTE: The following example shows the information for installing the SequeLink Client for ODBC on Solaris; your messages may be different.

> The Product Setup is preparing the installation for SequeLink for ODBC Client on Solaris.

> Do you want to continue (Y/N) ? [Y]

> Enter `Y` to continue the installation. Enter `N` to stop the installation; no software will be installed.

> 3. The Product License Agreement screen is displayed. Press any key to advance through the license agreement.

> Enter `YES` to accept the agreement and continue the installation. Enter `NO` to stop the installation; no software will be installed.

> 4. Enter the fully qualified path of the target directory for the SequeLink Client for ODBC software. If this directory does not exist, it will be created for you.
> 5. If the Product Setup detects a previously installed version of the SequeLink Client for ODBC in the directory you specified, it asks you if you want to make a backup of your existing installation.

> Enter `Y` to create a backup of your existing installation. The backup will be created in the installdir/backup directory, where installdir is your SequeLink Client for ODBC installation directory, in a file with the format slclientmmddyy.tar, where mmddyy is the date the file was created.

> 6. The SequeLink Client for ODBC is installed. A message appears, informing you when the installation is complete.
> 7. After your installation is complete, you must set up the SequeLink environment for your users. See "Setting Up the SequeLink® Environment for Users" for instructions on setting up the SequeLink environment for your users.
> 8. For instructions on testing your SequeLink installation, refer to the SequeLink Administrator's Guide.

> ### Installing on a Workstation with a DVD-ROM Drive

> If your UNIX workstation has a DVD-ROM drive, you can use the Product Setup to install the ODBC Client and other DataDirect Technologies products on your DataDirect DVD. The Product Setup prompts you for information you need to supply during installation and provides default values for this information. Default answers to questions are enclosed within brackets, [ ]. To accept the default, press ENTER.

> To install the ODBC Client:

> 1. Mount the DVD.
> 2. Change to the top-level directory on the DVD.
> 3. Enter the following command to run the Product Setup:

> ksh unixmi.ksh

> The Product Setup displays a list of all available products.

> 4. Select the product you want to install. For example, select one of the following products:
> - ODBC Client for Solaris
> - ODBC Client for AIX
> - ODBC Client for Linux
> - ODBC Client for HP-UX
> - ODBC Client for z/OS USS
> 5. The product information summary is displayed.

> Follow Step 2 through Step 8 under "Running the Installation Script" to complete the installation.

> ### Installing From Downloaded Files

> 1. Download the appropriate tar file from the DataDirect Technologies Web site. Download instructions are available on the DataDirect Technologies Web site.

> If you are downloading to a machine other than the target machine, you will need to transfer the files (in binary format) to your UNIX workstation. How you transfer files from another system to your UNIX workstation depends on your TCP/IP product and your system's operating system. For more information about transferring files, refer to the documentation supplied with your TCP/IP product.

> IMPORTANT: Transfer the file in binary format. If you transfer files in the wrong format, the installation will fail.

> 2. On your UNIX workstation, access the tar file and extract it. For example, enter:

> `tar -xvof slclient.tar`

> 3. Enter the following command to run the installation script:

> ksh unixpi.ksh

> 4. The product information summary displays:

> Follow Step 2 through Step 8 under "Running the Installation Script" to complete the installation.

> ### Setting Up the SequeLink® Environment for Users

> For each SequeLink user, set up a SequeLink environment by running the appropriate shell script in the SequeLink directory:

> - If using the Korn or Bourne shell, enter: `. sqlnk.sh`.

> NOTE: This script can also be sourced from the user's .profile script.

> - If using the C shell, enter: . `source sqlnk.csh`

> NOTE: This script can also be sourced from the user's .login script.

> - On 64-bit platforms, use the 64-bit versions of these scripts, for example, sqlnk64.sh.