| 15 | | == Compatibility == |
| 16 | | |
| 17 | | ||=platform=||=apt-get installable=||=deb buildable=||=tahoe-lafs deb available=||=dependency debs available=||=runs-from-source=||=included in distribution=||=priority=|| |
| 18 | | ||Debian 5.0 "lenny" i386||yes?||yes||yes (use etch)||yes (use etch for zfec/foolscap)||yes?|| ||*|| |
| 19 | | ||Debian 5.0 "lenny" amd64||yes||[http://allmydata.org/buildbot/waterfall?builder=deb-lenny-soultcer&builder=deb-lenny-amd64-eugen yes]||[http://allmydata.org/debian/dists/lenny/tahoe/binary-all/ yes]||[http://allmydata.org/debian/dists/lenny/main/binary-amd64/ yes]||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=Eugen+lenny-amd64&builder=Soultcer+lenny-amd64 yes]||no|| || |
| 20 | | ||Debian 5.0 "lenny" armv5tel||no|| ? ||no||no||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=François+Lenny-armv5tel yes]|| || || |
| 21 | | ||Debian "squeeze" (unreleased)|| ? || ? || ? || ? || ? || || || |
| 22 | | ||Debian "sid" (unreleased) i386||yes||yes||no||yes||yes|| ||*|| |
| 23 | | ||Debian "sid" (unreleased) amd64||yes||yes||no||?||yes|| ||*|| |
| 24 | | ||Ubuntu 10.04 "lucid" *|| ? || ? || ? || ? || ? ||Tahoe-LAFS v1.6.1||*|| |
| 25 | | ||Ubuntu 10.10 "maverick" *|| ? || ? || ? || ? || ? ||Tahoe-LAFS v1.7.1||*|| |
| 26 | | |
| 27 | | "apt-get installable" means that it is possible to download a pre-built Tahoe-LAFS |
| 28 | | binary package from the APT repository on allmydata.org (as well as packages |
| 29 | | for any dependencies that are not otherwise available in the !Debian/Ubuntu |
| 30 | | release), and then run /usr/bin/tahoe to use that installation. Follow the |
| 31 | | instructions below to edit your /etc/apt/sources.list file. "apt-get |
| 32 | | installable" = ("tahoe-lafs deb available" AND "dependency debs available"). |
| 33 | | |
| 34 | | "deb buildable" means that a tahoe-lafs .deb package can be built from a source |
| 35 | | tree. "tahoe-lafs deb available" means the allmydata.org buildbot does this |
| 36 | | automatically, to populate the APT repository. We do not have automatic |
| 37 | | builders for all platforms, so there are holes in this table. |
| 38 | | |
| 39 | | "dependency debs available" means that the allmydata.org APT repository has |
| 40 | | debian packages available for everything that Tahoe-LAFS needs (those which are |
| 41 | | not already in that debian release: over time, many of the packages are being |
| 42 | | added to debian proper, and no longer need to be hosted here). This is |
| 43 | | required to make Tahoe-LAFS be "apt-get installable" on any given platform. |
| 44 | | |
| 45 | | "runs-from-source" means that it is possible to take a Tahoe-LAFS source tree |
| 46 | | (either from a downloaded tarball or from a darcs checkout) and run |
| 47 | | {{{python setup.py build}}} on it, then run {{{./bin/tahoe}}} to use it. This approach |
| 48 | | is described on the |
| 49 | | [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html ""Quick Start""] |
| 50 | | page. The allmydata.org buildbot automatically tests run-from-source on most |
| 51 | | debian platforms. |
| 52 | | |
| 53 | | == !Downloading/Installing Binary Packages == |
| 54 | | |
| 55 | | An APT repository is available at http://tahoe-lafs.org/debian/ . To |
| 56 | | install packages from this repository, add the following lines to your |
| 57 | | {{{/etc/apt/sources.list}}}, replacing the word {{{$DIST}}} with one of |
| 58 | | {{{etch}}}, {{{sid}}}, {{{edgy}}}, etc, as appropriate. |
| 59 | | |
| 60 | | {{{ |
| 61 | | deb http://tahoe-lafs.org/debian/ $DIST main tahoe |
| 62 | | deb-src http://tahoe-lafs.org/debian/ $DIST main tahoe |
| 63 | | }}} |
| 64 | | |
| 65 | | |
| 66 | | Then update and install the {{{allmydata-tahoe}}} package: |
| 67 | | |
| 68 | | {{{ |
| 69 | | sudo apt-get update |
| 70 | | sudo apt-get install allmydata-tahoe |
| 71 | | }}} |
| 72 | | |
| 73 | | apt-get will automatically acquire other dependency packages from the same |
| 74 | | repository (including {{{foolscap}}}, {{{zfec}}}, {{{pycryptopp}}}, and |
| 75 | | others). The "tahoe" section contains the Tahoe-LAFS debian packages, while the |
| 76 | | "main" section contains the dependency libraries. |
| 77 | | |
| 78 | | Note that these {{{allmydata-tahoe}}} packages are generated each time the |
| 79 | | code is changed, and represent the most up-to-date (read "unstable") version |
| 80 | | available. The usual warnings about no guarantees apply: it might cause your |
| 81 | | computer to catch fire, might steal your dog, etc. In the future, we will add |
| 82 | | a section to the repository that only contains released versions of Tahoe-LAFS, |
| 83 | | probably called "tahoe-releases". The packages in this section should be more |
| 84 | | stable than the bleeding-edge packages in the "tahoe" section. |
| 85 | | |
| 86 | | After installing see the [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/running.html docs/running.html] for how to use it. |
| 87 | | |
| 88 | | There are no pre-built packages available for dapper or sarge, as these |
| 89 | | releases are too old to provide the necessary support packages |
| 90 | | (python-central, setuptools, etc). You can probably still install from source |
| 91 | | on these releases, however. |
| 92 | | |
| 93 | | == Problems == |
| 94 | | |
| 95 | | Please note that the repositories for some of the distributions ain't working right now. The packages are being build, but doesn't get uploaded to the repository, therefore the Packages file doesn't get created. |
| 96 | | |
| 97 | | === Etch === |
| 98 | | |
| 99 | | Debian Etch (4.0, "oldstable") has a {{{python-pysqlite2}}} for Python 2.4 |
| 100 | | that lacks a {{{.egg-info}}}, so it is invisible to {{{setuptools}}}. |
| 101 | | Workarounds: |
| 102 | | |
| 103 | | 1. use Python 2.5 instead of Python 2.4. |
| 104 | | 2. {{{sudo apt-get install sqlite3-dev && sudo easy_install pysqlite}}}. |
| 105 | | |
| 106 | | === Edgy === |
| 107 | | |
| 108 | | Ubuntu Edgy (6.10) has a {{{python-pysqlite2}}} for Python 2.4 that has a |
| 109 | | {{{.egg-info}}} marked as being for Python 2.5, so it is invisible to |
| 110 | | {{{setuptools}}}. Workarounds: |
| 111 | | |
| 112 | | 1. use Python 2.5 instead of Python 2.4. |
| 113 | | 2. {{{sudo apt-get install sqlite3-dev && sudo easy_install pysqlite}}}. |
| 114 | | |
| 115 | | It appears that the version of |
| 116 | | Nevow (0.7.0) which shipped with edgy is broken (ubuntu bug |
| 117 | | [https://bugs.launchpad.net/ubuntu/+source/nevow/+bug/61423 #61423]), |
| 118 | | preventing the Tahoe-LAFS node's webserver from running. The symptom is an |
| 119 | | exception at node startup that looks like this: |
| 120 | | |
| 121 | | {{{ |
| 122 | | File "/var/lib/python-support/python2.4/formless/annotate.py", line 17, in ? |
| 123 | | from nevow.compy import Interface, MetaInterface |
| 124 | | exceptions.ImportError: cannot import name MetaInterface |
| 125 | | }}} |
| 126 | | |
| 127 | | We do not yet know of a solid workaround for this. One suggestion is to |
| 128 | | comment out the "from allmydata.webish import WebishServer" line from |
| 129 | | allmydata/client.py and not use the 'webport' feature. Another is to modify |
| 130 | | formless/annotate.py and try to fix that import problem. A third is to find a |
| 131 | | backport of a newer version of nevow. |
| 132 | | |
| 133 | | === Lenny === |
| 134 | | |
| 135 | | The combination of Twisted-8.1 and pyopenssl-0.7 triggers a bug (#402) that |
| 136 | | causes many unit tests to fail. This bug does not appear to impact actual |
| 137 | | operations. The current workaround is to upgrade to Twisted-8.2, downgrade |
| 138 | | to pyopenssl-0.6, or refrain from running unit tests. |
| 139 | | |
| 140 | | #768 (need .deb's of pycryptopp and zfec) |
| 141 | | #785 (lenny (onwards) packages should depend on python-pysqlite2 not python-sqlite2) |
| 142 | | |
| 143 | | == Building From Source On Debian Systems == |
| 144 | | |
| 145 | | If your platform is not listed as "apt-get installable" above, or if you |
| 146 | | don't have root access, or simply want to run Tahoe-LAFS without installing it, |
| 147 | | you can use the regular run-from-source procedure described in |
| 148 | | http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html . As long as you |
| 149 | | run this as a normal (non-root) user and don't use "sudo" at any time, this |
| 150 | | will not modify your system and will not interfere with the normal apt-get |
| 151 | | tools. Building from a source tree and then symlinking {{{~/bin/tahoe}}} to |
| 152 | | the tree's {{{bin/tahoe}}} executable is a convenient way to use Tahoe-LAFS |
| 153 | | without installing it to your {{{/usr}}} directory. |
| 154 | | |
| 155 | | Many of Tahoe-LAFS's build dependencies can be satisfied by first installing |
| 156 | | certain debian packages, and the Tahoe-LAFS build process will download and build |
| 157 | | many of the others. Please see source:docs/debian.rst for details about |
| 158 | | building Tahoe-LAFS on a debian-based system. |
| 159 | | |
| 160 | | The Tahoe-LAFS build process will download and install many of its dependencies |
| 161 | | when you run {{{make}}} or {{{setup.py build}}}. The base set of |
| 162 | | functionality that it cannot build on its own are provided by the following |
| 163 | | debian packages, so you must have these installed before you will be able to |
| 164 | | do much of anything (note that the authoritative list of packages is in the |
| 165 | | "{{{Build-Depends:}}}" clause of |
| 166 | | [source:misc/sid/debian/control misc/sid/debian/control]): |
| 167 | | |
| 168 | | * build-essential (this includes gcc, g++, make, and the headers in libc-dev) |
| 169 | | * debhelper |
| 170 | | * cdbs |
| 171 | | * python-central |
| 172 | | * python-setuptools |
| 173 | | * python |
| 174 | | * python-dev |
| 175 | | |
| 176 | | In addition, to use the "{{{make deb-PLATFORM-head}}}" target, you will also |
| 177 | | need the "debchange" utility from the "devscripts" package, and the |
| 178 | | "fakeroot" package. |
| 179 | | |
| 180 | | To actually run a Tahoe-LAFS node from a debian package, you will need the following |
| 181 | | dependencies installed. (again, the authoritative list of packages |
| 182 | | is in the {{{Depends:}}} clause of |
| 183 | | [source:misc/sid/debian/control misc/sid/debian/control]) |
| 184 | | |
| 185 | | * python-twisted-core |
| 186 | | * python-twisted-names |
| 187 | | * python-foolscap |
| 188 | | * python-pyopenssl |
| 189 | | * python-nevow |
| 190 | | * python-simplejson |
| 191 | | * python-zfec |
| 192 | | * python-pycryptopp |
| 193 | | |
| 194 | | Even if you don't intend to create a Tahoe-LAFS .deb package, you can install the |
| 195 | | supporting libraries from debian packages to reduce the build-time |
| 196 | | download-and-compile work. The Tahoe-LAFS build process will use any pre-installed |
| 197 | | libraries it can find, and will download+build everything else. |
| 198 | | |
| 199 | | == Building a Debian Package == |
| 200 | | |
| 201 | | Please see source:docs/debian.rst for details about building your own debian |
| 202 | | packages from a Tahoe-LAFS source tree. You will need to install the packages |
| 203 | | described above, including the "devscripts" and "fakeroot" packages, and you |
| 204 | | will use the {{{make deb-$PLATFORM-head}}} target. |
| 205 | | |
| 206 | | Note that this is entirely optional. Tahoe-LAFS will run just fine from a source |
| 207 | | tree: creating a debian package is merely a convenience for sysadmins to help |
| 208 | | them manage large numbers of Tahoe-LAFS nodes with established tools like apt-get. |
| 209 | | |
| 210 | | == Compatibility (Historical) == |
| 211 | | |
| 212 | | ||=platform=||=apt-get installable=||=deb buildable=||=tahoe-lafs deb available=||=dependency debs available=||=runs-from-source=||=included in distribution=||=priority=|| |
| 213 | | ||Debian 3.1 "sarge"||no||no||no||no||?||no|| || |
| 214 | | ||Debian 4.0 "etch" i386||no||yes||yes||no (missing pycryptopp)||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=etch yes]|| || || |
| 215 | | ||Ubuntu 6.06LTS "dapper" i386||no||no||no||no||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=dapper yes]|| || || |
| 216 | | ||Ubuntu 6.10 "edgy" i386||?||yes||yes||no (missing pycryptopp)||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=edgy yes]|| || || |
| 217 | | ||Ubuntu 7.04 "feisty" i386||no?||yes||yes||no (missing pycryptopp)||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=feisty2.5 yes]|| || || |
| 218 | | ||Ubuntu 7.10 "gutsy" i386||no (#149)||yes||yes||no (missing pycryptopp)||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=gutsy yes]|| || || |
| 219 | | ||Ubuntu 8.10 "intrepid" i386||no||yes||no||no||?|| || || |
| 220 | | ||Ubuntu 9.04 "jaunty" i386||no||yes||no||no||yes|| || || |
| 221 | | ||Ubuntu 9.04 "jaunty" amd64||no||yes||no||no (missing zfec, foolscap)||[http://allmydata.org/buildbot/waterfall?show_events=false&builder=Shawn%20jaunty%20amd64 yes]|| || || |
| 222 | | ||Ubuntu 9.10 "karmic" i386|| ? || ? || ? || ? || ? ||Tahoe-LAFS v1.5.0||*|| |
| 223 | | ||Ubuntu 9.10 "karmic" amd64|| ? || ? || ? || ? || ? ||Tahoe-LAFS v1.5.0||*|| |
| | 15 | If you want to see extensive notes about building and using Tahoe-LAFS on various old versions of Debian and Ubuntu, then please use the "History" link at the upper right to see previous versions of this page. |
