From: Zooko O'Whielacronx Date: Wed, 21 Apr 2010 15:57:57 +0000 (-0700) Subject: docs: install.html -> quickstart.html X-Git-Url: https://git.rkrishnan.org/specifications/%5B/%5D%20/flags/something?a=commitdiff_plain;h=a1fa80fc0c1948116f5e0e79ce3523eb583b4c94;p=tahoe-lafs%2Ftahoe-lafs.git docs: install.html -> quickstart.html It is not called "installing" because that implies that it is going to change the configuration of your operating system. It is not called "building" because that implies that you need developer tools like a compiler. Also I added a stern warning against looking at the "InstallDetails" wiki page, which I have renamed to "AdvancedInstall". --- diff --git a/docs/install.html b/docs/install.html deleted file mode 100644 index 2c3b734b..00000000 --- a/docs/install.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - Installing Tahoe-LAFS - - - - - - - -

About Tahoe-LAFS

-

Welcome to the Tahoe-LAFS project, a secure, decentralized, fault-tolerant filesystem. About Tahoe-LAFS. - -

How To Install Tahoe-LAFS

- -

This procedure works on Windows, Cygwin, Mac, many flavors of Linux (including Debian), Solaris, FreeBSD, OpenBSD, and NetBSD. It's likely to work on other platforms. If you have trouble with this install process, please write to the tahoe-dev mailing list, where friendly hackers will help you out.

- -

Install Python

- -

Check if you already have an adequate version of Python installed by running python -V. Python v2.4 (v2.4.2 or greater), Python v2.5 or Python v2.6 will work. Python v3 does not work. If you don't have one of these versions of Python installed, then follow the instructions on the Python download page to download and install Python v2.5.

-

(If installing on Windows, you now need to manually install the pywin32 package -- see "More Details" below.)

- -

Get Tahoe-LAFS

- -

Download the 1.6.1 release zip file:

- -
http://allmydata.org/source/tahoe-lafs/releases/allmydata-tahoe-1.6.1.zip
- -

Build Tahoe-LAFS

- -

Unpack the zip file and cd into the top-level directory.

- -

Run python setup.py build to install the tahoe executable into a subdirectory of the current directory named bin.

- -

(Optionally run python setup.py test to verify that it passes all of its self-tests.)

- -

Run bin/tahoe --version to verify that the executable tool prints out the right version number.

- -

Run Tahoe-LAFS

- -

Now you have the Tahoe-LAFS source code installed and are ready to use it to form a decentralized filesystem. The tahoe executable in the bin directory can configure and launch your Tahoe-LAFS nodes. See running.html for instructions on how to do that.

- - -

More Details

- -

For more details, including platform-specific hints for Debian, Windows, and Mac systems, please see the InstallDetails wiki page. If you are running on Windows, you need to manually install "pywin32", as described on that page.

- - - diff --git a/docs/quickstart.html b/docs/quickstart.html new file mode 100644 index 00000000..9a2c9086 --- /dev/null +++ b/docs/quickstart.html @@ -0,0 +1,50 @@ + + + + Getting Tahoe-LAFS + + + + + + + +

About Tahoe-LAFS

+

Welcome to the Tahoe-LAFS project, a secure, decentralized, fault-tolerant filesystem. About Tahoe-LAFS. + +

How To Get Tahoe-LAFS

+ +

This procedure has been verified to work on Windows, Cygwin, Mac, many flavors of Linux, Solaris, FreeBSD, OpenBSD, and NetBSD. It's likely to work on other platforms. If you have trouble getting Tahoe-LAFS running this way, please write to the tahoe-dev mailing list, where friendly hackers will help you out.

+ +

Install Python

+ +

Check if you already have an adequate version of Python installed by running python -V. Python v2.4 (v2.4.2 or greater), Python v2.5 or Python v2.6 will work. Python v3 does not work. If you don't have one of these versions of Python installed, then follow the instructions on the Python download page to download and install Python v2.5.

+

(If you are on Windows, you now must manually install the pywin32 package from the pywin32 site before getting Tahoe-LAFS.)

+ +

Get Tahoe-LAFS

+ +

Download the 1.6.1 release zip file:

+ +
http://allmydata.org/source/tahoe-lafs/releases/allmydata-tahoe-1.6.1.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 subdirectory of the current directory named bin.

+ +

Optionally run python setup.py test to verify that it passes all of its self-tests.

+ +

Run 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.html 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 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.

+ +