From c761d1361e513cbeb3251dc3d3205e89c9aa6c18 Mon Sep 17 00:00:00 2001 From: Anthony Tuininga Date: Fri, 11 Aug 2017 16:57:14 -0600 Subject: [PATCH] Documentation tweaks. --- doc/src/installation.rst | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/doc/src/installation.rst b/doc/src/installation.rst index 71871462..4c7823d3 100644 --- a/doc/src/installation.rst +++ b/doc/src/installation.rst @@ -38,6 +38,8 @@ If you are upgrading from cx_Oracle 5 note these installation changes: You must set ``LD_LIBRARY_PATH`` or use ``ldconfig`` to locate the Oracle client library. + - PyPI no longer allows Windows installers or Linux RPMs to be + hosted. Use the supplied cx_Oracle Wheels instead. Install Using Pip ================= @@ -111,11 +113,20 @@ index.html>`__. Only the "Basic" or "Basic Light" package is required. Oracle Client libraries are also available in any Oracle Database installation or full Oracle Client installation. +Make sure your library loading path, such as ``PATH`` on Windows, or +``LD_LIBRARY_PATH`` on Linux, is set to the location of the Oracle +Client libraries. On macOS the libraries should be in ``~/lib`` or +``/usr/local/lib``. + On Windows, `Microsoft Windows Redistributables `__ matching the version of the Oracle client libraries need to be installed. +See `ODPI-C installation instructions +`__ for details +on configuration. + Oracle Database =============== @@ -186,8 +197,8 @@ If importing cx_Oracle fails: have restarted your command prompt if you have modified environment variables. - Check the ``LD_LIBRARY_PATH`` environment variable on Linux. - - On macOS, make sure Oracle Instant Client is in `~/lib` or - `/usr/local/lib` and that you are not using the bundled Python (use + - On macOS, make sure 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