X-Git-Url: https://git.rkrishnan.org/?a=blobdiff_plain;f=docs%2Fquickstart.rst;h=d7161123b079d98c6b9a6cd18d6ad09cbd5ff1a5;hb=befa4babea7f92609654207c164b6d07f3baf92b;hp=236979b27fb084d8326eb1a94e2480f41d1ea026;hpb=f51f31999896d31583de26d5662745a195684a43;p=tahoe-lafs%2Ftahoe-lafs.git diff --git a/docs/quickstart.rst b/docs/quickstart.rst index 236979b2..d7161123 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -1,4 +1,5 @@ - +.. -*- coding: utf-8-with-signature-unix; fill-column: 77 -*- + ================== Getting Tahoe-LAFS ================== @@ -14,8 +15,7 @@ How To Get Tahoe-LAFS ===================== This procedure has been verified to work on Windows, Mac, OpenSolaris, and -too many flavors of Linux and of BSD to list. It's likely to work on other -platforms. +too many flavors of Linux and of BSD to list. In Case Of Trouble ------------------ @@ -31,28 +31,29 @@ Install Python -------------- Check if you already have an adequate version of Python installed by running -``python -V``. Python v2.6 (v2.6.6 or greater recommended) or Python v2.7 will -work. Python v3 does not work. On Windows, we recommend the use of native -Python v2.7, not Cygwin Python. If you don't have one of these versions of -Python installed, download and install `Python v2.7`_. Make sure that the path -to the installation directory has no spaces in it (e.g. on Windows, do not -install Python in the "Program Files" directory). +``python -V``. Python v2.6 (v2.6.6 or greater recommended) or Python v2.7 +will work. Python v3 does not work. On Windows, we recommend the use of +native Python v2.7, not Cygwin Python. If you don't have one of these +versions of Python installed, `download`_ and install the latest version of +Python v2.7. Make sure that the path to the installation directory has no +spaces in it (e.g. on Windows, do not install Python in the "Program Files" +directory). -.. _Python v2.7: http://www.python.org/download/releases/2.7.2/ +.. _download: https://www.python.org/downloads/ Get Tahoe-LAFS -------------- -Download the latest stable release, `Tahoe-LAFS v1.9.2`_. +Download the latest stable release, `Tahoe-LAFS v1.10.2`_. -.. _Tahoe-LAFS v1.9.2: https://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.9.2.zip +.. _Tahoe-LAFS v1.10.2: https://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.10.2.zip Set Up Tahoe-LAFS ----------------- Unpack the zip file and cd into the top-level directory. -Run ``python setup.py build`` to generate the ``tahoe`` executable in a +Run "``python setup.py build``" to generate the ``tahoe`` executable in a subdirectory of the current directory named ``bin``. This will download and build anything you need from various websites. @@ -60,12 +61,17 @@ On Windows, the ``build`` step might tell you to open a new Command Prompt (or, on XP and earlier, to log out and back in again). This is needed the first time you set up Tahoe-LAFS on a particular installation of Windows. -Run ``bin/tahoe --version`` (on Windows, ``bin\tahoe --version``) to verify -that the executable tool prints out the right version number after +If you see an error like ``fatal error: Python.h: No such file or directory`` +while compiling the dependencies, you need the Python development headers. If +you are on a Debian or Ubuntu system, you can install them with ``sudo +apt-get install python-dev``. On RedHat/Fedora, install ``python-devel``. + +Run "``bin/tahoe --version``" (on Windows, "``bin\tahoe --version``") to +verify that the executable tool prints out the right version number after "``allmydata-tahoe:``". -Optionally run ``python setup.py trial`` to verify that it passes all of its -self-tests. +Optionally run "``python setup.py trial``" to verify that it passes all of +its self-tests. Run Tahoe-LAFS --------------