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>1. Additional Build/Install Documentation</a><br>
<a href=#point1.5>1.5 Packaged By The Operating System</a><br> <a href=#point2>2 Packaged By The Operating System</a><br>
<a href=#point2>2. Dependencies</a><br> <a href=#point3>3. Dependencies</a><br>
<a href=#point3>3. Overview</a><br> <a href=#point4>4. Overview</a><br>
<a href=#point4>4. The "Desert Island" Build</a><br> <a href=#point5>5. The "Desert Island" Build</a><br>
<a href=#point5>5. Installing Outside The Source Tree</a><br> <a href=#point6>6. Installing Outside The Source Tree</a><br>
<a href=#point5.1>&nbsp;&nbsp;5.1. Installing The Latest Release</a><br> <a href=#point6.1>&nbsp;&nbsp;6.1. Installing The Latest Release</a><br>
<a href=#point5.2>&nbsp;&nbsp;5.2. easy_install</a><br> <a href=#point6.2>&nbsp;&nbsp;6.2. easy_install</a><br>
<a href=#point5.3>&nbsp;&nbsp;5.3. Debian software package (deb)</a><br> <a href=#point6.3>&nbsp;&nbsp;6.3. Debian software package (deb)</a><br>
<a href=#point5.4>&nbsp;&nbsp;5.4. Windows Installer</a><br> <a href=#point6.4>&nbsp;&nbsp;6.4. Windows Installer</a><br>
<a href=#point5.5>&nbsp;&nbsp;5.5. Apple Disk Image (dmg)</a><br> <a href=#point6.5>&nbsp;&nbsp;6.5. Apple Disk Image (dmg)</a><br>
<a href=#point6>6. Installing From A Source Tree</a><br> <a href=#point7>7. 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.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=#point8>8. Platform-specific Notes</a><br>
<a href=#point7.1>&nbsp;&nbsp;7.1. Debian/Ubuntu</a><br> <a href=#point8.1>&nbsp;&nbsp;8.1. Debian/Ubuntu</a><br>
<a href=#point7.2>&nbsp;&nbsp;7.2. CentOS 5.4</a><br> <a href=#point8.2>&nbsp;&nbsp;8.2. CentOS 5.4</a><br>
<a href=#point7.2.1>&nbsp;&nbsp;&nbsp;&nbsp;7.2.1 Dependencies</a><br> <a href=#point8.2.1>&nbsp;&nbsp;&nbsp;&nbsp;8.2.1 Dependencies</a><br>
<a href=#point7.3>&nbsp;&nbsp;7.3. MacOS</a><br> <a href=#point8.3>&nbsp;&nbsp;8.3. MacOS</a><br>
<a href=#point7.4>&nbsp;&nbsp;7.4. Windows</a><br> <a href=#point8.4>&nbsp;&nbsp;8.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=#point8.4.1>&nbsp;&nbsp;&nbsp;&nbsp;8.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=#point8.4.2>&nbsp;&nbsp;&nbsp;&nbsp;8.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=#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 while building Tahoe-LAFS. Information which may be useful in
the most general cases will be folded into docs/quickstart.html . 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 ## Packaged By The Operating System
Tahoe-LAFS is already integrated into some operating systems. See [the OSPackages page](OSPackages). Tahoe-LAFS is already integrated into some operating systems. See [the OSPackages page](OSPackages).
<a name="point2"></a> <a name="point3"></a>
## Dependencies ## 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`. 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. 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 ## Overview
Tahoe-LAFS is happy to build and run in-place, from a source tree. It is not 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 symlink `~/bin/tahoe` to your source tree's `bin/tahoe` and then use
it as you would any other system executable. it as you would any other system executable.
<a name="point4"></a> <a name="point5"></a>
## The "Desert Island" Build ## The "Desert Island" Build
Tahoe-LAFS will download and install most of the libraries it requires when you 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 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. 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 ## Installing Outside The Source Tree
If you want to use Tahoe-LAFS without keeping the source tree around, you will If you want to use Tahoe-LAFS without keeping the source tree around, you will
need to actually install it somewhere. need to actually install it somewhere.
You have several options: You have several options:
<a name="point5.1"></a> <a name="point6.1"></a>
### Installing The Latest Release ### Installing The Latest Release
<a name="point5.2"></a> <a name="point6.2"></a>
### easy_install ### easy_install
"`easy_install allmydata-tahoe`", on any system that has "`easy_install allmydata-tahoe`", on any system that has
easy_install and setuptools installed, will download the latest release of 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/` On unix platforms this usually goes into `/usr/lib/python2.5/site-packages/`
and `/usr/bin/tahoe` . and `/usr/bin/tahoe` .
<a name="point5.3"></a> <a name="point6.3"></a>
### Debian software package (deb) ### Debian software package (deb)
On Debian or Ubuntu linux systems, you can install pre-compiled packages by 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` adding the tahoe-lafs.org APT repository to your `/etc/apt/sources.list`
and installing the "allmydata-tahoe" package. See [DownloadDebianPackages](DownloadDebianPackages) for and installing the "allmydata-tahoe" package. See [DownloadDebianPackages](DownloadDebianPackages) for
details. details.
<a name="point5.4"></a> <a name="point6.4"></a>
### Windows Installer ### Windows Installer
Windows users can use an installer, which also provides the Windows users can use an installer, which also provides the
[AllMyData](http://allmydata.com) backup client, and a SMB/winfuse -based [AllMyData](http://allmydata.com) backup client, and a SMB/winfuse -based
frontend. These installers can be downloaded from (TODO: they're built, but frontend. These installers can be downloaded from (TODO: they're built, but
where are they downloadable?). where are they downloadable?).
<a name="point5.5"></a> <a name="point6.5"></a>
### Apple Disk Image (dmg) ### Apple Disk Image (dmg)
Mac users can use a .dmg file (also an installer?), which provides a simple Mac users can use a .dmg file (also an installer?), which provides a simple
GUI app to launch the tahoe node.<br> GUI app to launch the tahoe node.<br>
These can be downloaded from *(TODO: same problem)*. These can be downloaded from *(TODO: same problem)*.
<a name="point6"></a> <a name="point7"></a>
## Installing From A Source Tree ## Installing From A Source Tree
These commands will take the current source tree and install its contents 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.) ("`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 ### Creating a binary distribution From A Source Tree
These commands will take the current source tree and create a single-file 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 The "`make mac-exe`" and "`make mac-dist`" commands will create a
Macintosh OS-X executable and the corresponding installer (.dmg) file. Macintosh OS-X executable and the corresponding installer (.dmg) file.
[=#point7] [=#point8]
== Platform-specific Notes == == Platform-specific Notes ==
[=#point7.1] [=#point8.1]
=== !Debian/Ubuntu === === !Debian/Ubuntu ===
Tahoe-LAFS is primarily developed on !Debian/Ubuntu machines. You can either build 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 packages for several distributions. See the DownloadDebianPackages page for
details. details.
[=#point7.2] [=#point8.2]
=== CentOS 5.4 === === CentOS 5.4 ===
For installing in CentOS 5.4 you need this list of package: For installing in CentOS 5.4 you need this list of package:
yum install gcc python-devel sqlite-devel gcc-c++ openssl-devel yum install gcc python-devel sqlite-devel gcc-c++ openssl-devel
[=#point7.2.1] [=#point8.2.1]
<h4>Dependencies</h4> <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 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 === === MacOS ===
You will need the standard Xcode development tools installed, or at least GCC in order to build some dependencies.[[BR]] 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. Note that Xcode is quite large (2.5GB) so plan accordingly if you will need to download it.
[=#point7.4] [=#point8.4]
=== Windows === === 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.) 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. `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? ==== ==== 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: 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). 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? #### How do I make it run as a Windows service?
<http://agiletesting.blogspot.com/2005/09/running-python-script-as-windows.html> <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? #### How do I make it run under a different user account?
1. Create the new user account if necessary. 1. Create the new user account if necessary.