How To Install and Configure the Lite Edition ODBC-to-JDBC Bridge Drivers (Linux)

Pre-Installation Guide

  1. The installation files ship as an installation shell script, a driver and admin .taz file, and a license .lic file. The installation shell script should be ftp'd in ascii. The rest of the files should be ftp'd in binary, where applicable.
  2. Downloads these documents, and place them in your desired installation folder.
  3. Start the installation process by opening the installation directory using cd, and running sh
  4. You must choose a TCP port on which to run your HTTP-based iODBC Data Sources Administrator. The default is 8000. You will need to know this port number and your local machine's IP address or hostname to access your Admistrator in a Web browser. This is how you call it: http://machine:portnumber
  5. Log File? enables you to rename and relocate your Administrative Assistant's log file. It is best to go with the default.
  6. You can choose to log all requests. This is not diagnostic-level odbc tracing or connection logging. The default is no.
  7. You can change the iODBC Data Source Administrator's default username from "admin." This is the name that you will need to login to OpenLink's HTTP-based iODBC Data Sources Administrator.
  8. You can change the iODBC Data Source Administrator's default password from "admin."
  9. The installation is complete.

Installation Guide

  1. Prerequisites:
    • You MUST be proficient in using a Unix shell.
    • You MUST be proficient in using a Unix editor such as vi.
    • You MUST be in possession of relevant database connectivity details such as Database name, Username, password, etc.
  2. Open the file <OPENLINK_INSTALL>/bin/odbc.ini with a suitable text editor such as vi.
  3. Locate and edit the sample OpenLink ODBC To JDBC Bridge data source (DSN) created during the installation process and edit as follows:
          Driver            = <OPENLINK_INSTALL>/lib/
          UserName          = <Username>
          JdbcDriver        = <JDBC Driver Class>
          URLString         = jdbc:openlink://<Connection URL>
  4. Use the iodbctest tool which is packaged with the HTTP-based OpenLink ODBC Administrator as follows:
          # cd <OPENLINK_INSTALL>
          # . ./
          # iodbctest jdbc
    iODBC Demonstration program
    This program shows an interactive SQL processor
    Driver Manager: 03.52.0507.0105
    Driver: 06.02.1217 OpenLink Generic ODBC Driver (

  5. You should now be able to issue SQL statements directly against the target database.

Additional Information:
The bitness of the ODBC Driver for MySQL is determined by the bitness of your ODBC client application.
That is, if your ODBC client application is 32-bit then the Generic ODBC Driver component MUST also be 32-bit.

Configuration Guide

  1. You must have a Java Runtime Environment (JRE) that is compatible with the Single-Tier (Lite Edition) ODBC Driver for JDBC Data Sources.
    • Generally, the latest JVM from is the best choice.
    • If using a 64-bit ODBC Driver, you must have a 64-bit JVM.
  2. You must possess third-party or native JDBC drivers that connect to your target database.
  3. If your 3rd party JDBC Driver connection attempt isn't successful, check that the JDBC driver jar file (or a symbolic link to it) is included in the active $CLASSPATH.
    • Note, supporting Java libraries (or links to them) may also need to be referenced by this variable value.
    • Finally, directories containing other supporting libraries may need to be referenced by other shared library environment variables (e.g., LD_LIBRARY_PATH, LIBPATH, SHLIB_PATH).