MLDonkey Installation

What is MLDonkey?

MLDonkey is a door to the 'donkey' world (on Windows it's normally called eMule), a multi-network, multi-platform open source P2P application used to exchange big files on the Internet and present most features of the basic Windows donkey client (eMule client) and additionally supports overnet, fasttrack, bittorrent and gnutella protocols (and more)! So how does it work with QNAP NAS? Take a look at the scenario below:

Mldonkey-topology.jpg

Below's the installation guide and basic usage for MLDonkey on QNAP NAS using QPKG software package. Please note that firmware version 2.1.0 build 0530 onwards is required.

Step 1 - Install & Start MLDonkey via QPKG Platform

New GUI

1. Go to administration web login - Applications - QPKG Center and click on the AVAILABLE tab.
2. Find MLDonkey and click on the "Install" link (on the right side).
3. Scroll up and click on the INSTALLED tab.
4. Find MLDonkey and click on the "Enable" link.

Please note that the default username and password for MLDonkey is admin/admin.

Before you start using MLDonkey you will have to forward 2 ports for incoming connections from other clients in order to gain better connection rate. QNAP has default this port to 15000 (TCP) and 15004 (UDP), and users should ensure forwarding both ports on your router to the internal IP address of your NAS that's running the MLDonkey. If you are unsure whether or not these ports are forwarded properly you may go to this site and enter your WAN IP to test them.

Old GUI

Go to 'System Tools' -> 'QPKG' and click on button 'Get QPKG' to get a list a currently available software packages.

Mldonkey-01.jpg

Once downloaded first unzip the file archive then go to 'System Tools' -> 'System Update' and install the mldonkey.qpkg file the same way as if you were updating the system firmware.

Mldonkey-02.jpg

Upon successful installation you should see a QPKG entry like the screen below. Now click 'Enable' to start the MLDonkey service. Once you see the status becomes 'Enabled' you may continue to the next step. Please note that the default username and password for MLDonkey is admin/admin.

Mldonkey-03.jpg

Before you start using MLDonkey you will have to forward 2 ports for incoming connections from other clients in order to gain better connection rate. QNAP has default this port to 15000 (TCP) and 15004 (UDP), and users should ensure forwarding both ports on your router to the internal IP address of your NAS that's running the MLDonkey. If you are unsure whether or not these ports are forwarded properly you may go to this site and enter your WAN IP to test them.

Step 2 - Download, Install & Configure Sancho

Download the latest stable version (0.9.4-58 at the time of writing) for:

• Windows here,
• Linux here.
• Mac here and here.

(The guide below will mainly be based on Windows installation)

Once downloaded double-click the setup file and install as normal Windows software installation. After successful installation start the program and first of all you will be taken through a few steps for configuration. Now you should see a setup screen like below. Click on 'Next' to continue.

Mldonkey-04.jpg

Simple ingore this step and hit 'Next' to continue.

Mldonkey-05.jpg

Configure the required settings according to the suggestions in red.

Mldonkey-06.jpg

If you can see the NAS IP address at the top you are now connected to the MLDonkey.

Mldonkey-07.jpg

Now go to the 'Servers' tab, you need to connect to some servers if it did not do it for you automatically.

Mldonkey-08.jpg

You may now fire some searches and start filling up your 'Transfer' list.

Mldonkey-09.jpg

If you reach this step successfully, Congratulations! You've just turned your NAS into eMule/eDonkey downloader! You may shut down your PCs at any time for the same purpose.

File:Mldonkey-10.jpg

Mldonkey-10.jpg

[Howto] Manually update QPKG to MLDonkey 3.X.X (x86 version)

The info comes from these threads: http://forum.qnap.com/viewtopic.php?f=122&t=40036 and http://forum.qnap.com/viewtopic.php?f=122&t=46389

"x86 version" means that your unit has an Intel processor.

Binaries

Binary for the x86 version of 3.1.5

If you just want the mlnet 3.1.5 binary for the x86 version, you can get it from here: http://wiki.qnap.com/w/images/3/3a/Mlnet3.1.5.tar.gz I use putty (tool for Windows, for more info, see last post here: viewtopic.php?f=91&t=5460#p26971 ), but any similar tool works. I did more or less like this:

First close down old MLDonkey (maybe "Disable" via the GUI on the administration web login), then:

cd /opt/tmp/
wget http://wiki.qnap.com/w/images/3/3a/Mlnet3.1.5.tar.gz
tar xvfz Mlnet3.1.5.tar.gz
mv /share/MD0_DATA/.qpkg/MLDonkey/mlnet /share/MD0_DATA/.qpkg/MLDonkey/mlnet.old.3.1.3
cp /opt/tmp/mlnet /share/MD0_DATA/.qpkg/MLDonkey/

Now you can start the new MLDonkey (maybe "Enable" via the GUI on the administration web login).

Binary for the x86 version of 3.1.3

If you just want the mlnet 3.1.3 binary for the x86 version, you can get it from here: http://wiki.qnap.com/w/images/c/c5/Mlnet3.1.3.tar.gz I use putty (tool for Windows, for more info, see last post here: viewtopic.php?f=91&t=5460#p26971 ), but any similar tool works. I did more or less like this: First close down old MLDonkey (maybe "Disable" via the GUI on the administration web login), then:

cd /opt/tmp/
wget http://wiki.qnap.com/w/images/c/c5/Mlnet3.1.3.tar.gz
tar xvfz Mlnet3.1.3.tar.gz
mv /share/MD0_DATA/.qpkg/MLDonkey/mlnet /share/MD0_DATA/.qpkg/MLDonkey/mlnet.old
cp /opt/tmp/mlnet /share/MD0_DATA/.qpkg/MLDonkey/

Now you can start the new MLDonkey (maybe "Enable" via the GUI on the administration web login).

Binaries and libs for the x86 version of 3.0.7

If you just want the mlnet 3.0.7 binaries and libs for the x86 version, you can get them from internaut19 (Cristian) here http://forum.qnap.com/viewtopic.php?f=122&t=40036&start=15#p203075 The only file I used was the mlnet file. I renamed the old one and copied the new one to same folder, and all worked well. I use putty (tool for Windows, for more info, see last post here: viewtopic.php?f=91&t=5460#p26971 ), but any similar tool works. I did more or less like this: First close down old MLDonkey (maybe "Disable" via the GUI on the administration web login), then:

cd /opt/tmp/
wget http://db.tt/qzFIvAp
tar -xvf archive.tgz
mv /share/MD0_DATA/.qpkg/MLDonkey/mlnet /share/MD0_DATA/.qpkg/MLDonkey/mlnet.old
cp /opt/tmp/mldonkey/bin/mlnet /share/MD0_DATA/.qpkg/MLDonkey/

Now you can start the new MLDonkey (maybe "Enable" via the GUI on the administration web login).

Manually update to 3.0.7, 3.1.0, 3.1.3 or 3.1.5

I think these are the steps to compile (so far). All thanks to internaut19 (Cristian) and denis.gz .

0. At least install original 3.1.0 (or 3.0.0) MLdonkey (& Optware/IPKG via QPKG):

You need Optware/IPKG
a. Go to administration web login and go to Applications - QPKG Center and install Optware, also read http://wiki.qnap.com/wiki/Install_Optware_IPKG
b. Don't forget to enable Optware in administration web login - Applications - QPKG Center (click 'Enable' ) after installation and then restart the NAS. If you have not restarted, you need at least to do

PATH=$PATH:/opt/bin:/opt/sbin

And you need at least the old 3.1.0 installed (or 3.0.0) from QPKG Plugins. Log in to the GUI on the administration web login and go to Applications - QPKG Plugins - Get QPKG and install MLDonkey. Read more about this above (maybe start from http://wiki.qnap.com/wiki/MLDonkey_Installation#Step_1_-_Install_.26.C2.A0Start_MLDonkey.C2.A0via_QPKG_Platform )

1. Read here to get some background info:

First, read http://mldonkey.sourceforge.net/OfficialFaq#Building_mldonkey for more info about compiling MLDonkey.

2. Install stuff we need

Remember, first you need both MLdonkey & Optware/IPKG via QPKG, see "0. At least install original 3.1.0 (or 3.0.0) MLdonkey & Optware/IPKG via QPKG" above

With putty (tool for Windows, for more info, see last post here: viewtopic.php?f=91&t=5460#p26971 ), or similar tool, go to /opt/tmp (or similar folder or create it with mkdir /opt/tmp ) and install stuff

cd /opt/tmp
ipkg update
ipkg install sed
ipkg install grep
ipkg install zlib
ipkg install bzip2
ipkg install gawk
ipkg install optware-devel

3. Get MLDonkey source

Examples

Get the source with your computer

Get MLDonkey source mldonkey-3.x.x.tar.bz2 from http://sourceforge.net/projects/mldonkey/files/ , maybe like this:

1. Download the file to your computer (or maybe download directly to the shared folder 'Public' (e.g. same as /share/Public) on your Qnap device).
2. Copy the file to your Qnap device, maybe to the shared folder 'Public' (e.g. same as /share/Public).
3. On your Qnap device, you move the file to your 'working' folder (so it's easier to delete all littering files when your are done). E.g. do something like this:
   
   mv /share/Public/mldonkey-3.1.5.tar.bz2 /opt/tmp

If you want to check if you got the file to the right place, you can use 'ls -la', like this:

[~] # cd /opt/tmp
[/opt/tmp] # ls -la
drwxr-xr-x 2 admin administ 4096 Aug 28 08:08 ./
drwxr-xr-x 19 admin administ 4096 Jul 16 19:46 ../
-rw-r--r-- 1 admin administ 2847382 Mar 22 12:13 mldonkey-3.1.5.tar.bz2
[/opt/tmp] #

Get the source with your Qnap device

Get the MLDonkey source file mldonkey-3.x.x.tar.bz2 from http://sourceforge.net/projects/mldonkey/files/ . To see what URL it is to the file, right click on the file URL and copy the link adress. After that you can write 'wget ' and then paste the link into Putty (or whatever you use) by right clicking where the cursor is to download the file. E.g. it will look something like this in putty:

cd /opt/tmp
wget http://sourceforge.net/projects/mldonkey/files/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2/download

On your screen you will something like this:

[/opt/tmp] # wget http://sourceforge.net/projects/mldonkey/files/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2/download
--2014-08-28 08:08:43-- http://sourceforge.net/projects/mldonkey/files/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2/download
Resolving sourceforge.net... 216.34.181.60
Connecting to sourceforge.net|216.34.181.60|:80... connected.
HTTP request sent, awaiting response... 302 Found
Location: http://downloads.sourceforge.net/project/mldonkey/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2?r=&ts=1409206127&use_mirror=cznic [following]
--2014-08-28 08:08:44-- http://downloads.sourceforge.net/project/mldonkey/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2?r=&ts=1409206127&use_mirror=cznic
Resolving downloads.sourceforge.net... 216.34.181.59
Connecting to downloads.sourceforge.net|216.34.181.59|:80... connected.
HTTP request sent, awaiting response... 302 Found
Location: http://cznic.dl.sourceforge.net/project/mldonkey/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2 [following]
--2014-08-28 08:08:44-- http://cznic.dl.sourceforge.net/project/mldonkey/mldonkey/3.1.5/mldonkey-3.1.5.tar.bz2
Resolving cznic.dl.sourceforge.net... 217.31.202.30
Connecting to cznic.dl.sourceforge.net|217.31.202.30|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 2847382 (2.7M) [application/octet-stream]
Saving to: `mldonkey-3.1.5.tar.bz2' 100%[======================================>] 2,847,382 4.88M/s in 0.6s 2014-08-28 08:08:45 (4.88 MB/s) - `mldonkey-3.1.5.tar.bz2' saved [2847382/2847382]

If you want to check if you got the file, you can use 'ls -la', like this:

[~] # cd /opt/tmp
[/opt/tmp] # ls -la
drwxr-xr-x 2 admin administ 4096 Aug 28 08:08 ./
drwxr-xr-x 19 admin administ 4096 Jul 16 19:46 ../
-rw-r--r-- 1 admin administ 2847382 Mar 22 12:13 mldonkey-3.1.5.tar.bz2
[/opt/tmp] #

4. Unpack and go to MLDonkey folder

cd /opt/tmp
tar -xvf mldonkey-3.1.5.tar.bz2
cd mldonkey-3.1.5

5. Hide/remove ocaml

You want it to install ocaml locally, so you need to remove or hide it. I did

ipkg remove ocaml

6. Configure

When it asks

"Do you want this script to try to download and install ocaml LOCALLY in mldonkey directory ?"

Answer y    (and then press [Enter] ;-)

cd /opt/tmp/mldonkey-3.1.5
mkdir /share/Public/mldonkey
PATH=/opt/bin:$PATH
./configure --prefix=/share/Public/mldonkey --disable-fasttrack CPPFLAGS="-I/opt/include" LDFLAGS="-L/opt/lib"

Now wait... And wait....

7. Change config file

Open /opt/tmp/mldonkey-3.1.5/config/Makefile.config and change

CFLAGS=-g -O2
to
CFLAGS=-g -Os

and
CXXFLAGS=-g -O2
to
CXXFLAGS=-g -Os

Here is some info about editing files, scroll to last post: viewtopic.php?f=88&t=3628#p142945

8. Compile

Then you run make (I would say it's optional to run 'make depend' before 'make', but you can do it if you wish)

cd /opt/tmp/mldonkey-3.1.5
make

Now you should have the file mlnet in /opt/tmp/mldonkey-3.1.5

9. Use the new mlnet

Again, you need at least the old 3.1.0 installed (or 3.0.0) from QPKG Plugins.Close down the old MLDonkey (maybe "Disable" via the GUI on the administration web login), rename old mlnet and then copy the new one to the right place

mv /share/MD0_DATA/.qpkg/MLDonkey/mlnet /share/MD0_DATA/.qpkg/MLDonkey/mlnet.old.3.1.3
cp /opt/tmp/mldonkey-3.1.5/mlnet /share/MD0_DATA/.qpkg/MLDonkey/

Start the new MLDonkey binary (maybe "Enable" via the GUI on the administration web login). You can check the version of MLDonkey with this command in the console:

version

[Howto] Email notification with SSL SMTP

In this example I use stunnel and email via a Hotmail account (as a 'relay' server) to the email account to where really I want the notifications (mrman@surfnet.com)..

So for the Hotmail account (as a 'relay' server) I use:

SMTP server: smtp.live.com:587
Account to log in on the SMTP: mrtheman@hotmail.com (use your own Hotmail/Live account)
Password: In the picture it looks like ******, but in reality the password will be written i clear text, like: mysecretpassword. So if you are afraid someone will be able to see this password, create a new account that you don't care about.

You can also use a Google account to relay the noticications, I think Googles SMTP server is smtp.gmail.com:465

Add a smtp part like this in /etc/stunnel/stunnel.conf
[smtp]
accept = 127.0.0.1:55525
connect = smtp.live.com:587
protocol = smtp

And change to client = yes in the global part, so it all looks like this:

; Sample stunnel configuration file by Michal Trojnara 2002-2006
; Some options used here may not be adequate for your particular configuration
; Please make sure you understand them (especially the effect of chroot jail)

; Certificate/key is needed in server mode and optional in client mode
cert = /etc/stunnel/stunnel.pem
;key = /usr/local/etc/stunnel/mail.pem

ciphers = ALL:!SSLv2:!LOW:!EXPORT40:@STRENGTH
;chroot = /usr/local/var/lib/stunnel/
setuid = admin
setgid = administrators
; PID is created inside chroot jail
pid = /stunnel.pid

; Some performance tunings
socket = l:TCP_NODELAY=1
socket = r:TCP_NODELAY=1
;compression = rle

; Workaround for Eudora bug
;options = DONT_INSERT_EMPTY_FRAGMENTS

; Authentication stuff
;verify = 2
; Don't forget to c_rehash CApath
; CApath is located inside chroot jail
;CApath = /certs
; It's often easier to use CAfile
;CAfile = /etc/stunnel/stunnel.pem
;CAfile = /usr/local/etc/stunnel/certs.pem
; Don't forget to c_rehash CRLpath
; CRLpath is located inside chroot jail
;CRLpath = /crls
; Alternatively you can use CRLfile
;CRLfile = /usr/local/etc/stunnel/crls.pem

; Some debugging stuff useful for troubleshooting
debug = 0
output = /dev/null 
;output = /opt/var/hotmail.log

; Use it for client mode
;client = no
client = yes

; Service-level configuration

;[pop3s]
;accept = 995
;connect = 110

;[imaps]
;accept = 993
;connect = 143

;[ssmtp]
;accept = 465
;connect = 25

[smtp]
accept = 127.0.0.1:55525
connect = smtp.live.com:587
protocol = smtp

[https]
accept = 443
connect = 127.0.0.1:8080
TIMEOUTclose = 0
TIMEOUTconnect = 2

In MLdonkey I have this:

Then restart stunnel
/etc/init.d/stunnel.sh restart

External Resource & Links

Official MLDonkey wiki

MLDonkey options explained

slow macbook

MLDonkey simple configuration provided by Fabtar

MLDonkey simple guide Provided by Fabtar

mlnet binary version 3.1.3 for x86 (Intel) Provided by raffe

mlnet binary version 3.1.5 for x86 (Intel) Provided by raffe