OpenLink Generic JDBC Driver Installation and Configuration

Review Preinstallation Documentation: OpenLink Generic JDBC Driver Pre-Installation Requirements

Installation

1. Login to your Unix or Linux client machine.
   
   
   
   
   
   
2. cd into the installation directory.
   
   
   
   
   
   
3. The installation files ship as an installation shell script, a driver, and an optional admin .taz file. The installation shell script should be ftp'd in ascii. The rest of the files should be ftp'd in binary, where applicable.
   
   
   
   
   
   
4. Export your JAVA_HOME variable. It should pass the full path to your JAVA installation.
   
   
   
   
   
   
5. Use the echo command to ensure that JAVA_HOME is set.
   
   
   
   
   
   
6. Run the following command to start the installation
   
   

   
   sh install.sh
   

   
   
7. If you have a pre-existing installation running on the machine, you will be presented with the following options:
   
   
   
   
   
   
8. The installation is complete.
   
   
   
   
   

Configuration

1. Execute the bash command to open a bash shell. If you do not have have the bash shell, substitute the sh command for the bash command. This will open the bourne shell.
   
   
   
   
   
   
2. Run the following command to set your CLASSPATH to include OpenLink's JDBC driver:
   
   

   
   . ./openlink.sh
   

   
   
   
   
   
   
   
3. No further configuration should be needed.
   
   • Driver Name: opljdbc3.jar, megathin3.jar, opljdbc2.jar, megathin2.jar, opljdbc.jar, or megathin.jar
     
   • Driver Class Name: openlink.jdbc3.Driver, openlink.jdbc2.Driver, or openlink.jdbc.Driver
     
   • Connection URL:
     
     

     
     jdbc:openlink://<Hostname>:[portnumber] [/UID] [/PWD] [/READONLY] [/SVT]
     		[/APPLICATION] [/FBS|FETCHBUFFERSIZE] [/ENCRYPTED] [/CHARSET] [/UNICODE]
     		[/DLF] [/DATABASE] [/OPTIONS] [/DRIVER] 
     

     
     
4. Here is a description of each of the parameters:
   
   • Hostname - Network Alias or IP address of machine that runs an OpenLink Request Broker instance.
     
   • Port Number - TCP port on which the Request Broker listens.
     
   • /UID - Database username.
     
   • /PWD - Database password.
     
   • /READONLY - Read-write or read-only session mode.
     
   • /SVT - A valid domain alias from the [Domain Aliases] section of the OpenLink server component's oplrqb.ini file. Default domain aliases represent the type of database agent to which the application intends to connect, e.g., DB2, Informix 2000, Oracle 8.1.x. Custom aliases may take any form.
     
   • /APPLICATION - The Application name. Enables connectivity when restrictive server side rules screen by application name.
     
   • /FBS - (also FETCHBUFFERSIZE) The Fetch Buffer Size. The Fetch Buffer Size is an integer that represents the number of rows to return during one fetch operation..
     
   • /ENCRYPTED - Sets the Encrypted flag for outgoing packets. /ENCRYPTED may pass '1', '0', 'Y', 'N', 'y', or 'n.' (This feature is disabled by default.)
     
   • /CHARSET - Specifies the charset of remote databases. The default value is read from System.getProperty("file.encoding").
     
   • /UNICODE - Instantiates unicode. The unicode connection isn't used by default. The value may be '1', '0', 'Y', 'N', 'y', 'n'(This feature is disabled by default.)
     
   • /DLF - Pushes large, binary objects to the end of the resultset. Smaller data types are retrieved first. This enhances performance. /DLF may be set to '1', '0', 'Y', 'N', 'y', or 'n.' (This feature is disabled by default.)
     
   • /DATABASE - Actual database name within a particular database environment.
     
   • /OPTIONS - Optional parameter that passes specialized database native client connection parameters. Do not use this parameter unless you need to pass Progress socket parameters or database native client parameters that enable a local OpenLink database agent to locate a remote database. Example parameters would be Oracle Net10 Service Names, Ingres vnodes, remote Informix instance names, or DB2 remote database aliases.
     
   • /DRIVER - The Driver name contained in curly brackets ({}). Used for DSN-Less connections to remote ODBC Drivers.

Examples

jdbc:openlink://localhost:5000/SVT=Ingres II/DATABASE=iidbdb/UID=ingres/PWD=ingres

jdbc:openlink://192.128.13.119:5000/SVT=Oracle 8.1.x/DATABASE=ORCL/UID=scott/PWD=tiger

jdbc:openlink://saturn:5000/SVT=Progress 91D/DATABASE=isports/OPTIONS=-S isports -N tcp -H saturn

jdbc:openlink://localhost:5000/SVT=SQLServer 2000/DATABASE=Northwind/UID=sa/OPTIONS= -S SATURN