Installing Oracle Instant Client Packages on Linux for ARM (aarch64)

Learn the different methods to install Oracle Instant Client on Linux for ARM (aarch64).

Installing Oracle Instant Client Using Zip Files on Linux for ARM (aarch64)

Learn how to download and use zip files to install Oracle Instant Client on Linux for ARM (aarch64).

  1. Go to the Oracle Instant Client Downloads page for Linux for ARM (aarch64):
  2. Download the desired Oracle Instant Client zip files. Select the correct platform, architecture, and packages of your choice. For example, if your application is aarch64, then ensure that you select aarch64 Instant Client and download the Basic Package zip file.

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

  3. Unzip each zip file into a single directory such as /opt/oracle/instantclient_19_19 or /opt/oracle/instantclient_19_10 that is accessible to your application. For example, for Linux for ARM (aarch64):

    For Oracle Linux 8

    $ cd /opt/oracle      
    $ unzip instantclient-basic-linux.arm64-19.19.0.0.0dbru.zip

    For Oracle Linux 7

    $ cd /opt/oracle      
    $ unzip instantclient-basic-linux.arm64-19.10.0.0.0dbru.zip
    The various packages unzip into /opt/oracle/instantclient_19_19 or /opt/oracle/instantclient_19_10.
  4. Install the operating system libaio package. This is available as libaio1 on some Linux distributions. For example, on Oracle Linux run:
    $ sudo yum install libaio
  5. If Oracle Instant Client is the only Oracle software installed on your system, then update the runtime link path, for example:

    For Oracle Linux 8

    $ sudo sh -c "echo /opt/oracle/instantclient_19_19 > \
          /etc/ld.so.conf.d/oracle-instantclient.conf"
      $ sudo ldconfig

    For Oracle Linux 7

    $ sudo sh -c "echo /opt/oracle/instantclient_19_10 > \
          /etc/ld.so.conf.d/oracle-instantclient.conf"
      $ sudo ldconfig

    Alternatively, set the LD_LIBRARY_PATH environment variable prior to running applications. For example:

    For Oracle Linux 8

    $ export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_19:$LD_LIBRARY_PATH

    For Oracle Linux 7

    $ export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_10:$LD_LIBRARY_PATH

    Optionally, add the variable to configuration files such as ~/.bash_profile and to application configuration files such as /etc/sysconfig/httpd.

  6. 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 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.
  7. To use binaries such as sqlplus from the SQL*Plus package or any other Oracle Instant client package, unzip the package to the same directory as the Basic package and then update your PATH environment variable. For example:

    For Oracle Linux 8

    $ export PATH=/opt/oracle/instantclient_19_19:$PATH

    For Oracle Linux 7

    $ export PATH=/opt/oracle/instantclient_19_10:$PATH
  8. Start your application.

Installing Oracle Instant Client Using RPMs on Linux for ARM (aarch64)

Learn how to use the yum install command to install Oracle Instant Client on Linux for ARM (aarch64).

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.

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. Install the Oracle Linux release package to configure repository definitions for Oracle Instant Client:

    For Oracle Linux 7:

    $ sudo yum install oracle-release-el7

    For Oracle Linux 8:

    $ sudo dnf install oracle-release-el8
  2. Go to the Oracle Instant Client repositories to view available Oracle Instant Client packages for Linux for ARM (aarch64):

    For Oracle Linux 7:

    https://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/aarch64/index.html

    For Oracle Linux 8:

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

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

  3. Install Oracle Instant Client packages using yum.

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient19.10-basic

    For Oracle Linux 8:

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

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient19.10-sqlplus

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient19.19-sqlplus

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 for Linux for ARM (aarch64) page:

    https://www.oracle.com/database/technologies/instant-client/linux-arm-aarch64-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 aarch64, then ensure that you select aarch64 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 yum.

    For Oracle Linux 7:

    $ sudo yum install oracle-instantclient19.10-basic-19.10.0.0.0-1.aarch64.rpm

    For Oracle Linux 8:

    $ sudo dnf install oracle-instantclient19.19-basic-19.19.0.0.0-1.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/19.10/client64/lib/network/admin or /usr/lib/oracle/19.19/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 or any other Oracle Instant client package, use yum to install the package and then update your PATH environment variable. For example:

    For Oracle Linux 7

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

    For Oracle Linux 8

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