tahoe-lafs/trac-2024-07-25
2
0
Issues 1.1k Wiki Activity

Renumber 

[Imported from Trac: page AdvancedInstall, version 25]
freestorm 2010-10-03 19:29:07 +00:00
parent f5e73e0ffa
commit a6e7220396
1 changed files with 42 additions and 42 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

84
AdvancedInstall.md

@ -2,27 +2,27 @@
<a href=#point1>1. Additional Build/Install Documentation</a><br>
<a href=#point1.5>1.5 Packaged By The Operating System</a><br>
<a href=#point2>2. Dependencies</a><br>
<a href=#point3>3. Overview</a><br>
<a href=#point4>4. The "Desert Island" Build</a><br>
<a href=#point5>5. Installing Outside The Source Tree</a><br>
<a href=#point5.1>&nbsp;&nbsp;5.1. Installing The Latest Release</a><br>
<a href=#point5.2>&nbsp;&nbsp;5.2. easy_install</a><br>
<a href=#point5.3>&nbsp;&nbsp;5.3. Debian software package (deb)</a><br>
<a href=#point5.4>&nbsp;&nbsp;5.4. Windows Installer</a><br>
<a href=#point5.5>&nbsp;&nbsp;5.5. Apple Disk Image (dmg)</a><br>
<a href=#point6>6. Installing From A Source Tree</a><br>
<a href=#point6.1>&nbsp;&nbsp;6.1. Creating a binary distribution From A Source Tree</a><br>
<a href=#point7>7. Platform-specific Notes</a><br>
<a href=#point7.1>&nbsp;&nbsp;7.1. Debian/Ubuntu</a><br>
<a href=#point7.2>&nbsp;&nbsp;7.2. CentOS 5.4</a><br>
<a href=#point7.2.1>&nbsp;&nbsp;&nbsp;&nbsp;7.2.1 Dependencies</a><br>
<a href=#point7.3>&nbsp;&nbsp;7.3. MacOS</a><br>
<a href=#point7.4>&nbsp;&nbsp;7.4. Windows</a><br>
<a href=#point7.4.1>&nbsp;&nbsp;&nbsp;&nbsp;7.4.1. What if that doesn't work?</a><br>
<a href=#point7.4.2>&nbsp;&nbsp;&nbsp;&nbsp;7.4.2. How do I make it run as a Windows service?</a><br>
<a href=#point7.4.3>&nbsp;&nbsp;&nbsp;&nbsp;7.4.3. How do I make it run under a different user account?</a><br>
<a href=#point2>2 Packaged By The Operating System</a><br>
<a href=#point3>3. Dependencies</a><br>
<a href=#point4>4. Overview</a><br>
<a href=#point5>5. The "Desert Island" Build</a><br>
<a href=#point6>6. Installing Outside The Source Tree</a><br>
<a href=#point6.1>&nbsp;&nbsp;6.1. Installing The Latest Release</a><br>
<a href=#point6.2>&nbsp;&nbsp;6.2. easy_install</a><br>
<a href=#point6.3>&nbsp;&nbsp;6.3. Debian software package (deb)</a><br>
<a href=#point6.4>&nbsp;&nbsp;6.4. Windows Installer</a><br>
<a href=#point6.5>&nbsp;&nbsp;6.5. Apple Disk Image (dmg)</a><br>
<a href=#point7>7. Installing From A Source Tree</a><br>
<a href=#point7.1>&nbsp;&nbsp;6.1. Creating a binary distribution From A Source Tree</a><br>
<a href=#point8>8. Platform-specific Notes</a><br>
<a href=#point8.1>&nbsp;&nbsp;8.1. Debian/Ubuntu</a><br>
<a href=#point8.2>&nbsp;&nbsp;8.2. CentOS 5.4</a><br>
<a href=#point8.2.1>&nbsp;&nbsp;&nbsp;&nbsp;8.2.1 Dependencies</a><br>
<a href=#point8.3>&nbsp;&nbsp;8.3. MacOS</a><br>
<a href=#point8.4>&nbsp;&nbsp;8.4. Windows</a><br>
<a href=#point8.4.1>&nbsp;&nbsp;&nbsp;&nbsp;8.4.1. What if that doesn't work?</a><br>
<a href=#point8.4.2>&nbsp;&nbsp;&nbsp;&nbsp;8.4.2. How do I make it run as a Windows service?</a><br>
<a href=#point8.4.3>&nbsp;&nbsp;&nbsp;&nbsp;8.4.3. How do I make it run under a different user account?</a><br>
@ -37,12 +37,12 @@ Please feel free to add sections to this page with anything you might learn
while building Tahoe-LAFS. Information which may be useful in
the most general cases will be folded into docs/quickstart.html .
<a name="point1.5"></a>
<a name="point2"></a>
## Packaged By The Operating System
Tahoe-LAFS is already integrated into some operating systems. See [the OSPackages page](OSPackages).
<a name="point2"></a>
<a name="point3"></a>
## Dependencies
The canonical list of dependencies and their versions is in source:_auto_deps.py. To see the current versions of those dependencies (plus a few others like the Python interpreter and the operating system) run `tahoe --version`.
@ -53,7 +53,7 @@ This isn't a complete list of dependencies though, because some of those package
In addition to these, if you are running on Microsoft Windows, then you need to manually install [pywin32](http://sourceforge.net/projects/pywin32) before setting up Tahoe-LAFS.
<a name="point3"></a>
<a name="point4"></a>
## Overview
Tahoe-LAFS is happy to build and run in-place, from a source tree. It is not
@ -84,7 +84,7 @@ symlink). So until you delete the source tree, you can
symlink `~/bin/tahoe` to your source tree's `bin/tahoe` and then use
it as you would any other system executable.
<a name="point4"></a>
<a name="point5"></a>
## The "Desert Island" Build
Tahoe-LAFS will download and install most of the libraries it requires when you
@ -117,17 +117,17 @@ things. The <http://tahoe-lafs.org/source/tahoe-lafs/deps/> directory contains
historical ones, but there should never be a reason to use anything but the
latest. The tahoe-deps bundle contains a README that has a version number.
<a name="point5"></a>
<a name="point6"></a>
## Installing Outside The Source Tree
If you want to use Tahoe-LAFS without keeping the source tree around, you will
need to actually install it somewhere.
You have several options:
<a name="point5.1"></a>
<a name="point6.1"></a>
### Installing The Latest Release
<a name="point5.2"></a>
<a name="point6.2"></a>
### easy_install
"`easy_install allmydata-tahoe`", on any system that has
easy_install and setuptools installed, will download the latest release of
@ -136,27 +136,27 @@ install it into the standard place for python libraries on your system.
On unix platforms this usually goes into `/usr/lib/python2.5/site-packages/`
and `/usr/bin/tahoe` .
<a name="point5.3"></a>
<a name="point6.3"></a>
### Debian software package (deb)
On Debian or Ubuntu linux systems, you can install pre-compiled packages by
adding the tahoe-lafs.org APT repository to your `/etc/apt/sources.list`
and installing the "allmydata-tahoe" package. See [DownloadDebianPackages](DownloadDebianPackages) for
details.
<a name="point5.4"></a>
<a name="point6.4"></a>
### Windows Installer
Windows users can use an installer, which also provides the
[AllMyData](http://allmydata.com) backup client, and a SMB/winfuse -based
frontend. These installers can be downloaded from (TODO: they're built, but
where are they downloadable?).
<a name="point5.5"></a>
<a name="point6.5"></a>
### Apple Disk Image (dmg)
Mac users can use a .dmg file (also an installer?), which provides a simple
GUI app to launch the tahoe node.<br>
These can be downloaded from *(TODO: same problem)*.
<a name="point6"></a>
<a name="point7"></a>
## Installing From A Source Tree
These commands will take the current source tree and install its contents
@ -174,7 +174,7 @@ software (via GNU autoconf, etc).
("`make install PREFIX=/usr/local`" does not currently work -- see #703.)
<a name="point6.1"></a>
<a name="point7.1"></a>
### Creating a binary distribution From A Source Tree
These commands will take the current source tree and create a single-file
@ -201,10 +201,10 @@ create a windows executable, and the corresponding installer.
The "`make mac-exe`" and "`make mac-dist`" commands will create a
Macintosh OS-X executable and the corresponding installer (.dmg) file.
[=#point7]
[=#point8]
== Platform-specific Notes ==
[=#point7.1]
[=#point8.1]
=== !Debian/Ubuntu ===
Tahoe-LAFS is primarily developed on !Debian/Ubuntu machines. You can either build
@ -212,26 +212,26 @@ from source (as described by this page), or download pre-compiled debian
packages for several distributions. See the DownloadDebianPackages page for
details.
[=#point7.2]
[=#point8.2]
=== CentOS 5.4 ===
For installing in CentOS 5.4 you need this list of package:
yum install gcc python-devel sqlite-devel gcc-c++ openssl-devel
[=#point7.2.1]
[=#point8.2.1]
<h4>Dependencies</h4>
cpp glibc-devel glibc-headers kernel-headers libgomp libstdc++-devel e2fsprogs-devel keyutils-libs-devel krb5-devel libselinux-devel libsepol-devel zlib-devel
[=#point7.3]
[=#point8.3]
=== MacOS ===
You will need the standard Xcode development tools installed, or at least GCC in order to build some dependencies.[[BR]]
Note that Xcode is quite large (2.5GB) so plan accordingly if you will need to download it.
[=#point7.4]
[=#point8.4]
=== Windows ===
The following procedure will build and run Tahoe-LAFS on Windows. (This is basically exactly the [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html docs/quickstart.html] procedure except with Windows-specific paths spelled out.)
@ -255,7 +255,7 @@ Note that this assumes that you install Python in the default location (C:\Pytho
`C:\Python26\python setup.py install` can also optionally be used as on other platforms.
[=#point7.4.1]
[=#point8.4.1]
==== What if that doesn't work? ====
If the build or install steps result in an error that says a compiler is needed, install the MinGW C/C++ compiler as follows:
@ -275,12 +275,12 @@ compiler=mingw32
After installing the compilers, repeat the above instructions from step 4 (using a new command prompt to make sure that the environment variable setting has taken effect).
<a name="point7.4.2"></a>
<a name="point8.4.2"></a>
#### How do I make it run as a Windows service?
<http://agiletesting.blogspot.com/2005/09/running-python-script-as-windows.html>
<a name="point7.4.3"></a>
<a name="point8.4.3"></a>
#### How do I make it run under a different user account?
1. Create the new user account if necessary.