Installing Oracle Instant Client Using RPMs

Learn how to install Oracle Instant Client by downloading the RPMs and using the yum 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 yum before you start a fresh installation.

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

    For Oracle Linux 7:

    $ sudo yum list installed | grep instantclient

    For Oracle Linux 8:

    $ 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 7:

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

    For Oracle Linux 8:

    $ 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 7:

    $ sudo yum remove oracle-release-el7

    For Oracle Linux 8:

    $ sudo dnf remove oracle-release-el8
  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 yum install command.

  1. Go to the Oracle Instant Client repositories, to find the Oracle Linux release packages:

    For Oracle Linux 7:

    https://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient21/x86_64/index.html

    For Oracle Linux 8:

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

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

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient-release-el7

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient-release-el8
  3. Install Oracle Instant Client packages using yum.

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient-basic

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient-basic
  4. To install other Oracle Instant Client packages like SQL *Plus, run:

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient-sqlplus

    For Oracle Linux 8:

    $ 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 yum versionlock after you have installed Oracle Instant Client 21c.

$ sudo yum install yum-plugin-versionlock

For Oracle Linux 7:

$ sudo yum versionlock oracle-instantclient-release-el7

For Oracle Linux 8:

$ sudo dnf versionlock oracle-instantclient-release-el8

Note:

Configuring yum versionlock still allows automatic Oracle Instant Client release updates to 21.2, 21.3, and so on.

Manually Downloading and Installing Oracle Instant Client RPM Packages

An alternative to installing Oracle Instant Client using the yum server is to manually download and install the Oracle Instant Client packages.

  1. Use any browser to access the Oracle Instant Client Downloads page:

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

  2. Download the desired Oracle Instant Client RPM package. 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.

  3. Install the packages using yum.

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient-basic

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient-basic

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/21/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/21/client64/bin:$PATH