Skip to content
Fix dependent Oracle libraries in Orale instant client packages for OS X 10.11 El Capitan
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information. Fix documents to note that fix_oralib.rb was obsolete. May 27, 2016 Add 'install_name_tool -add_rpath' sample. Jun 6, 2016
fix_oralib.rb Print caution that fix_oralib.rb has been obsolete. May 28, 2016


fix_oralib.rb has been obsolete since Oracle Instant Client 12.1 for OS X was released. The 12.1 client supports OS X 10.11 El Capitan, 10.10 Yosemite, and 10.9 Mavericks and can connect to Oracle Database 10.2 or later.

Look at this document to install 12.1.

The old fix_oralib.rb document was renamed to

Note for third party applications

Third party applications depending on the 12.1 client should link with -rpath. If an application is built without -rpath, the application fails to run with the following error if the 12.1 client is not installed in /lib, /usr/lib, /usr/local/lib or ~/lib.

$ application_file_name
dyld: Library not loaded: @rpath/libclntsh.dylib.12.1
  Referenced from: /path/to/application_file_name
  Reason: image not found
Trace/BPT trap: 5

In this case, run the following command to add rpath to the application.

$ install_name_tool -add_rpath /directory/name/containing/oracle/client application_file_name

ruby-oci8 and node-oracledb add -rpath to linker options by default.

As for cx_Oracle, you should add the environment variable FORCE_RPATH to link with -rpath at compilation time. (You have no need to set the environment variable at runtime.)

You can’t perform that action at this time.