Versions Compared

Old Version 5

changes.mady.by.user Leif Johansson

Saved on

compared with

New Version Current

changes.mady.by.user Johan Lundberg

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

A lobber storage node is essentially a standard BitTorrent client with a very thin layer used to receive notification about new and modified torrents. A lobber storage node is provided as a twisted plugin and is installed from the python package index. There is no dependency on any one BitTorrent client but development and testing is done using transmission, a BitTorrent client designed to run as a headless standalone serverCurrently the twisted plugin works with transmission - a popular, cross-platform BitTorrent client. Other BT clients may be supported in the future.

Installing

The examples below assume a debian/ubuntu environment. If you're running another unix-like or windows OS your milage may vary. Our goal is for lobber to run on a multitude of environments and operating systems. Please provide us with patches!

Transmission

We recommend installing transmission 2.03 or later. If you are using ubuntu 10.04 you may have to install transmission from a PPA:

Code Block

# apt-get install python-software-properties
# add-apt-repository ppa:transmissionbt/ppa
# apt-get update

If you run Ubuntu 10.10 you onlu need to do the next bit.

Code Block
# apt-get install transmission-cli transmission-daemon deluge-common

At this point you should have a transmission daemon running after each reboot. Use the /etc/init.d/transmission-daemon tool to stop/start the service in the normal way.

...

The lobberstoragenode is available from http://pypi.python.org/ and can be installed using the easy_install tool from python-setuptools:

Warning

Errata: You may have to download the tarball and install it using the provided setup.py instead of using easy_install.

Code Block
# apt-get install python-setuptools python-twisted python-feedparser bittorrent
# easy_install stompservice transmissionrpc
Code Block
# easy_install lobberstoragenode

or install lobberstoragenode from GIT or from tarballs...

At this point twistd should have a new plugin registered. Verify this by running twistd --help and look for lobberstoragenode in the list of commands. If you see this then you're installation should be ok.

...

Running twistd lobberstoragenode --help gives you an overview of the options:

Code Block
#$ twistd lobberstoragenode --help
Usage: twistd [options] lobberstoragenode [options]
Options:
  -n, --standardNotifications      Add standard notificiation destinations
  -R, --register                   Register new torrents with lobber
  -Sa, --stompUrlannounceUrl=    The STOMP protocol           Announce URL (tracker) to use for new
                                   torrents
  -A, --acl=                       Access Control List to apply to new torrents
  -b, --dropbox=                   A directory to watch for notifications [default: new content
  -d, --torrentDir=                The directory where to store torrents
                                   [default: torrents]
  -D, --transmissionDownloadsDir=  The downloads directory for transmission
                     stomp://localhost:61613]              [default:
                                   /var/lib/transmission-daemon/downloads]
  -h, --lobberHost=                The host running both STOMP and https for
                                   lobber
  -k, --lobberKey=                 The Lobber application key to use
  -p, --trackerProxyTrackerUrl=    Enable tracker proxying for given https
                                   tracker (HOST[:PORT])
  -dP, --torrentDirtrackerProxyListenOn=     The directory where to store torrents Adress to bind the tracker proxy to [default:
                                   localhost:8080]
  -r, --removeLimit=               Remove torrent and data when this many other
                                   storage-nodes have the data (0=never remove)
                                   [default: torrents0]
  -uS, --lobberUrl=stompUrl=                  The STOMP Lobber URL prefixprotocol URL to use for
                                   notifications [default:
                     http              stomp://localhost:8000/torrents61613]
  -sT, --scripttransmissionRpc=        The script to runThe onRPC allURL receivedfor torrentstransmission [default: ls -l
                                   http://transmission:transmission@localhost:9091]
      --version                    
      --help                       Display this help and exit.

When running a storage-node for development purposes you will typically run it with both the --stompUrl and --lobberUrl parameters pointing to endpoints on your local development sandbox. When running a storage-node off of beta.lobber.se you will typically want to start it this way:

...

A more complete example. This would regularly pull all torrents linked from https://beta.lobber.se/torrent/tag/foo.rssImage Removed and ask transmission to add the new ones.

...