ENHACEMENTS FOR MEMUP MEDIADISK LX LAN SERIES

(Version 8.1)

This file contains three enhacements for the LX LAN multimedia hard disks
developed by MemUp. These enhacements are: a new BitTorrent client, a FTP
server, and support for EXT3 file format in the main partition.

Changes from 8.0 to 8.1

	Updated Transmission BitTorrent client to version 2.22

Changes from 7.1 to 8.0

	Updated Transmission BitTorrent client to version 2.21
	Now executables are dynamically linked, which allows to use less memory

Changes from 7.0 to 7.1

	Updated Transmission BitTorrent client to version 2.13

Changes from 6.2 to 7.0

	Added CTRANSMISSION (transmission control)

Changes from 6.1 to 6.2

	Updated Transmission BitTorrent client to version 2.12
	Updated Bftpd to version 3.1

Changes from 6.0 to 6.1

	Updated Transmission BitTorrent client to version 2.11

Changes from 5.0 to 6.0

	Updated Transmission BitTorrent client to version 2.10
	Updated Bftpd to version 3.0

Changes from 4.4 to 5.0

	Updated Transmission BitTorrent client to version 2.01
	Updated Bftpd to version 2.9

Changes from 4.3 to 4.4

	Updated Transmission BitTorrent client to version 1.93

Changes from 4.2 to 4.3

	Updated Bftpd to version 2.8 (fixes the zombie process bug, and
		allows to see hidden files and broken links)

Changes from 4.1 to 4.2

	Updated bFTPd to version 2.7 (allows to delete folders from Nautilus)

Changes from 4.0 to 4.1

	Updated Transmission BitTorrent client to version 1.92

Changes from 3.0 to 4.0

	Updated Transmission BitTorrent client to version 1.91

Changes from 2.0 to 3.0

	Added the Transmission BitTorrent client, v 1.76
	

Changes from 0.1 to 1.0

	Upgraded versions to
		bftpd 2.6
		yodct 0.7.2
		ctorrent 3.3.2


INSTALLING EVERYTHING

First, you must ensure that your hard disk has installed both the BitTorrent
client and the Samba server, because we need the operating system to search
and run some scripts. If yours don't have them, you must format the system,
and, when it ends, will ask you (only for 5 seconds) to install them or not.
Formatting the disk also ensures that the swap partition has been correctly
initialized. Another way is to go to the Settings menu and choose the
option to install the packages.

My MemUp LX multimedia disk has three main partitions in its hard disk:

* the first one, /dev/hda1, contains the swap. Be sure that it's formatted,
or your hard disk will hang periodically. If is not formatted, just format
your hard disk from the main menu or do it yourself manually from telnet.

* the second one, /dev/hda2, contains the SMB server, BitTorrent client, and
other bits. Here we will install our software. It's in EXT3 format, and is
mounted in /tmp/hdd/root.

* the third one, /dev/hda3, contains all the user data: movies, music, and
so on. It can be formated in NTFS or FAT32, and is mounted in
/tmp/hdd/volumes/HDD1.

To install this upgrade, just copy the UPGRADE_X.Y.TAR file to your hard disk,
using SMB or with an USB cable. Then connect to the machine using telnet (user
root, no password), go to /tmp/hdd/volumes/HDD1, move UPGRADE_X.Y.TAR into
/tmp/hdd/root, and untar it there using "tar -xpvf upgrade_x.y.tar" (to
preserve permissions). It will uncompress four folders (etc, ctorrent, libs,
transmission and bftpd) and one script: BTPD.

Now edit with vi the BTPD script. At the beginning you will find this:

# change here to set the services you want:
# 1: launch it
# 0: don't launch it

# main partition in EXT3 format
HD_EXT3=1

# old BitTorrent service
OLD_BT=0

# cTorrent BitTorrent service
CTORRENT=0

# Transmission BitTorrent service
TRANSMISSION=1

# Transmision Torrent limiter
BTLIMITER=1

# FTP server
FTP=1

Change the variables to set the values you want. So, if you want to use EXT3
file format in your main partition, set HD_EXT3 to 1; if not, set it to 0
(more on this below). The same with all the other three: set OLD_BT to 1 if
you want to use the old BitTorrent client, or set it to 0 to don't use it.
cTorrent does the same with the net cTorrent client, FTP to the bftpd FPT
server and TRANSMISSION for the Transmission bittorrent client. Don't set
more than one bittorrent client at the same time (is useless to do it).
The best client is Transmission, because supports criptography and uPNP,
but needs more memory. cTorrent is a good lightweight alternative. And the
classic client, well...

A novel program added in version 7.0 is the transmission limiter
(CTRANSMISSION), which helps to achieve an optimal download rate
when downloading several torrents (more details in the CTRANSMISSION
folder). Is strongly reccomended to activate it if you use Transmission. It
will keep only one download active simultaneously, and, as soon as it ends,
will start the next automatically. When all files have been downloaded, it
will keep them seeding in a round-robbin scheme, to ensure a fair sharing.

When you have done it, move that script into the SCRIPT folder, already in
your multimedia hard disk, overwritting the one there (don't forget to make
before a backup of the original file. I attach a copy of MY original BTPD
file, but have caution).

Finally, launch everything by running the script with

	./btpd start

To disable the SMB server, just remove the executable bit in its run script.


GETTING ACCESS TO THE BITTORRENT CLIENTS

If 192.168.0.101 is the IP address of the multimedia hard disk, to access
to the old bittorrent client point your browser to

    http://192.168.0.101

To access the Transmission bittorrent client, point your browser to

    http://192.168.0.101:9090

And to access the cTorrent client, point your browser to

    http://192.168.0.101:8080

user is 'admin', and password is '123'.

When using BitTorrent, I recommend to limit the download rate to about
400KB/sec, because higher speeds in one file whould saturate the device and
lock both the download in the other files and all the uploads, or even hang
the operating system.


I CAN'T ACCESS TRANSMISSION BITTORRENT WEB PAGE

If you had an old version (3.0 or older) installed, the range of valid
IP address to access the Transmission web page is 192.168.1.*. You should
remove the file

	/tmp/hdd/volumes/HDD1/BT/transmission_tmp/settings.json

in order to get it replaced with the new version (which allows IP address
from 192.168.*.* to get access to the web page), or manually modify that
file to set the IP filter ("rpc-whitelist" parameter) to the desired range.


FORMATTING THE MAIN PARTITION IN EXT3 FORMAT

In order to use the main partition in EXT3 format, you must format it
manually first:

	unmount /dev/hda3
	mkfs.ext2 -j /dev/hda3

(remember that everything in that partition will be erased) and only then
install my BTPD script replacement.


USING THE BINARIES IN OTHER SYSTEMS

Starting from version 8.0, the binaries are dynamically linked for MIPSel
architecture. It also includes the dynamic loader, since the one available in
the hard disk can't load them.

To use the binaries in other systems, you must have the new dynamic
loader installed in /tmp/hdd/root/libs. It's mandatory, because the dynamic
loader path is hardcoded in the binaries. To do so, just copy the LIBS
folder in the TAR file in /tmp/hdd/root.

Once done this, you can launch a binary just by setting the
LD_LIBRARY_PATH acordingly. Example:

  LD_LIBRARY_PATH=/tmp/hdd/root/libs /bin/bftpd

will launch the BFTPD binary, available in /BIN.


CONTACTING THE AUTHOR

Sergio Costas Rodriguez (Raster Software Vigo).
http://www.rastersoft.com
raster@rastersoft.com
