Platform Specific Issues


Ubuntu 11.10 (Oneiric Ocelot)

If the following error occurs even though libc6-dev is installed,

Do you install glibc-devel(redhat) or libc6-dev(debian)?
You need /usr/include/sys/types.h to compile ruby-oci8.

You need to use ruby-oci8 2.1.0 or upper. Otherwise, run the following command and re-install ruby-oci8.

$ sudo ln -s /usr/include/linux/ /usr/include/sys

General Linux

Use the same bit-width of libraries with ruby. For example, x86_64 instant client for x86_64 ruby and 32-bit instant client for 32-bit ruby. It depends on the ruby but not on the OS. As for full client, x86_64 ruby cannot use with 32-bit full client, but 32-bit ruby can use with 64-bit full client because 32-bit libraries are in $ORACLE_HOME/lib32.

To check which type of ruby do you use:

file `which ruby`

Note: "`" is a back quote.

Mac OS X

OS X 10.7+

Use the latest 64-bit instant client. The older 64-bit ( instant client doesn't work. The older 32-bit instant client will work but only with 32-bit ruby or jruby (using JDBC).

Intel Mac (64-bit)

See How to setup Ruby and Oracle Instant Client on Snow Leopard. Note that setting the environment variable RC_ARCHS=x86_64 instead of ARCHFLAGS="-arch x86_64" will work fine also.

Intel Mac (32-bit)

See How to setup Ruby and Oracle Instant Client on Snow Leopard. Note that you need to replace x86_64 with i386 in the blog.

The Intel Instant client is for Mac OS X 10.5 Leopard. If you are using 10.4 Tiger, use one of the following workarounds.

PowerPC Mac

See How to setup Ruby and Oracle Instant Client on Snow Leopard. Note that you need to replace x86_64 with ppc in the blog.


You need a same compiler which is used to make ruby itself. For example, if the ruby is compiled by gcc, you need gcc. If it is compiled by Oracle Solaris Studio (formerly called as Sun Studio), you need Oracle Solaris Studio.

If you use's ruby and want not to install Sun Studio, you can edit rbconfig.rb by your self. (look at here)

If you use's ruby and

$ ruby -r rbconfig -e "p Config::CONFIG['GNU_LD']"

prints "yes", you may need to edit rbconfig.rb distributed with the ruby as follows:

from: CONFIG["LDFLAGS"] = "-L.  -Wl,-E"
to:   CONFIG["LDFLAGS"] = "-L. "


Oracle8-client port isn't available because it is too old. You need to use linux emulator.

I have not run ruby-oci8 on linux emulator, but I guess it will run as follows. If it works, please tell me.

If FreeBSD has a cross-compiler which can generate linux binaries, use it to compile ruby and ruby-oci8.

If FreeBSD doesn't have such a compiler, install a linux distribution which FreeBSD can emulate to a PC machine, make ruby and ruby-oci8 in the linux box and copy them to the FreeBSD box as follows.

On linux:

# make ruby
tar xvfz ruby-1.8.x.tar.gz
cd ruby-1.8.x
./configure --prefix=/usr/local/ruby-1.8.x --enable-pthread
make install
# setup instant client
# make ruby-oci8
tar xvfz ruby-oci8-1.0.x.tar.gz
cd ruby-oci8-1.0.x
make install
cd /usr/local/
tar cvfz ruby-1.8.x-linux.tar.gz ruby-1.8.x

Copy ruby-1.8.x-linux.tar.gz to the FreeBSD box.

On freebsd:

cd /compat/linux/usr/local
tar xvfz ruby-1.8.x-linux.tar.gz


You need a ruby which is linked with ''libpthread'' and ''libcl''.

Run configure.

tar xvfz ruby-1.9.x.tar.gz
cd ruby-1.9.x

Then open Makefile to add '-lpthread -lcl' to LIBS and run make and make install.

make install

The rest steps are described at install-full-client.


On some machines using a slow disk, you may get the following error.

Permission denied - conftest.exe

Edit mkmf.rb for a workaround.

def try_run(src, opt="")
  if try_link0(src, opt)
  # add the following one line.
  sleep 1 if /mswin32|cygwin|mingw32|bccwin32/ =~ RUBY_PLATFORM
  rm_f "conftest*"

See also: