From 5e9f226826075bbc889b03c7ca5afcbfa73c53f5 Mon Sep 17 00:00:00 2001 From: Zooko O'Whielacronx Date: Tue, 1 Jan 2008 17:20:07 -0700 Subject: [PATCH] docs: update install.html and update and format running.html --- docs/install.html | 14 +++++------ docs/running.html | 63 ++++++++++++++++++----------------------------- 2 files changed, 31 insertions(+), 46 deletions(-) diff --git a/docs/install.html b/docs/install.html index 85b322ff..3dc195a6 100644 --- a/docs/install.html +++ b/docs/install.html @@ -1,19 +1,19 @@ - installing Tahoe + Installing Tahoe - + -

INSTALLING TAHOE

+

How To Install Tahoe

This is the default procedure to install from source. It has been verified to work on Windows, Cygwin, Mac, Linux, and Solaris. It's likely to work on other platforms. For more details and for alternative installation procedures, please see install-details.html. -

DEPENDENCIES

+

Satisfy the Dependencies

Prior to installing Tahoe the following must be installed: @@ -38,13 +38,13 @@ -

GET THE SOURCE CODE

+

Get the Source Code

Tarballs of the source code are available at:

http://allmydata.org/source/tahoe/

-

INSTALL

+

Install

Unpack the tarball and cd into the top-level directory.

@@ -56,7 +56,7 @@

Run bin/tahoe --version to verify that the executable tool runs and prints out the right version number (the "allmydata" version number is the version number of the Tahoe package).

-

RUN

+

Run

Now you have the Tahoe source code installed and are ready to use it to form a decentralized filesystem. See running.html for instructions.

diff --git a/docs/running.html b/docs/running.html index 5bcec006..c55ecd56 100644 --- a/docs/running.html +++ b/docs/running.html @@ -1,40 +1,25 @@ -This is how to run a Tahoe node or a complete Tahoe grid. First you -have to install the Tahoe source code, as documented -in install.html. - - -RUNNING: - -The
tahoe
executable is used to create, start, and stop -nodes. Each node lives in a separate base directory, inside of which -you can add files to configure the node. Nodes also read and write -files within that directory. - -A grid consists of a single Introducer and one or more nodes. If you -are creating a new grid, you'll need to create both an Introducer and -a node (and then invite other people to create their own nodes and -join your grid). If you are joining an existing grid (such -as the public test grid), the Introducer will -already be running, and you'll need to create a node. - -To construct an introducer, create a new empty base directory for it -(the name of the directory is up to you) and cd into that directory. -Now run
tahoe create-introducer
. Now start the introducer -by running
tahoe start
. After it starts, there will be a -file named
introducer.furl
in that base directory. This -file contains the URL which the nodes must use in order to connect to -this introducer. - -To construct a node, create a new empty base directory (the name of -the directory is up to you) and cd into that directory. Now -run
tahoe create-client
. Acquire a copy of -the
introducer.furl
from the introducer and put it into -this directory, then run
tahoe start
. After that, the node -should be off and running. The first thing it will do is connect to -the introducer and get itself connected to all other nodes on the -grid. - -Point your web browser -to http://127.0.0.1:8123 to use -this node. + + + + Running Tahoe + + + + + + + +

How To Run Tahoe

+ +

This is how to run a Tahoe node or a complete Tahoe grid. First you have to install the Tahoe source code, as documented in install.html.

+ +

The tahoe executable is used to create, start, and stop nodes. Each node lives in a separate base directory, inside of which you can add files to configure the node. Nodes also read and write files within that directory.

+ +

A grid consists of a single Introducer and one or more nodes. If you are creating a new grid, you'll need to create both an Introducer and a node (and then invite other people to create their own nodes and join your grid). If you are joining an existing grid (such as the public test grid), the Introducer will already be running, and you'll need to create a node.

+ +

To construct an introducer, create a new empty base directory for it (the name of the directory is up to you) and cd into that directory. Now run tahoe create-introducer. Now start the introducer by running tahoe start. After it starts, there will be a file named introducer.furl in that base directory. This file contains the URL which the nodes must use in order to connect to this introducer.

+ +

To construct a node, create a new empty base directory (the name of the directory is up to you) and cd into that directory. Now run tahoe create-client. Acquire a copy of the introducer.furl from the introducer and put it into this directory, then run tahoe start. After that, the node should be off and running. The first thing it will do is connect to the introducer and get itself connected to all other nodes on the grid.

+ +

Point your web browser to http://127.0.0.1:8123 to use this node.

-- 2.45.2