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

1 files changed, 18 insertions, 1 deletions

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