3.5.1.1 Install Oracle Instant Client for Linux for On-Premises Databases

Instructions for installing Oracle Instant Client for Linux for use with an on-premises Oracle database.

The OML4Py client requires Oracle Instant Client to connect to an Oracle database. See the Oracle Support Note "Client / Server Interoperability Support Matrix for Different Oracle Versions (Doc ID 207303.1)".

To install Oracle Instant Client, the following are required:

• A connection to the internet.
• Write permission on the directory in which you are installing the client.

To install Oracle Instant Client, do the following:

1. Download the Oracle Instant Client for your system. Go to the Oracle Instant Client Downloads page and select Instant Client for Linux x86-64.
2. Locate the section for your version of Oracle Database. These instructions use the 19.14.0.0.0 version.
3. In the Base section, in the Download column, click the zip file for the Basic Package or Basic Light Package and save the file in an accessible directory on your system. These instructions use the directory /opt/oracle.
4. Go to the folder that you selected and unzip the package. For example:

   cd /opt/oracle
   unzip instantclient-basic-linux.x64-19.14.0.0.0dbru.zip

   Extracting the package creates the subdirectory instantclient_19_14, which contains the Oracle Instant Client files.

5. The libaio package is also required. To see if libaoi resides on the system run the following command.

   $ rpm -qa libaio
   libaio-0.3.112-1.el8.i686
   libaio-0.3.112-1.el8.x86_64

   The version will vary based on the Linux version. If nothing is returned from this command, then the libaio RPM is not installed on the target system.

   To install the libaio package with sudo or as the root user, run the following command:

   sudo yum install libaio

   Note:

   In some Linux distributions, this package is called libaio1.
6. Add the directory that contains the Oracle Instant Client files to the beginning of your LD_LIBRARY_PATH environment variable:

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