Installing Oracle Instant Client

About Oracle Instant Client

Oracle Instant Client provides lightweight client-side connectivity for applications connecting to local or remote Oracle Databases on Linux x86-64 and Linux Arm (aarch64). Distributed as ZIP files or RPMs, it supports OCI, OCCI, ODBC, JDBC OCI, popular language APIs, and utilities such as SQL_Plus, SQL_Loader, Data Pump, genezi, and adrci, without requiring a full Oracle home. Packages include Basic, Basic Light, SDK, SQL*Plus, Tools, ODBC, Precompilers, and JDBC-OCI Supplement, offering reduced storage requirements, simple deployment, and full client functionality for supported operations.

Hardware Requirements for Oracle Instant Client Installation on Linux for Arm (aarch64)

Oracle Instant Client on Linux for Arm (aarch64) requires at least 256 MB of RAM, 350 MB of available disk space, and network connectivity between the client and its network environment.

Operating System Requirements for Linux for Arm (aarch64)

Linux for Arm (aarch64) installations must use a supported distribution, kernel, and package set. Oracle Linux 8 requires version 8.6 with Unbreakable Enterprise Kernel 7, kernel 5.15.0-6.80.3.1.el8uek.aarch64 or later, the listed development, runtime, networking, and system packages, and JDK 8; Oracle Linux 7 requires version 7.8 with Unbreakable Enterprise Kernel 5, kernel 4.14.35-1902.303.4.1.el7uek.aarch64 or later, packages including devtoolset-8 tools, glibc, libaio, and pcre, and JDK 8. The latest certification information should be checked before installation.

Verifying Oracle Instant Client Code Signing

Oracle Instant Client ZIP files and RPM packages can be verified before deployment to confirm package integrity and authenticity. Use Java jarsigner with the verify option for ZIP files, optionally including verbose certificate details, and use rpm commands to inspect signatures, compare key fingerprints, and run verbose checksum and signature validation. RPM verification may report NOKEY when the signing key is absent, while an installed and matching key produces successful signature and digest checks.

Installing Oracle Instant Client Packages

Oracle Instant Client can be installed from ZIP files, repository or manually downloaded RPMs, or the graphical setup wizard. ZIP installations require extracting packages together, installing libaio, configuring the runtime library path, optionally setting TNS_ADMIN and PATH, and placing optional network configuration files in network/admin. RPM installations use yum or dnf and generally permit only one client version at a time, while the setup wizard installs into an Oracle home and supports later deinstallation with runInstaller.

Installing Oracle Instant Client Basic Light

Basic Light is a smaller Instant Client package containing English client error messages and a limited set of Unicode, ASCII, and Western European character sets. It supports specified single-byte and Unicode client and database character sets, including US7ASCII, WE8MSWIN1252, UTF8, and AL32UTF8, and reports client-generated errors in English regardless of NLS_LANG language settings. It can be installed from ZIP files or RPMs by using the basiclite package in place of Basic; additional packages such as SQL*Plus require the Basic package.

Instant Client Libraries for OCI

OCI applications require the Instant Client libraries to reside in the same directory. The Basic package provides libclntsh.so.19.1, libclntshcore.so.19.1, libociei.so, and libnnz19.so, while Basic Light substitutes libociicus.so for libociei.so. Applications must expose only the appropriate Instant Client library directory through ldconfig or the operating system library path, avoiding simultaneous inclusion of an Oracle home library directory, and may store Oracle Net configuration files in network/admin.

Environment Variables for Oracle Instant Client

Key environment variables include LD_LIBRARY_PATH for locating libraries when ldconfig or another mechanism is not used, NLS_LANG for client language, territory, and character set behavior, TNS_ADMIN for locating Oracle Net and Instant Client configuration files, ORA_TZFILE for selecting an external or smaller time zone file, and ORA_SDTZ for the default session time zone. LD_LIBRARY_PATH is generally unnecessary for RPM installations, and ORACLE_HOME must not be set for Instant Client deployments.

About the Oracle Instant Client SDK

The Instant Client SDK supplies C and C++ headers, makefiles, demonstration programs, the Object Type Translator, and Linux build support for developing OCI and OCCI applications. It is available as ZIP or RPM packages for Linux x86-64 and Linux Arm (aarch64), and applications built with it can be deployed in compatible client environments. During Linux builds, the Instant Client directory must be available through the runtime library path, typically by setting LD_LIBRARY_PATH before linking or running applications.

Patching Oracle Instant Client Shared Libraries

Oracle Instant Client patching requires applying patches to a complete Oracle Database Client Administration installation with OPatch, regenerating the required data shared libraries and package files, and copying the results to the target Instant Client system. This process is not supported on Linux Arm (aarch64) and is unavailable on Microsoft Windows. Make targets can regenerate libociei.so, libociicus.so, individual package ZIPs, or all packages; regenerated content reflects the languages, character sets, and time zone files installed in the source Oracle home, and patch information can be inspected with genezi -v.