| 1 | ============== |
|---|
| 2 | Debian Support |
|---|
| 3 | ============== |
|---|
| 4 | |
|---|
| 5 | 1. `Overview`_ |
|---|
| 6 | 2. `Dependency Packages`_ |
|---|
| 7 | |
|---|
| 8 | Overview |
|---|
| 9 | ======== |
|---|
| 10 | |
|---|
| 11 | Tahoe-LAFS is provided as a .deb package in current Debian (>=wheezy) and |
|---|
| 12 | Ubuntu (>=lucid) releases. Before official packages were added, the Tahoe |
|---|
| 13 | source tree provided support for building unofficial packages for a variety |
|---|
| 14 | of popular Debian/Ubuntu versions. The project also ran buildbots to create |
|---|
| 15 | .debs of current trunk for ease of testing. |
|---|
| 16 | |
|---|
| 17 | As of version 1.9, the source tree no longer provides these tools. To |
|---|
| 18 | construct a .deb from current trunk, your best bet is to apply the current |
|---|
| 19 | debian diff from the latest upstream package and invoke the debian/rules as |
|---|
| 20 | usual. Debian's standard "apt-get" tool can be used to fetch the current |
|---|
| 21 | source package (including the debian-specific diff): run "apt-get source |
|---|
| 22 | tahoe-lafs". That will fetch three files: the .dsc control file, the main |
|---|
| 23 | Tahoe tarball, and the debian-specific .debian.tar.gz file. Just unpack the |
|---|
| 24 | .debian.tar.gz file inside your Tahoe source tree, modify the version number |
|---|
| 25 | in debian/changelog, then run "fakeroot ./debian/rules binary", and a new |
|---|
| 26 | .deb will be placed in the parent directory. |
|---|
| 27 | |
|---|
| 28 | Dependency Packages |
|---|
| 29 | =================== |
|---|
| 30 | |
|---|
| 31 | Tahoe depends upon a number of additional libraries. When building Tahoe from |
|---|
| 32 | source, any dependencies that are not already present in the environment will |
|---|
| 33 | be downloaded (via easy_install) and stored in the support/lib directory. |
|---|
| 34 | |
|---|
| 35 | The .deb packages, of course, rely solely upon other .deb packages. For |
|---|
| 36 | reference, here is a list of the debian package names that provide Tahoe's |
|---|
| 37 | dependencies as of the 1.9 release: |
|---|
| 38 | |
|---|
| 39 | python |
|---|
| 40 | python-zfec |
|---|
| 41 | python-pycryptopp |
|---|
| 42 | python-foolscap |
|---|
| 43 | python-openssl (needed by foolscap) |
|---|
| 44 | python-twisted |
|---|
| 45 | python-nevow |
|---|
| 46 | python-mock |
|---|
| 47 | python-simplejson |
|---|
| 48 | python-setuptools |
|---|
| 49 | python-support (for debian-specific install-time tools) |
|---|
| 50 | |
|---|
| 51 | When building your own debian packages, a convenient way to get all these |
|---|
| 52 | dependencies installed is to first install the official "tahoe-lafs" package, |
|---|
| 53 | then uninstall it, leaving the dependencies behind. You may also find it |
|---|
| 54 | useful to run "apt-get build-dep tahoe-lafs" to make sure all the usual |
|---|
| 55 | build-essential tools are installed. |
|---|
