Oracle Instant Client ODBC Release Notes

Oracle's Instant Client ODBC software is a standalone package that offers the full functionality of the Oracle ODBC driver (except the Oracle service for Microsoft Transaction Server) without needing a traditional ORACLE_HOME installation.

Oracle Instant Client packages can be downloaded from OTN.

Installing Oracle Instant Client Basic and Basic Lite

Instant Client ODBC depends on the Oracle Instant Client Basic or Basic Lite package from OTN.

For details on installing the Oracle Instant Client Basic and Basic Lite packages. Refer to the Oracle Call Interface Programmer's Guide .

A demonstration of installing the Instant Client Basic package is on the Application Development with Oracle Database channel.

Installing Oracle Instant Client ODBC

On Linux and UNIX
The procedure to install Instant Client ODBC on Linux/UNIX is:

  1. Install the Instant Client Basic or Basic Lite package as described above.
  2. Unzip the Instant Client ODBC package.
  3. Install the unixODBC driver manager if it is not already available. Refer to the "Recommended unixODBC Driver Manager version" section in this document for more information.
  4. Execute odbc_update_ini.sh from the Instant Client directory.

Usage: odbc_update_ini.sh <ODBCDM_Home> [<Install_Location> <Driver_Name> <DSN> <ODBCINI>]

Parameter
Description
ODBCDM_Home unixODBC driver manager home directory path (Mandatory)
Install_Location* Oracle Instant Client directory path. Default path is current directory (./)
Driver_Name* Driver name to identify the Oracle ODBC driver resides in current Oracle Instant Client home. Default name is "Oracle 12c ODBC driver" for Oracle 12c Instant Client
DSN* Sets ODBC DSN name. Default name is "OracleODBC-12c" for Oracle 12c Instant Client
ODBCINI* Directory path of the .odbc.ini file. The default path is the user's home directory (~/.odbc.ini)
* - Optional parameters


On Windows
The procedure to install Instant Client ODBC on Windows is:

 

  1. Install the Instant Client Basic or Basic Lite package, as described above.
  2. Unzip the Instant Client ODBC package.
  3. Execute odbc_install.exe from the Instant Client directory. If Instant Client is 11g or lower, start the command prompt with the Administrator privilege. To install with Japanese language support, execute the command 'odbc_install.exe JA'.

Environment setup for ODBC application

An ODBC application has to load the Oracle Instant Client ODBC driver's shared library file (see next section) to connect to Oracle database. On Linux/Unix the directory path of the shared library should be set in the environment variable LD_LIBRARY_PATH, or platform equivalent. It can also be configured in /etc/ld.so.conf. On Windows it should be set in the PATH environment variable. Refer to the topics Environment Variables for OCI Instant Client and Database Connection Strings for OCI Instant Client in the Oracle Call Interface Programmer's Guide for setting up the Database Connection string and related environment variables like TNS_ADMIN, TWO_TASK, LOCAL etc.

Content of the Oracle Instant Client ODBC Package

Linux and UNIX
Windows
Description
libsqora.so.12.1 or libsqora32.so.11.1 sqora32.dll Oracle ODBC driver shared library
odbc_update_ini.sh odbc_install.exe, odbc_uninstall.exe Installation file
Not available sqoras32.dll, sqresus.dll, sqresja.dll Oracle ODBC driver configuration dialog window (GUI)
help/ help/ Help System

Patching Oracle Instant Client ODBC

Note: Backup the Oracle ODBC driver shared library and other files before patching them.

On Linux and UNIX
Patching the Instant Client ODBC driver on Linux/UNIX can be done by generating the Instant Client ODBC package and Basic or Basic Lite package in a patched ORACLE_HOME. The procedure for patching and generating Instant Client ODBC, Basic and Basic Lite packages in Oracle 12c is given in the Oracle Call Interface Programmer's Guide . These new packages should then be unzipped into the Instant Client directory that needs to be patched. This method of patching is recommended.

