2014-09-25 16:47:19 +00:00
|
|
|
.. -*- coding: utf-8-with-signature-unix; fill-column: 77 -*-
|
2013-11-08 20:31:08 +00:00
|
|
|
|
2011-05-10 19:16:50 +00:00
|
|
|
==================
|
|
|
|
|
Getting Tahoe-LAFS
|
|
|
|
|
==================
|
|
|
|
|
|
2012-04-01 01:57:17 +00:00
|
|
|
Welcome to `the Tahoe-LAFS project`_, a secure, decentralized, fault-tolerant
|
|
|
|
|
storage system.
|
|
|
|
|
|
|
|
|
|
`about Tahoe-LAFS <about.rst>`__
|
|
|
|
|
|
|
|
|
|
.. _the Tahoe-LAFS project: https://tahoe-lafs.org
|
2011-05-10 19:16:50 +00:00
|
|
|
|
|
|
|
|
How To Get Tahoe-LAFS
|
|
|
|
|
=====================
|
|
|
|
|
|
2012-04-01 01:57:17 +00:00
|
|
|
This procedure has been verified to work on Windows, Mac, OpenSolaris, and
|
2014-09-25 17:16:23 +00:00
|
|
|
too many flavors of Linux and of BSD to list.
|
2011-05-10 19:16:50 +00:00
|
|
|
|
|
|
|
|
In Case Of Trouble
|
|
|
|
|
------------------
|
|
|
|
|
|
2012-04-01 01:57:17 +00:00
|
|
|
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`_ where friendly hackers will help you out.
|
|
|
|
|
|
|
|
|
|
.. _the tahoe-dev mailing list: https://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev
|
2011-05-10 19:16:50 +00:00
|
|
|
|
|
|
|
|
Install Python
|
|
|
|
|
--------------
|
|
|
|
|
|
2012-04-01 01:57:17 +00:00
|
|
|
Check if you already have an adequate version of Python installed by running
|
2016-01-28 21:13:44 +00:00
|
|
|
``python -V``. The latest version of Python v2.7 is recommended. Python
|
|
|
|
|
v2.6.x and v3 do 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).
|
2012-04-01 01:57:17 +00:00
|
|
|
|
2014-09-25 17:16:23 +00:00
|
|
|
.. _download: https://www.python.org/downloads/
|
2011-05-10 19:16:50 +00:00
|
|
|
|
|
|
|
|
Get Tahoe-LAFS
|
|
|
|
|
--------------
|
|
|
|
|
|
2015-07-31 02:35:00 +00:00
|
|
|
Download the latest stable release, `Tahoe-LAFS v1.10.2`_.
|
2012-04-01 01:57:17 +00:00
|
|
|
|
2015-07-31 02:35:00 +00:00
|
|
|
.. _Tahoe-LAFS v1.10.2: https://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.10.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.
|
|
|
|
|
|
2013-10-05 17:55:01 +00:00
|
|
|
Run "``python setup.py build``" to generate the ``tahoe`` executable in a
|
2012-04-01 01:57:17 +00:00
|
|
|
subdirectory of the current directory named ``bin``. This will download and
|
|
|
|
|
build anything you need from various websites.
|
2011-05-10 19:16:50 +00:00
|
|
|
|
2012-04-01 01:57:17 +00:00
|
|
|
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.
|
2011-05-10 19:16:50 +00:00
|
|
|
|
2015-06-15 04:21:22 +00:00
|
|
|
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``.
|
|
|
|
|
|
2014-09-25 16:47:19 +00:00
|
|
|
Run "``bin/tahoe --version``" (on Windows, "``bin\tahoe --version``") to
|
|
|
|
|
verify that the executable tool prints out the right version number after
|
2012-06-01 21:01:04 +00:00
|
|
|
"``allmydata-tahoe:``".
|
2011-05-10 19:16:50 +00:00
|
|
|
|
2014-09-25 16:47:19 +00:00
|
|
|
Optionally run "``python setup.py trial``" to verify that it passes all of
|
|
|
|
|
its self-tests.
|
2012-09-14 02:10:12 +00:00
|
|
|
|
2011-05-10 19:16:50 +00:00
|
|
|
Run Tahoe-LAFS
|
|
|
|
|
--------------
|
|
|
|
|
|
2011-10-30 17:44:11 +00:00
|
|
|
Now you are ready to deploy a decentralized filesystem. The ``tahoe``
|
2012-04-01 01:57:17 +00:00
|
|
|
executable in the ``bin`` directory can configure and launch your Tahoe-LAFS
|
|
|
|
|
nodes. See `<running.rst>`__ for instructions on how to do that.
|
