%META:TOPICPARENT{name="MultiTierInstallJDBCUnix"}%
== <nop>OpenLink Generic JDBC Driver Installation and Configuration==

**Review Preinstallation Documentation:**  [[PreInstallClientUNIX|OpenLink Generic JDBC Driver Pre-Installation Requirements]]

===Installation===

# Login to your Unix or Linux client machine.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Login.png" style="wikiautogen"/>%BR%%BR%
# cd into the installation directory.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_CD_Demos.png" style="wikiautogen"/>%BR%%BR%
# 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.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_LS_Files.png" style="wikiautogen"/>%BR%%BR%
# Export your JAVA_HOME variable. It should pass the full path to your JAVA installation.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Export_JAVA.png" style="wikiautogen"/>%BR%%BR%
# Use the echo command to ensure that JAVA_HOME is set.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Echo_Java.png" style="wikiautogen"/>%BR%%BR%
# Run the following command to start the installation
{{{
sh install.sh
}}}
# If you have a pre-existing installation running on the machine, you will be presented with the following options:
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Install_2.png" style="wikiautogen"/>%BR%%BR%
# The installation is complete.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Install_End.png" style="wikiautogen"/>%BR%%BR%

===Configuration===

# 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.
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC3_Bash.png" style="wikiautogen"/>%BR%%BR%
# Run the following command to set your CLASSPATH to include <nop>OpenLink's JDBC driver: 
{{{
. ./openlink.sh
}}}
%BR%%BR%<img src="%ATTACHURLPATH%/JDBC_openlinksh.png" style="wikiautogen"/>%BR%%BR%
# 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] 
}}}
# Here is a description of each of the parameters: 
#* **Hostname** - Network Alias or IP address of machine that runs an <nop>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 <nop>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 [[MTServerConfigConnectOptions|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 <nop>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
}}}