Alternatively the Oracle Instant Client ODBC driver can be patched by copying the files that are listed below from a patched ORACLE_HOME:

  • ODBC driver shared library file:
    For 12c: libsqora.so.12.1
    For 11g: libsqora.so.11.1
  • Required additional files when using Oracle Basic Instant Client:
    For 12c: libociei.so, libclntshcore.so.12.1, libclntsh.so.12.1, libnnz12.so, libons.so
    For 11g: libclntsh.so.11.1, libociei.so, libnnz11.so
  • Required additional files when using Oracle Basic Lite Instant Client:
    For 12c: libclntsh.so.12.1, libclntshcore.so.12.1, libociicus.so, libnnz12.so, libons.so
    For 11g: libclntsh.so.11.1, libociicus.so, libnnz11.so

 

On Windows
Patching the Instant Client ODBC driver on Windows can be done only by manually copying the ODBC driver shared library files and supporting library files from a patched ORACLE_HOME or from an unpacked Oracle Database Bundle patch. These should be copied into the Instant Client directory. Generating an Instant Client ODBC package is not available on Windows.

The patchable files that must be copied to the Instant Client directory:

  • ODBC driver shared library files: sqora32.dll, sqoras32.dll, sqresus.dll, sqresja.dll
  • Required additional files when using Oracle Basic Instant Client:
    For 12c: oraociei12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociei12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    For 11g: oraociei11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociei11.sym, orannzsbb11.sym, oci.sym, ociw32.sym
  • Required additional files when using Oracle Basic Lite Instant Client:
    For 12c: oraociicus12.dll, orannzsbb12.dll, oci.dll, oraons.dll, ociw32.dll, oraociicus12.sym, orannzsbb12.sym, oci.sym, ociw32.sym
    For 11g: oraociicus11.dll, orannzsbb11.dll, oci.dll, ociw32.dll, oraociicus11.sym, orannzsbb11.sym, oci.sym, ociw32.sym

Note: While copying from the Oracle Database Bundle patch, some of the files above may be missing. This implies that those files are unchanged and do not need to be patched.

Uninstalling Oracle ODBC Instant Client

On Linux and UNIX
The procedure to uninstall Instant Client ODBC on Linux/UNIX is:

  1. Remove the Oracle ODBC driver entry from the odbcinst.ini file of the unixODBC driver manager. The default name of this entry is [Oracle 12c ODBC driver].
  2. Remove the DSN entry of the Oracle ODBC driver from odbc.ini. The default name of the DSN entry is [OracleODBC-12c].
  3. Delete all files and directories in the Instant Client ODBC directory.

 

On Windows
The procedure to uninstall Instant Client ODBC on Windows is:

  1. Remove the DSN associated with the Oracle ODBC driver in the ODBC Data Source Administrator (odbcad32) console.
  2. Execute odbc_uninstall.exe from the Instant Client ODBC directory.
  3. Delete all files and directories in the Instant Client ODBC directory.

 

Recommended unixODBC Driver Manager version for Linux/UNIX

For Instant Client 12c:

Platform
unixODBC Driver Manager Version
Linux 32bit, 64bit 2.3.1
Solaris SPARC64 32bit, 64bit 2.3.1
Solaris 32bit, 64bit 2.3.1
AIX 5L 32bit, 64bit 2.3.1
HP IA64 32bit, 64bit 2.3.1
z/Linux 31bit, 64bit 2.3.1

For Instant Client 11g:

Platform
unixODBC Driver Manager Version
Linux 32bit, 64bit 2.2.11, 2.2.14
Solaris SPARC64 32bit, 64bit 2.2.11
Solaris 32bit, 64bit 2.2.11
AIX 5L 32bit, 64bit 2.2.11
HP IA64 32bit, 64bit 2.2.11
z/Linux 31bit, 64bit 2.2.11

Oracle ODBC Driver Resources

Related Technologies