Skip to content

Commit 49bc108

Browse files
Tweak troubleshooting section to make it easier to read and also mention that
restarting the command prompt is necessary on Windows when environment variables have been changed.
1 parent b30e66f commit 49bc108

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

doc/src/installation.rst

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -180,15 +180,21 @@ If installation fails:
180180
If importing cx_Oracle fails:
181181

182182
- Do you get the error "``DPI-1047: Oracle Client library cannot be
183-
loaded``"? Check the ``PATH`` environment variable on Windows or the
184-
``LD_LIBRARY_PATH`` environment variable on Linux. On macOS, make sure
185-
Oracle Instant Client is in `~/lib` or `/usr/local/lib` and that you are
186-
not using the bundled Python (use `Homebrew <https://brew.sh>`__ or
187-
`Python.org <https://www.python.org/downloads>`__ instead). Check that
188-
Python, cx_Oracle and your Oracle Client libraries are all 64-bit or all
189-
32-bit. Check that the correct `Windows Redistributables
190-
<https://oracle.github.io/odpi/doc/installation.html#windows>`__ have been
191-
installed.
183+
loaded``"?
184+
185+
- Check the ``PATH`` environment variable on Windows. Ensure that you
186+
have restarted your command prompt if you have modified environment
187+
variables.
188+
- Check the ``LD_LIBRARY_PATH`` environment variable on Linux.
189+
- On macOS, make sure Oracle Instant Client is in `~/lib` or
190+
`/usr/local/lib` and that you are not using the bundled Python (use
191+
`Homebrew <https://brew.sh>`__ or `Python.org
192+
<https://www.python.org/downloads>`__ instead).
193+
- Check that Python, cx_Oracle and your Oracle Client libraries are all
194+
64-bit or all 32-bit.
195+
- on Windows, check that the correct `Windows Redistributables
196+
<https://oracle.github.io/odpi/doc/installation.html#windows>`__ have
197+
been installed.
192198

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

0 commit comments

Comments
 (0)