From f8b175bfb79451578fdc8d831bb01833749ce38b Mon Sep 17 00:00:00 2001 From: Anthony LaTorre Date: Fri, 10 Nov 2017 10:33:39 -0600 Subject: update installation instructions - use chroma.bitbucket.io/chroma_pkgs to install chroma dependencies - add some instructions on how to symlink the python shared library in virtual environments created with newer versions of virtualenv --- doc/source/install/overview.rst | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/doc/source/install/overview.rst b/doc/source/install/overview.rst index 67bdfd2..dd133a2 100644 --- a/doc/source/install/overview.rst +++ b/doc/source/install/overview.rst @@ -67,6 +67,23 @@ create a self-contained virtualenv:: You only need to delete the chroma_env directory to completely remove Chroma from your system. +On some newer versions of virtualenv, the python shared library is not installed +in the virtual environment. To see if the python shared library is installed, +check to see if there is a libpython*.so file in +$VIRTUAL_ENV/lib/pythonX.X/config:: + + ls $VIRTUAL_ENV/lib/pythonX.X/config/ + libpython2.7.so + +If you don't see a shared library there, or the directory config does not exist, +you can manually symlink the shared library:: + + mkdir $VIRTUAL_ENV/lib/pythonX.X/config + cd $VIRTUAL_ENV/lib/pythonX.X/config + ln -s [path to shared library] . + +where [path to shared library] is usually something like +/usr/lib/libpythonX.X.so. Step 2: Install Chroma Dependencies ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -79,7 +96,7 @@ libraries into the virtualenv, isolating them from the rest of your system:: # Create configuration file for PyCUDA echo -e "import os\nvirtual_env = os.environ['VIRTUAL_ENV']\nBOOST_INC_DIR = [os.path.join(virtual_env, 'include')]\nBOOST_LIB_DIR = [os.path.join(virtual_env, 'lib')]\nBOOST_PYTHON_LIBNAME = ['boost_python']" > ~/.aksetup-defaults.py # Search this site for shrinkwrap packages used by Chroma - export PIP_EXTRA_INDEX_URL=http://mtrr.org/chroma_pkgs/ + export PIP_EXTRA_INDEX_URL=https://chroma.bitbucket.io/chroma_pkgs/ # On RHEL/Centos/Scientific Linux ONLY, uncomment and run the following commands # pip install -U numpy -- cgit