dnrops
/
python-cx_Oracle
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve installation documentation.

This commit is contained in:
Anthony Tuininga 2017-07-24 10:36:33 -06:00
parent 22dc8c1daa
commit af01c81a1b
1 changed files with 20 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/src/installation.rst
View File

@ -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 <https://pypi.python.org/pypi/cx_Oracle>`_
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 <file_name>
where <file_name> 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 <https://brew.sh>`__ or
`Python.org <https://www.python.org/downloads>`__ 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
<https://oracle.github.io/odpi/doc/installation.html#windows>`__ have been