Installing Oracle Instant Client Using RPMs

Learn how to install Oracle Instant Client on Linux x86-64 and Linux for Arm (aarch64) platforms by downloading the RPMs using the dnf install command.

Note:

Starting with 19c, by default, you can install only one version of the Oracle Instant Client RPM packages at a time. If you need multiple versions, use the Oracle Instant Client zip files.

Removing Earlier Oracle Instant Client Installations

Remove any earlier installations of Oracle Instant Client using either dnf or yum before you start a fresh installation.

  1. List the currently installed Oracle Instant Client packages. For example:

    For Oracle Linux 8 and later:

    $ sudo dnf list installed | grep instantclient

    The output will be like:

    oracle-instantclient19.5-basic.x86_64 19.5.0.0.0-1 @/oracle-instantclient19.5-basic-19.5.0.0.0-1.x86_64

  2. Remove the Oracle Instant Client packages. For example:

    For Oracle Linux 8 and later on Linux x86-64: 

    $ sudo dnf remove oracle-instantclient19.5-basic.x86_64

  3. Remove the legacy Oracle Instant Client yum repository setup package. For example:

    For Oracle Linux 8:

    $ sudo dnf remove oracle-release-el8

    For Oracle Linux 9:

    $ sudo dnf remove oracle-release-el9

  4. A reboot is not required.

Installing Oracle Instant Client From the yum Server

If you are using Oracle Linux and have configured your Oracle Linux yum server, then you can install Oracle Instant Client using the dnf install command.

  1. Install the Oracle Linux release package to configure repository definitions for Oracle Instant Client:

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient-release-23ai-el8

    For Oracle Linux 9:

    $ sudo dnf install oracle-instantclient-release-23ai-el9

  2. Go to the Oracle Instant Client repositories to view the available Oracle Instant Client packages:

    For Oracle Linux 8 on Linux x86-64:

    https://yum.oracle.com/repo/OracleLinux/OL8/oracle/instantclient23/x86_64/index.html

    For Oracle Linux 9 on Linux x86-64:

    https://yum.oracle.com/repo/OracleLinux/OL9/oracle/instantclient23/x86_64/index.html

    For Oracle Linux 8 on Linux for Arm (aarch64):

    https://yum.oracle.com/repo/OracleLinux/OL8/oracle/instantclient23/aarch64/index.html

    All installations require a Basic or Basic Light package. All other packages are optional.

  3. Install Oracle Instant Client packages using dnf.

    For Oracle Linux 8 and later:

    $ sudo dnf install oracle-instantclient-basic

  4. To install other Oracle Instant Client packages like SQL*Plus, run:

    For Oracle Linux 8 and later:

    $ sudo dnf install oracle-instantclient-sqlplus

Using versionlock to Avoid Upgrades

To ensure that you do not inadvertently upgrade Oracle Instant Client when a new major release is published, use dnf versionlock after you have installed Oracle Instant Client 23ai. 

$ sudo dnf install yum-plugin-versionlock

For Oracle Linux 8:

$ sudo dnf versionlock oracle-instantclient-release-23ai-el8

For Oracle Linux 9:

$ sudo dnf versionlock oracle-instantclient-release-23ai-el9

Note:

Configuring dnf versionlock still allows automatic Oracle Instant Client release updates.

Manually Downloading and Installing Oracle Instant Client RPM Packages

An alternative method for installing Oracle Instant Client is to manually download and install the Oracle Instant Client packages.

  1. Go to the Oracle Instant Client Downloads page:

    https://www.oracle.com/database/technologies/instant-client/downloads.html

  2. Download the desired Oracle Instant Client RPM packages. Select the correct platform, architecture, and packages of your choice. For example, if your application is 64-bit, then ensure that you select 64-bit Instant Client and download the Basic Package RPM file.

    All installations require a Basic or Basic Light package. All other packages are optional.

  3. Install the packages using dnf. For example:

    For Oracle Linux 8 on Linux x86-64: 

    $ sudo dnf install oracle-instantclient-basic-23.4.0.24.05-1.el8.x86_64.rpm

    For Oracle Linux 9 on Linux x86-64: 

    $ sudo dnf install oracle-instantclient-basic-23.4.0.24.05-1.el9.x86_64.rpm

    For Oracle Linux 8 on Linux for Arm (aarch64): 

    $ sudo dnf install oracle-instantclient-basic-23.7.0.25.01-1.el8.aarch64.rpm

Additionally, you may have to perform the following tasks before you start your application:

  • If you intend to colocate optional Oracle configuration files such as tnsnames.ora, sqlnet.ora, ldap.ora, or oraaccess.xml with Oracle Instant Client, then move these files to the /usr/lib/oracle/23/client64/lib/network/admin subdirectory.

    This is the default Oracle configuration directory for applications linked with this Oracle Instant Client.

    Alternatively, you can move the Oracle configuration files to another, accessible directory. Then set the environment variable TNS_ADMIN to that directory name.

  • To use binaries from the tools package, use yum or dnf to install the package and then update your PATH environment variable. For example: 

    $ export PATH=/usr/lib/oracle/23/client64/bin:$PATH

Parent topic: Installing Oracle Instant Client Packages