Skip to content

Commit

Permalink
Tweak troubleshooting section to make it easier to read and also ment…
Browse files Browse the repository at this point in the history
…ion that

restarting the command prompt is necessary on Windows when environment
variables have been changed.
  • Loading branch information
anthony-tuininga committed Aug 11, 2017
1 parent b30e66f commit 49bc108
Showing 1 changed file with 15 additions and 9 deletions.
24 changes: 15 additions & 9 deletions doc/src/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -180,15 +180,21 @@ If installation fails:
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` 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
installed.
loaded``"?

- Check the ``PATH`` environment variable on Windows. Ensure that you
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
`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.
- on Windows, check that the correct `Windows Redistributables
<https://oracle.github.io/odpi/doc/installation.html#windows>`__ have
been installed.

- If you have both Python 2 and 3 installed, make sure you are
using the correct python and pip (or python3 and pip3)
Expand Down

0 comments on commit 49bc108

Please sign in to comment.