ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2025-02-07 11:50:21 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

re-re-factored the download and install instructions

Browse Source 
Now the instructions about how to download debian packages live on a separate
page of the wiki instead of on the front page or in the README.  The README is
only about building from source.  The front page contains pointers to those two
other pages (the debiandownloadpage and the README).
This commit is contained in:
Zooko O'Whielacronx 2007-05-02 12:54:26 -07:00
parent 6c295337b7
commit d41e944beb
2 changed files with 75 additions and 78 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

152
README
View File

@ -8,6 +8,11 @@ majority of the nodes are no longer available.
The interface to the storage grid allows you to store and fetch files, either The interface to the storage grid allows you to store and fetch files, either
by self-authenticating cryptographic identifier or by filename and path. by self-authenticating cryptographic identifier or by filename and path.
See the web site for all kinds of information, news, and community
contributions, including prebuilt packages for Debian-like systems:
http://allmydata.org
LICENCE: LICENCE:
@ -17,93 +22,74 @@ LICENCE:
this obligation for up to 12 months. See the COPYING file for details. this obligation for up to 12 months. See the COPYING file for details.
GETTING PRECOMPILED PACKAGES FOR DEBIAN-LIKE SYSTEMS: GETTING THE SOURCE CODE:
At this time, precompiled packages are available only for Debian-like The code is available via darcs by running the following command:
systems.
To install debian packages for etch, dapper, edgy, or feisty, add the darcs get http://allmydata.org/source/tahoe/trunk tahoe
following lines to your /etc/apt/sources.list, replacing the word DIST with
etch, dapper, edgy, or feisty as appropriate:
deb http://allmydata.org/debian/ DIST main tahoe Tarballs of sources are available at:
deb-src http://allmydata.org/debian/ DIST main tahoe
Then update and install the allmydata-tahoe package. These packages are http://allmydata.org/source/tahoe/
generated each time the code is changed, and represent the most up-to-date
(read "unstable") version available. The usual warnings about no guarantees
apply: it might cause your computer to catch fire, might steal your dog,
etc.
BUILDING FROM SOURCE: DEPENDENCIES:
* getting the source code: Note: All of the following dependencies can probably be installed through
your standard package management tool if you are running on a modern Unix
operating system.
The code is available via darcs by running the following command: For example, on an debian-like system, you can do "sudo apt-get install
gcc make python-dev python-twisted python-nevow python-pyopenssl".
darcs get http://allmydata.org/source/tahoe/trunk tahoe + a C compiler (language)
See http://allmydata.org for all kinds of information, news, and community + GNU make (build tool)
contributions.
* dependencies: + Python 2.4 or newer (tested against 2.4, and 2.5.1, but v2.5 or higher
is required on Windows-native), including development headers (language)
Note: All of the following dependencies can probably be installed through http://python.org/
your standard package management tool if you are running on a modern Unix
operating system.
For example, on an debian-like system, you can do "sudo apt-get install + Python Twisted (tested against both 2.4 and 2.5) (network and operating
gcc make python-dev python-twisted python-nevow python-pyopenssl". system integration library)
+ a C compiler (language) http://twistedmatrix.com/
+ GNU make (build tool) You need the following subpackages, which are included in the default
Twisted distribution:
+ Python 2.4 or newer (tested against 2.4, and 2.5.1, but v2.5 or higher * core (the standard Twisted package)
is required on Windows-native), including development headers (language) * web, trial, conch
http://python.org/ Twisted requires zope.interface, a copy of which is included in the
Twisted distribution.
+ Python Twisted (tested against both 2.4 and 2.5) (network and operating + Python Nevow (probably 0.9.0 or later) (web presentation language)
system integration library)
http://twistedmatrix.com/ http://divmod.org/trac/wiki/DivmodNevow
You need the following subpackages, which are included in the default + Python setuptools (build and distribution tool)
Twisted distribution:
* core (the standard Twisted package) Note: The build process will automatically download and install
* web, trial, conch setuptools if it is not present. However, if an old, incompatible
version of setuptools (< v0.6c3) is present, then the build will fail.
Therefore, if the build fails due to setuptools not being compatible,
you can either upgrade or uninstall your version of setuptools and try
again.
Twisted requires zope.interface, a copy of which is included in the http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions
Twisted distribution.
+ Python Nevow (probably 0.9.0 or later) (web presentation language) + Python PyOpenSSL (0.6 or later) (secure transport layer)
http://divmod.org/trac/wiki/DivmodNevow http://pyopenssl.sourceforge.net
+ Python setuptools (build and distribution tool) To install PyOpenSSL on Windows-native, download this:
http://allmydata.org/source/pyOpenSSL-0.6.win32-py2.5.exe
Note: The build process will automatically download and install + the pywin32 package: only required on Windows
setuptools if it is not present. However, if an old, incompatible
version of setuptools (< v0.6c3) is present, then the build will fail.
Therefore, if the build fails due to setuptools not being compatible,
you can either upgrade or uninstall your version of setuptools and try
again.
http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions http://sourceforge.net/projects/pywin32/
+ Python PyOpenSSL (0.6 or later) (secure transport layer)
http://pyopenssl.sourceforge.net
To install PyOpenSSL on Windows-native, download this:
http://allmydata.org/source/pyOpenSSL-0.6.win32-py2.5.exe
+ the pywin32 package: only required on Windows
http://sourceforge.net/projects/pywin32/
BUILDING: BUILDING:
@ -124,8 +110,13 @@ BUILDING:
INSTALLING: INSTALLING:
There are three ways to do it. Choose one:
The Debian Way: The Debian Way:
The Debian Way is to build .deb files which you can then install with
"dpkg".
This requires the debian packages build-essential, fakeroot, devscripts, This requires the debian packages build-essential, fakeroot, devscripts,
and the packages listed as "Build-Depends" in the DIST/debian/control in and the packages listed as "Build-Depends" in the DIST/debian/control in
the top-level tahoe directory, replacing the word DIST with etch, dapper, the top-level tahoe directory, replacing the word DIST with etch, dapper,
@ -139,21 +130,25 @@ INSTALLING:
The Python Way: The Python Way:
You'll need to run four separate install steps, one for each of the four The Python Way is to execute "setup.py install" for each Python package.
subpackages (allmydata, allmydata.Crypto, foolscap, and zfec). If you use
GNU stow, add the options "--prefix=." and You'll need to run "setup.py install" four separate times, one for each of
the four subpackages (allmydata, allmydata.Crypto, foolscap, and zfec). If
you use GNU stow, add the options "--prefix=." and
"--root=/usr/local/stow/${PACKAGE}" to the "setup.py install" command. "--root=/usr/local/stow/${PACKAGE}" to the "setup.py install" command.
for PACKAGE in zfec Crypto foolscap ; do for PACKAGE in zfec Crypto foolscap ; do
cd src/${PACKAGE} && python setup.py install && cd ../.. cd src/${PACKAGE} && python setup.py install && cd ../..
done done
# the tahoe subpackage's setup.py script is in the root directory # the tahoe subpackage's setup.py script is in the root directory
PACKAGE=tahoe PACKAGE=tahoe
python setup.py install python setup.py install
The Running-In-Place Way: The Running-In-Place Way:
The Running-In-Place Way is to add a directory to your PYTHONPATH.
To run from a source tree (without installing first), type 'make', which To run from a source tree (without installing first), type 'make', which
will put all the necessary libraries into a local directory named will put all the necessary libraries into a local directory named
"./instdir/lib", which you can then add to your PYTHONPATH . (It will put "./instdir/lib", which you can then add to your PYTHONPATH . (It will put
@ -163,16 +158,17 @@ INSTALLING:
TESTING THAT IT IS PROPERLY INSTALLED TESTING THAT IT IS PROPERLY INSTALLED
To test that all the modules got installed properly, start a python To test that all the modules got installed properly, start a python
interpreter and import modules as follows: interpreter and import modules as follows. If each one imports successfully
instead of raising ImportError then it is correctly installed.
% python % python
Python 2.4.4 (#2, Jan 13 2007, 17:50:26) Python 2.4.4 (#2, Jan 13 2007, 17:50:26)
[GCC 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)] on linux2 [GCC 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)] on linux2
Type "help", "copyright", "credits" or "license" for more information. Type "help", "copyright", "credits" or "license" for more information.
>>> import zfec >>> import zfec
>>> import allmydata.Crypto >>> import allmydata.Crypto
>>> import foolscap >>> import foolscap
>>> import allmydata.interfaces >>> import allmydata.interfaces
RUNNING: RUNNING:

1
setup.py
View File

@ -30,6 +30,7 @@ trove_classifiers=[
"Environment :: Console", "Environment :: Console",
"Environment :: Web Environment", "Environment :: Web Environment",
"License :: OSI Approved :: GNU General Public License (GPL)", "License :: OSI Approved :: GNU General Public License (GPL)",
"License :: DFSG approved",
"Intended Audience :: Developers", "Intended Audience :: Developers",
"Intended Audience :: End Users/Desktop", "Intended Audience :: End Users/Desktop",
"Intended Audience :: System Administrators", "Intended Audience :: System Administrators",