2011-05-10 19:16:50 +00:00
|
|
|
==================
|
|
|
|
|
Getting Tahoe-LAFS
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
Welcome to `the Tahoe-LAFS project <http://tahoe-lafs.org>`_, a secure,
|
|
|
|
|
decentralized, fault-tolerant storage system. `About Tahoe-LAFS
|
|
|
|
|
<about.rst>`_.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
In Case Of Trouble
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
There are a few 3rd party libraries that Tahoe-LAFS depends on that
|
|
|
|
|
might not be easy to set up on your platform. If the following
|
|
|
|
|
instructions don't Just Work without any further effort on your part,
|
|
|
|
|
then please write to `the tahoe-dev mailing list
|
|
|
|
|
<http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev>`_ where
|
|
|
|
|
friendly hackers will help you out. You might also find clues in the
|
|
|
|
|
`Advanced Installation`_ section described below.
|
|
|
|
|
|
|
|
|
|
Install Python
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
Check if you already have an adequate version of Python installed by
|
|
|
|
|
running ``python -V``. Python v2.4 (v2.4.4 or greater), Python v2.5,
|
|
|
|
|
Python v2.6, or Python v2.7 will work. Python v3 does not work. On
|
|
|
|
|
Windows, we recommend the use of Python v2.6 (native, not Cygwin). If
|
|
|
|
|
you don't have one of these versions of Python installed, then follow
|
|
|
|
|
the instructions on `the Python download page
|
|
|
|
|
<http://www.python.org/download/releases/2.6.6/>`_ to download and
|
|
|
|
|
install Python v2.6. 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).
|
|
|
|
|
|
|
|
|
|
Get Tahoe-LAFS
|
|
|
|
|
--------------
|
|
|
|
|
|
2011-06-10 12:16:56 +00:00
|
|
|
`Download the latest stable release, v1.8.2
|
|
|
|
|
<http://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.8.2.zip>`_
|
2011-05-10 19:16:50 +00:00
|
|
|
|
|
|
|
|
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
|
|
|
|
|
subdirectory of the current directory named ``bin``. This will download
|
|
|
|
|
and build anything you need from various websites.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
Optionally run ``python setup.py test`` to verify that it passes all
|
|
|
|
|
of its self-tests.
|
|
|
|
|
|
|
|
|
|
Run ``bin/tahoe --version`` (on Windows, ``bin\tahoe --version``) to
|
|
|
|
|
verify that the executable tool prints out the right version number.
|
|
|
|
|
|
|
|
|
|
Run Tahoe-LAFS
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
Now you are ready to deploy a decentralized filesystem. The ``tahoe``
|
|
|
|
|
executable in the ``bin`` directory can configure and launch your
|
|
|
|
|
Tahoe-LAFS nodes. See `running.rst <running.rst>`_ for instructions on
|
|
|
|
|
how to do that.
|
|
|
|
|
|
|
|
|
|
Advanced Installation
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
For optional features such as tighter integration with your operating
|
|
|
|
|
system's package manager, you can see the `AdvancedInstall
|
|
|
|
|
<http://tahoe-lafs.org/trac/tahoe/wiki/AdvancedInstall>`_ wiki page.
|
|
|
|
|
The options on that page are not necessary to use Tahoe-LAFS and can be
|
|
|
|
|
complicated, so we do not recommend following that page unless you have
|
|
|
|
|
unusual requirements for advanced optional features. For most people,
|
|
|
|
|
you should first follow the instructions on this page, and if that
|
|
|
|
|
doesn't work then ask for help by writing to `the tahoe-dev mailing
|
|
|
|
|
list <http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev>`_.
|
|
|
|
|
|
