Oracle Instant Client

Download ruby-oci8-VERSION.tar.gz from rubyforge.

note: 1.0 is stable version. 2.0-unstable is in development.

Download at least two packages "Instant Client Package - Basic" and "Instant Client Package - SDK" from Oracle Technology Network.

note: use 32-bit packages for 32-bit ruby even though the OS is 64-bit.

UNIX zip packages

 mkdir /opt
 mkdir /opt/oracle
 cd /opt/oracle
 unzip path/to/instantclient-basic-OS-VERSION.zip
 unzip path/to/instantclient-sdk-OS-VERSION.zip

Linux rpm packages

 rpm -i path/to/oracle-instantclient-basic-VERSION-ARCH.rpm
 rpm -i path/to/oracle-instantclient-devel-VERSION-ARCH.rpm

Windows

 C:
 mkdir C:\oracle
 cd c:\oracle
 unzip path/to/instantclient-basic-OS-VERSION.zip
 unzip path/to/instantclient-sdk-OS-VERSION.zip

UNIX

If /opt/oracle/instantclient10_1/libclntsh.so is not found, make a symbolic link to link the library.

 cd /opt/oracle/instantclient10_1
 ln -s libclntsh.so.10.1 libclntsh.so

Note:

• use libclntsh.sl instead of libclntsh.so on HP-UX PA-RISC.
• use libclntsh.dylib instead of libclntsh.so on Mac OS X.
• skip this step for AIX.

Set your OS's library search path to point to the installed location.

UNIX zip packages

For example:

 $ LD_LIBRARY_PATH=/opt/oracle/instantclient_10_2
 $ export LD_LIBRARY_PATH

Linux rpm packages

For example:

 $ LD_LIBRARY_PATH=/usr/lib/oracle/10.2.0.3/client/lib
 $ export LD_LIBRARY_PATH

Windows

For example:

 C:\> PATH=C:\oracle\instantclient_10_2;%PATH%

If you have a problem, report me.

UNIX or Windows(cygwin, mingw32)

 gzip -dc ruby-oci8-VERSION.tar.gz | tar xvf -
 cd ruby-oci8-VERSION
 make
 make install

ruby-oci8 try to get the Instant Client location from library search path.

note: If you use sudo, use it only when running 'make install'. sudo doesn't pass library search path to the executing command for security reasons.

Windows(mswin32)

 gzip -dc ruby-oci8-VERSION.tar.gz | tar xvf -
 cd ruby-oci8-VERSION
 nmake
 nmake install

ruby-oci8 try to get the Instant Client location from environment variable PATH.