From b25f7ec4a3488d9a876b3bf087bbfcb9decc0b28 Mon Sep 17 00:00:00 2001 From: Sergei Trofimov Date: Fri, 26 Jun 2015 10:23:39 +0100 Subject: [PATCH] Updated installation docs with warning about potential permission issues. --- doc/source/installation.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index 2aa5cfe5..62c5f596 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -76,6 +76,23 @@ similar distributions, this may be done with APT:: sudo apt-get install python-pip +.. note:: Some versions of pip (in particluar v1.5.4 which comes with Ubuntu + 14.04) are know to set the wrong permissions when installing + packages, resulting in WA failing to import them. To avoid this it + is recommended that you update pip and setuptools before proceeding + with installation:: + + sudo pip install --upgrade pip + sudo pip install --upgrade setuptools + + If you do run into this issue after already installing some packages, + you can resolve it by running :: + + sudo chmod -R a+r /usr/local/lib/python2.7/dist-packagessudo + find /usr/local/lib/python2.7/dist-packages -type d -exec chmod a+x {} \; + + (The paths above will work for Ubuntu; they may need to be adjusted + for other distros). Python Packages ---------------