tahoe-lafs/docs/install-details.html
Zooko O'Whielacronx 0eb31774d1 docs: a bunch of updates to simplify the process of installing from source and running Tahoe
These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files 
are complete and should work (and they are delightfully concise!).  I'm pushing this just to let people see incremental progress 
and to solicit feedback.  "Testing out" the install.html and running.html files and submitting patches or bug reports would be 
quite welcome.

More to come.
2007-12-30 05:47:17 -07:00

99 lines
3.9 KiB
HTML

The code is retrievable using the <a href="http://darcs.net">darcs</a>
revision control tool by running the following command:
<pre>
darcs get http://allmydata.org/source/tahoe/trunk tahoe
</pre>
This will create a directory named <pre>tahoe</pre> in the current working
directory and put a copy of the latest source code into it. Later, if
you want to get any new changes, then cd into that directory and run
the command <pre>darcs pull</pre>.
<table>
<tt>operating system</tt><td>location of <pre>tahoe</pre> executable</td>
<tt>linux</tt><td><pre>/usr/bin</pre></td>
<tt>cygwin</tt><td><pre>/usr/bin</pre></td>
<tt>Windows</tt><td><pre>C:\Python25\Scripts</pre></td>
<tt>Mac OS X</tt><td><pre>/Frameworks/Python/Versions/2.5/binpre>(XXX double-check this)</td>
<tt>Solaris</tt><td><pre>/usr/bin</pre>(XXX double-check this)</td>
</table>
EASY_INSTALLABLE DEPENDENCIES
The following Python packages are required, but normally they are
automatically installed as a side-effect of installing Tahoe.
+ Python setuptools (build and distribution tool)
http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions
The Tahoe install process will automatically download and install
setuptools if it is not present. However, if an old, incompatible version
of setuptools is present (< v0.6c6 on Cygwin, or < v0.6a9 on other
platforms), then the install will fail.
If the install fails due to your current version of setuptools being
incompatible, please either upgrade or uninstall your version of
setuptools and re-run the install.
+ zfec (erasure coding library)
http://cheeseshop.python.org/pypi/zfec
zfec is packaged in a setuptools-compatible way and included in the Python
Package Index (PyPI), so it will be automatically installed when you
install Tahoe (see INSTALLING). It can be manually installed by running
"easy_install zfec".
+ Python foolscap (secure remote object library)
http://cheeseshop.python.org/pypi/foolscap
foolscape is packaged in a setuptools-compatible way and included in the
Python Package Index (PyPI), so it will be automatically installed when
you install Tahoe (see INSTALLING). It can be manually installed by
running "easy_install foolscap".
+ Python simplejson (JSON parser)
http://cheeseshop.python.org/pypi/simplejson
simplejson is packaged in a setuptools-compatible way and included in the
Python Package Index (PyPI), so it will be automatically installed when
you install Tahoe (see INSTALLING). It can be manually installed by
running "easy_install simplejson".
+ Python Nevow (0.6.0 or later) (web presentation language)
http://divmod.org/trac/wiki/DivmodNevow
Note that the current version of Nevow (0.9.18) requires Twisted 2.4.0 or
later.
Nevow is packaged in a setuptools-compatible way and included in the
Python Package Index (PyPI), so it will be automatically installed when
you install Tahoe (see INSTALLING). It can be manually installed by
running "easy_install nevow".
+ Python pycryptopp (0.2.1 or later) (Python crypto library)
http://pypi.python.org/pypi/pycryptopp
pycryptopp is packaged in a setuptools-compatible way and included in the
Python Package Index (PyPI), so it will be automatically installed when
you install Tahoe (see INSTALLING). It can be manually installed by
running "easy_install nevow".
If you are behind a firewall and you can configure your firewall to
forward TCP connections on a port to the computer running your Tahoe
node, then you can configure the Tahoe node to announce itself as
being available on that IP address and port. The way to do this is to
create a file named $HERE/advertised_ip_addresses, in which you can
put IP addresses and port numbers in "dotted-quad:port" form,
e.g. "209.97.232.113:1345". You can put multiple
IP-address-and-port-number entries into this file, on separate lines.