diff --git a/doc/src/installation.rst b/doc/src/installation.rst index 8f58fa86..42af46e7 100644 --- a/doc/src/installation.rst +++ b/doc/src/installation.rst @@ -12,8 +12,8 @@ Before cx_Oracle can be installed, an installation of Python 3.4 and higher are supported. The simplest method of installation is to `Install Using Pip`_. You can also -`Install Using GitHub`_. If you run into trouble, check out the section on -`Troubleshooting`_. +`Install Using GitHub`_ or `Install Using RPM`_. If you run into trouble, check +out the section on `Troubleshooting`_. After cx_Oracle has been installed, you must also `Install Oracle Client`_, if that has not been done already. Oracle Client versions 12.2, 12.1 and 11.2 @@ -47,6 +47,21 @@ In order to install using the source on GitHub, use the following commands:: python setup.py install +Install Using RPM +================= + +The RPMs that are provided on `PyPI `_ +were created on Oracle Linux 6 (Python 2.6) and Oracle Linux 7 (Python 2.7 and +3.5). They should work on Red Hat Enterprise Linux or CentOS as well but on +other Linux platforms using RPMs (such as Fedora) the paths are different and +you will need to adjust them after installation. The following command will +install the RPM that you have downloaded:: + + rpm -Uvh + +where refers to the RPM that you downloaded. + + Install Oracle Client ===================== @@ -137,7 +152,9 @@ If importing cx_Oracle fails: - Do you get the error "``DPI-1047: Oracle Client library cannot be loaded``"? Check the ``PATH`` environment variable on Windows or the ``LD_LIBRARY_PATH`` environment variable on Linux. On macOS, make sure - Oracle Instant Client is in `~/lib` or `/usr/local/lib`. Check that + Oracle Instant Client is in `~/lib` or `/usr/local/lib` and that you are + not using the bundled Python (use `Homebrew `__ or + `Python.org `__ instead). Check that Python, cx_Oracle and your Oracle Client libraries are all 64-bit or all 32-bit. Check that the correct `Windows Redistributables `__ have been