Running the Installation Script

The installer 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.

The examples in this procedure show the information that displays when you install the Local ODBC Client on a 32-bit UNIX machine.

To install the Local ODBC Client from files downloaded from the Web:

1. Download the appropriate tar file from the Progress DataDirect 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 Linux/UNIX workstation. How you transfer files from another system to your Linux/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 Linux/UNIX workstation, access the tar file and extract it. For example, enter:

   tar -xvof oaodbclocal32_*unixos*_*version*.tar

   where unixos is the UNIX or Linux operating system, for example, sunos, and version is the OpenAccess SDK version.

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

   ksh unixpi.ksh

   Setup prompts you to answer questions regarding the installation. Default answers for the questions are displayed in square brackets at the end of the prompt. To accept the default value, press ENTER.

4. The product information summary is displayed.

   Note: The following example shows the information for installing the Local ODBC Client on Linux; your messages may be different.

   The Product Setup is preparing the installation for DataDirect OpenAccess SDK - Local Client for ODBC and IP SDK (32-bit) on Linux.
   
   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.

5. Enter the fully qualified path of the target directory for the installation, or press ENTER to accept the default installation directory. If the directory does not exist, it will be created for you.

6. You are prompted for the installation of the Online Books:

   Would you like to install the Online Books for ODBC (Y/N) ? [N] :

   Enter Y to install the online documentation.

7. Product installation begins. You are prompted for the directory that contains a Java Runtime Environment (JRE).

   OpenAccess SDK Java services need to have the directory containing libjvm.so for the Service Attribute ServiceJVMLocation.
   Enter the full path of the directory where a Java Runtime Environment (JRE) is installed. (for example: /usr/java/jre)
   Enter the fully-qualified path to the JRE.
   

   The services for Java will not start unless a JVM can be located at the specified location. Refer to the OpenAccess SDK Administrator’s Guide for information about using the OpenAccess SDK Management Console to set the ServiceJVMLocation service attribute after installation.

8. A message appears, informing you when creation of the installation components is complete. Press ENTER.

9. The Product Registration prompt appears and requests the following information, one field at a time:

   Name

   Company

   Serial number

   IPE key

   Enter your name and your company or organization name. Then perform one of the following actions:

   • If you are installing an evaluation copy, enter eval as the serial number and leave the Key field empty. Skip to Step 12
   • For a licensed installation, use the serial number and IPE key provided to you by Progress DataDirect. Proceed to Step 10

10. The installer prompts you to review the information. Enter C to change the information, or press ENTER to continue.

11. The product license agreement appears. Press ENTER to advance through the license agreement. At the end, you are asked to accept the agreement: * Enter Y to accept the license agreement and continue with the installation. * Enter N to decline the agreement and end the installation.

12. After your installation is complete, you must set up the OpenAccess SDK environment for your users. See Setting Up the OpenAccess SDK Environment for Users for instructions.

13. See Testing the Installation for instructions on testing your the Local ODBC Client installation.

14. To uninstall the Local ODBC Client, delete the installation directory.