summaryrefslogtreecommitdiff
path: root/doc/source/install/ubuntu.rst
diff options
context:
space:
mode:
authorStan Seibert <stan@mtrr.org>2013-03-12 17:30:10 -0400
committertlatorre <tlatorre@uchicago.edu>2021-05-09 08:42:39 -0700
commit9ac57378640ce87c7ea8e232885b4ca861245da2 (patch)
tree808f65f11915b098c706670ad12518377e844336 /doc/source/install/ubuntu.rst
parente1e5cb17df1125fcfc70a5519e3721f7e6aef8ef (diff)
downloadchroma-9ac57378640ce87c7ea8e232885b4ca861245da2.tar.gz
chroma-9ac57378640ce87c7ea8e232885b4ca861245da2.tar.bz2
chroma-9ac57378640ce87c7ea8e232885b4ca861245da2.zip
Documentation updates
Diffstat (limited to 'doc/source/install/ubuntu.rst')
-rw-r--r--doc/source/install/ubuntu.rst50
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/source/install/ubuntu.rst b/doc/source/install/ubuntu.rst
new file mode 100644
index 0000000..ffd7260
--- /dev/null
+++ b/doc/source/install/ubuntu.rst
@@ -0,0 +1,50 @@
+Ubuntu Installation
+===================
+
+Step 1: ``apt-get`` packages with Ubuntu package manager
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+We need to install several system packages::
+
+ sudo apt-get install python-pygame python-matplotlib python-virtualenv \
+ build-essential xorg-dev python-dev libglu1-mesa-dev freeglut3-dev \
+ uuid-dev liblapack-dev mercurial git subversion libatlas-base-dev \
+ libbz2-dev
+
+Step 2: CUDA Toolkit and Driver
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+CUDA requires the use of the official NVIDIA graphics driver, rather than the
+open source Nouveau driver that is included with Ubuntu. The NVIDIA driver
+can be installed by going to the `CUDA Downloads <https://developer.nvidia.com
+/cuda-downloads>`_ and downloading the package corresponding to your Ubuntu
+version. This single package includes a current NVIDIA driver, the CUDA
+compiler toolkit, and sample programs.
+
+.. note:: Although NVIDIA only lists support up to Ubuntu 11.10 in CUDA 5, we have found the package to also work with Ubuntu 12.04 LTS.
+
+To install the NVIDIA drivers, you will need to switch to a text console (Ctrl-Alt-F1) and shut down the X server::
+
+ # This next will kill everything running on your graphical desktop!
+
+ # On Ubuntu 12.04: sudo service lightdm stop
+ sudo service gdm stop
+
+ chmod +x cuda_5.0.35_linux_64_ubuntu11.10-1.run
+ sudo ./cuda_5.0.35_linux_64_ubuntu11.10-1.run
+ # Accept the license and pick the defaults
+
+ # On Ubuntu 12.04: sudo service lightdm start
+ sudo service gdm start
+
+Once installed, you can ensure the CUDA compiler and libraries are in your path by adding the following lines to your bash login script (usually $HOME/.bashrc)::
+
+ export PATH=/usr/local/cuda/bin:$PATH
+ export LD_LIBRARY_PATH=/usr/local/cuda/lib64/:$LD_LIBRARY_PATH
+
+.. warning:: Non-bash shells will need to be adjusted appropriately. If you are using a 32-bit distribution, then lib64/ should be changed to lib/.
+
+Step 3: Continue to Common Installation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The rest of the installation process is described in :ref:`common-install`. \ No newline at end of file