2008-01-02 00:20:07 +00:00
|
|
|
<!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
|
|
|
<html lang="en">
|
|
|
|
|
<head>
|
|
|
|
|
<title>Running Tahoe</title>
|
|
|
|
|
<link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
|
|
|
|
|
<meta name="description" content="how to run Tahoe">
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
2008-01-04 04:11:59 +00:00
|
|
|
<meta name="keywords" content="tahoe secure decentralized filesystem operation">
|
2008-01-02 00:20:07 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
2008-01-08 17:32:41 +00:00
|
|
|
<h1>How To Start Tahoe</h1>
|
2008-01-02 00:20:07 +00:00
|
|
|
|
2009-06-21 17:50:05 +00:00
|
|
|
<p>This is how to run a Tahoe client or a complete Tahoe grid. First you
|
|
|
|
|
have to install the Tahoe software, as documented in <a
|
2008-01-02 04:50:46 +00:00
|
|
|
href="install.html">install.html</a>.</p>
|
|
|
|
|
|
2009-06-21 17:50:05 +00:00
|
|
|
<p>The <cite>tahoe</cite> executable in the <cite>bin</cite> directory is
|
|
|
|
|
used to create, start, and stop nodes. Each node lives in a separate base
|
|
|
|
|
directory, in which there is a configuration file named "tahoe.cfg". Nodes
|
|
|
|
|
read and write files within that directory.</p>
|
2008-01-02 04:50:46 +00:00
|
|
|
|
2009-06-21 17:50:05 +00:00
|
|
|
<p>A grid consists of a single introducer, one or more servers, and any
|
|
|
|
|
number of clients. If you are creating a new grid, you'll need to create
|
|
|
|
|
both an introducer and a server (and then invite other people to create
|
|
|
|
|
their own servers and/or clients and join your grid). If you are joining an
|
|
|
|
|
existing grid (such as <a
|
2008-01-02 04:50:46 +00:00
|
|
|
href="http://allmydata.org/trac/tahoe/wiki/TestGrid">the public test
|
2009-06-21 17:50:05 +00:00
|
|
|
grid</a>), the introducer will already be running, and you'll just need to
|
|
|
|
|
create a client.</p>
|
2008-01-02 04:50:46 +00:00
|
|
|
|
2008-02-15 20:11:02 +00:00
|
|
|
<p>To construct an introducer, create a new base directory for it (the name
|
2009-06-21 17:50:05 +00:00
|
|
|
of the directory is up to you), cd into it, and run
|
|
|
|
|
"<cite><strong>path-to-the-tahoe-bin-directory</strong>/tahoe
|
|
|
|
|
create-introducer .</cite>". Now start the introducer by running
|
|
|
|
|
"<cite>tahoe start .</cite>". After it starts, it will write a file named
|
|
|
|
|
<cite>introducer.furl</cite> in that base directory. This file contains the
|
|
|
|
|
URL the other nodes must use in order to connect to this introducer.</p>
|
|
|
|
|
|
|
|
|
|
<p>To construct a node, run
|
|
|
|
|
"<cite><strong>path-to-the-tahoe-bin-directory</strong>/tahoe
|
|
|
|
|
create-client</cite>", which will create <cite>~/.tahoe</cite> to be the
|
|
|
|
|
node's base directory. Acquire a copy of the <cite>introducer.furl</cite>
|
|
|
|
|
from the introducer and put it into this directory, then run
|
|
|
|
|
"<cite><strong>path-to-the-tahoe-bin-directory</strong>/tahoe
|
|
|
|
|
start</cite>". 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. By default, a node will serve as a Storage
|
|
|
|
|
Server, meaning that it offers its disk space to other nodes. To configure
|
|
|
|
|
other behavior, see <a href="configuration.txt">configuration.txt</a>.</p>
|
|
|
|
|
|
|
|
|
|
<p>If you are behind firewall or NAT and want to run a server which clients
|
|
|
|
|
can connect to even though they are also behind firewall or NAT, then see
|
|
|
|
|
<a href="configuration.txt">configuration.txt</a> about the
|
|
|
|
|
<cite>tub.location</cite> setting.</p>
|
|
|
|
|
|
|
|
|
|
<p>To stop a running node run
|
|
|
|
|
"<cite><strong>path-to-the-tahoe-bin-directory</strong>/tahoe
|
|
|
|
|
stop</cite>".</p>
|
2008-01-02 04:50:46 +00:00
|
|
|
|
2008-02-14 15:54:34 +00:00
|
|
|
<h2>Do Stuff With It</h2>
|
2008-01-08 17:32:41 +00:00
|
|
|
|
2009-06-21 17:50:05 +00:00
|
|
|
<p>Now you have a decentralized filesystem. See <a
|
|
|
|
|
href="using.html">using.html</a> for instructions about how to interact
|
|
|
|
|
with it.</p>
|
2008-01-02 04:50:46 +00:00
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
|
|
|
|
</html>
|
