Changes between Initial Version and Version 1 of HeadlessUsage/NSLU2


Ignore:
Timestamp:
Jan 10, 2009, 4:15:28 PM (13 years ago)
Author:
Waldorf
Comment:

moved page, fix a typo

Legend:

Unmodified
Added
Removed
Modified
  • HeadlessUsage/NSLU2

    v1 v1  
     1= Running Transmission on a headless machine (NSLU2) =
     2[[PageOutline]]
     3(for other distributions see the [HeadlessUsage Headless Usage] article)
     4
     5== Installing ==
     6=== Using ipkg ===
     7(See also: [http://www.nslu2-linux.org/wiki/Unslung/Transmission])
     8
     9Normally you can install Transmission using this command:
     10{{{
     11$ ipkg install Transmission
     12}}}
     13The ipkg repositories may not always be up-to-date with the latest Transmission, so you might want to build it from source.
     14
     15=== Building from Source ===
     16==== Dependencies ====
     17Use ipkg to install:
     18 1. optware-devel (to get the developer toolchain)
     19 1. openssl-dev
     20 1. libcurl-dev
     21If you're '''not''' building Transmission 1.50 or a revision higher then r7258 you will also need:
     22 4. gettext
     23 4. perl-xml-parser (for intltool)
     24 4. intltool (you'll need to compile it for yourself, because it's not available on ipkg)
     25 
     26==== Building ====
     27After setting up your server and configuring it properly, you should be able to install Transmission [wiki:"Building#OnUnix" "from source"].
     28
     29Make sure that you use:
     30{{{
     31$ ./configure --prefix=/opt --datadir=/opt/share/ --disable-gtk --disable-nls CPPFLAGS=-DTR_EMBEDDED
     32}}}
     33Notes:
     34 * {{{--prefix=/opt}}}: makes sure all goes smoothly, since we are using a different partition for third party
     35 * {{{--datadir=/opt/share}}}: This installes the Web Interface in {{{/opt/share/transmission/web/}}}
     36 * {{{--disable-gtk}}}: disables the unnecessary GTK client, unless GTK+ is actually installed, it wouldn't have build anyway
     37 * {{{--disable-nls}}}: disables the unnecessary gettext dependancy  (will only be valid on Transmission 1.50 or r7258 and later)
     38 * {{{CPPFLAGS=-DTR_EMBEDDED}}}: Builds Transmission in embedded mode.
     39
     40== Configuration ==
     41You'll need to set the [EnvironmentVariables environment variable] for the Web Interface files:
     42 {{{
     43$ TRANSMISSION_WEB_HOME=/opt/share/transmission/web/
     44}}}
     45Have a look at the [EditConfigFiles Editing The "settings.json" File] page, and the [EnvironmentVariables Environment Variables] page for more information on how to configure Transmission.
     46
     47== Using Transmission ==
     48Look in the man page for the flags you'd like to set, like authentication, and type in your terminal:
     49{{{
     50$ transmission-daemon
     51}}}
     52
     53To quit the daemon:
     54{{{
     55$ killall transmission-daemon
     56}}}
     57
     58To connect to your Transmission, either use the Web Interface, or the {{{transmission-remote}}}.
     59
     60For more functionality and start/stop scripts, have a look at the [wiki:Scripts] page.
     61
     62== Troubleshooting ==
     63=== Libevent Issues on Specific Systems ===
     64If you're experiencing crashes, it may be libevent who is at the cause.
     65
     66 1. If your (package-) system has libevent installed, update it. Older, such as v1.1, are know to contain bugs.
     67 1. Try setting, one by one, the following environment variables:
     68  * {{{EVENT_NODEPOLL}}}
     69  * {{{EVENT_NOSELECT}}}
     70  * {{{EVENT_NOKQUEUE}}}
     71  * {{{EVENT_NOEVPORT}}}
     72  * {{{EVENT_NOPOLL}}}
     73Libevent is capable of handling different kinds of event mechanisms used by OSes. However, it seems that some OSes have a malfunctioning implementation of one of these event mechanisms. So, one by one, disabling one of the event mechanisms that libevent supports allows us to identify and disable the one that's misbehaving, while still supporting the others.
     74
     75''Feedback is greatly appreciated, since, honestly, we have no real idea what or why it goes wrong.''
     76----
     77== Comments ==