aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/python/grpcio/README.rst
diff options
context:
space:
mode:
authorGravatar Sree Kuchibhotla <sreek@google.com>2016-03-17 15:13:08 -0700
committerGravatar Sree Kuchibhotla <sreek@google.com>2016-03-17 18:36:31 -0700
commitffa38f9671dacdfbcca8f874048c390fb27a2e64 (patch)
treee689f21e4e5d77550649063f4fe8091be9a6a96b /src/python/grpcio/README.rst
parent2f084ee39e1894e6d625452c444f6ea25f591176 (diff)
Add troubleshooting details
Diffstat (limited to 'src/python/grpcio/README.rst')
-rw-r--r--src/python/grpcio/README.rst35
1 files changed, 34 insertions, 1 deletions
diff --git a/src/python/grpcio/README.rst b/src/python/grpcio/README.rst
index 3f4c6fad02..0bb3e0dea1 100644
--- a/src/python/grpcio/README.rst
+++ b/src/python/grpcio/README.rst
@@ -50,10 +50,43 @@ Troubleshooting
Help, I ...
* **... see a** :code:`pkg_resources.VersionConflict` **when I try to install
- grpc!**
+ grpc:**
This is likely because :code:`pip` doesn't own the offending dependency,
which in turn is likely because your operating system's package manager owns
it. You'll need to force the installation of the dependency:
:code:`pip install --ignore-installed $OFFENDING_DEPENDENCY`
+
+ For example, if you get an error like the following:
+
+ ::
+
+ Traceback (most recent call last):
+ File "<string>", line 17, in <module>
+ ...
+ File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 509, in find
+ raise VersionConflict(dist, req)
+ pkg_resources.VersionConflict: (six 1.8.0 (/usr/lib/python2.7/dist-packages), Requirement.parse('six>=1.10'))
+
+ You can fix it by doing:
+
+ ::
+
+ sudo pip install --ignore-installed six
+
+* **see the following error on some platforms**
+
+ ::
+
+ /tmp/pip-build-U8pSsr/cython/Cython/Plex/Scanners.c:4:20: fatal error: Python.h: No such file or directory
+ #include "Python.h"
+ ^
+ compilation terminated.
+
+ You can fix it by installing `python-dev` package. i.e
+
+ ::
+
+ sudo apt-get install python-dev
+