You are on page 1of 4

Quickstart guide

From MLDonkey

Contents
1 Download and Installation 1.1 Install binaries 1.1.1 Linux 1.2 Install package 1.2.1 Debian/Ubuntu 1.2.2 Red Hat/Fedora 1.2.3 Gentoo 1.3 Compile from source 1.4 Installation on NAS boxes and embedded 1.5 Software appliance 2 Initial Setup and Usage 2.1 Executing Mldonkey 2.2 Enabling Access 2.3 Conguration and tuning 2.4 Using Web Interface 2.5 Searching for les 2.6 Manage Downloads 3 Emule Network Notes

Download and Installation


There are several ways to obtain MLdonkey : download ready to run binaries for your OS/platform from main Downloads Page (http://sourceforge.net/projects/mldonkey/les/) install ready to run package with your package manager of choice download sources from main Downloads Page (http://sourceforge.net/projects/mldonkey/les/) and compile yourself (http://mldonkey.sourceforge.net /OcialFaq#Building_mldonkey) preinstalled with software appliance Note that installing precompiled versions of any software (not only mldonkey) from untrusted sources may pose a security risk for your system.

Install binaries
Ready to run ocial binaries (http://sourceforge.net/projects/mldonkey/les/) available for Windows, Linux, Mac OS X. More Download links.

Linux
Directly download mldonkey-3.0.6.static.i386-Linux_glibc-2.7.tar.bz2, then run
tar jxvf mldonkey-3.0.6.static.i386-Linux_glibc-2.7.tar.bz2

The binary le will be ok in the folder mldonkey-3.0.6.static.i386-Linux_glibc-2.7 You could type


cd mldonkey-3.0.6.static.i386-Linux_glibc-2.7

and run
./mlnet > /dev/null 2>&1 &

Then MLDonkey will be running as a daemon at the background.

Install package
Packages are prepared by distribution maintainers and provide easy way to manage software installation/upgrade. Packages usually dier slightly from ocial version in order to better integrate with other software and system as a whole (installation paths, user management, daemon launching, etc). General recipe is to search for mldonkey in package database, review selected package information and then install (and congure). You may need to enable additional package repositories to get the latest version.

Debian/Ubuntu
Use aptitude to install from ocial debian repository.
aptitude update apt-cache search mldonkey # aptitude search mldonkey aptitude install mldonkey-server

Red Hat/Fedora
Use yum to install from EPEL repository (https://fedoraproject.org/wiki/EPEL) .
yum search mldonkey yum info mldonkey-server yum install mldonkey-server

Gentoo
echo "net-p2p/mldonkey ~x86" >> /etc/portage/package.keywords emerge net-p2p/mldonkey

Compile from source


Usually :
tar -jxvf <filename.tar.bz2> cd mldonkey-<version> ./configure --enable-batch make

But have a look at the detailed instructions. Windows users should follow Windows specic instructions. Deal with CompilationProblems. After successful compilation install self-contained mlnet binary as appropriate (copy to /usr/local/bin or transfer to remote server or whatever).

Installation on NAS boxes and embedded


In order to install mldonkey on a Linux embedded system or Linux based NAS, you can: copy a precompiled core/les in a proper folder and execute use apt-get when you have a debian distribution or similar use a custom package management system, Modders add IPKG support to a lot of boxes, and some manufacters like QNAP uses their own QPKG. more details

Software appliance
A software appliance is a pre-packaged server that allows users to skip manual installation of MLDonkey and its dependencies, and instead deploy a self-contained, ready-to-use system that requires little to no setup. TurnKey Torrent Server (http://www.turnkeylinux.org/torrentserver) is a free MLDonkey-based le downloading and sharing appliance that combines MLDonkey for P2P le downloading, Samba for Windows-compatible le sharing and ClamAV for anti-virus scanning. It supports handling of all types of le downloads (torrent, e2dk, ftp, web, magnet). Files can be added to the download list using the Torrent Server handler (https://addons.mozilla.org/en-US/refox/addon/14043) extension for FireFox, or through a simple web interface (P2P-GUI) that allows you to manage the server remotely. You can get it up and running in minutes on bare metal (e.g., an old computer), a virtual machine (e.g., VMWare, VirtualBox), or in the cloud (Amazon EC2). http://www.turnkeylinux.org/torrentserver

Initial Setup and Usage


Once the daemon is running, connect to it as the admin user and change the password:
$ telnet 127.0.0.1 4000 Trying 127.0.0.1... Connected to 127.0.0.1. Escape character is '^]'. Welcome to MLDonkey 2.8.5 Welcome on mldonkey command-line Use ? for help MLdonkey command-line: > auth admin "" Full access enabled MLdonkey command-line: > passwd newpasswd Password of user admin changed MLdonkey command-line: >

Executing Mldonkey
You need to open a console(telnet... a command prompt) on the PC running mldonkey. In order to remotely access a Li/Unix device you need a telent/ssh application. Under Windows OS the best one telnet/ssh application is Putty (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) Unix's users should use the "ssh" command:
$ ssh username@192.168.0.45

"username" is the user on the remote computer where you like to execute mldonkey and 192.168.0.45 is the ctional address of the remote computer on which mldonkey is intended to run. Having a working console you can execute mldonkey with this command: $ mlnet this is nice to see things working but closing the ssh console could kill the mldonkey application. In case you like to execute mlnet in background unattended use this command and then you will be able to freely close the ssh shell: $ mlnet > /dev/null 2>&1 & More details about executing the application are collected in HowToStartMLdonkey.

Enabling Access
Having a running application doesn't suce, you need to enable access from remote location, for example you like to enable your local network to access mldonkey interfaces. By default mldonkey permits only local access from 127.0.0.1, and you need to add new authorized ranges. Let's log into the PC running mldonkey (look at previous "executing mldonkey") and connect to the core directly from there: $ telnet 127.0.0.1 4000 127.0.0.1 means the local machine and 4000 is the default port for the mldonkey's telnet interface.A new > prompt should appear to conrm your successfully connection. For example, having a local network 192.168.x.x, netmask 255.255.0.0, in order to permit access to all your local network you can use this command:
> set allowed_ips "127.0.0.1 192.168.255.255"

You can exit the interface using the command "quit"


> quit

More details about this topic: Allowed_ips

Conguration and tuning


Simple_conguration

Using Web Interface


In order to interact with MLDonkey, congure the application, search for les and manage downloads you have 3 ways telnet interface, very useful for script-based MLDonkey's control Web interface, the most complete interface wich permits the deep control of telnet interface with the easiness of a graphical interface. GUI interface Web interface is accessible using a web browser (Firefox, Explorer, Opera, Safari) and connecting to a "page" which is articialy created by MLDonkey in order to communicate to the user. Let's assume that you are accessing a remote computer running MLDonkey with IP address 192.168.0.45. Let's open your browser and write in the navigation/address bar. Simply write this address an press enter: http://192.168.0.45:4080

4080 is the default port for MLDonkey's web interface. Web interface works like a normal internet page, simply it permits to communicate with your MLDonkey in the same way you do with the normal emule application. In the upper bar you can see buttons which permits to access to the main MLDonkey's functions: Transfer: Opens a page with the current active downloads Search: Opens a page which permits to search for les

Statistics: ...statistics regarding MLDonkey operation Options: This is the place you are looking in order to congure MLDonkey, there are options for basic and advanced tuning. Help+: The place for help, documentations, command lists (Longhelp) There is also a eld which can be used the same way than telnet interface. In this eld, you can write the telnet commands in order to obtain particular operations. To enter a command, write it to this eld and either press enter or click 'Input' button. You can see a list of available commands with 'longhelp' command. Command's output will be visualized in the browser as well.

Searching for les


In a P2P network le searches are based on le name, le type, le size and other le details. In fact the le name usually reects the nature of the content. For example a le named my_birthday.avi is a movie about someone's birthday. Let's see a real situation: you would like to download a public domain movie, Dr.Jekyll and Mr. Hyde in the original version of the year 1920. I suggest to not put too much words in a search but to put the less number of words which helps to identify the content in a non-ambiguous way. In this case we can try with the words: Jekyll Hyde 1920.The search phase is visualized in the next sreenshots. Push the button search (1) to access the search page Input the le name and the type of the content (2) choosing from a menu. Push the Search button (3) in order to eectively launch the search. Click on search results (4) in order to visualize collected results. Search results depends from hour/day/luck. Waiting a few seconds before clicking 'Search results' button permits MLDonkey to collect more results.

In the next screenshot you have the search results panel: The second column is the name of the les which has matched your search criteria, the third column is the le size, and the fourth (A) is the estimated number of sources for this le. Every row (dierent colour) is a dierent le/result but you can note that the same le could appear in the network with dierent names. The le is recognized with a numerical way but every user is able to change the name based on his thoughts. Usually this is done in order to give a better description of the content or in order to correct name errors. Looking at the dierent names is a good way to estimate the quality of the content. Tips: The number of sources is the number of guys sharing that particular le. The greater the sources number -> hopefully smaller download time. But this is not for sure... ... so sometimes it is better to wait some time (several hours or days) in order to obtain a better le.

Usually for the same content there are dierent versions of les. The les are dierent because dierent MLDonkey users have converted the same resource in a shareable le format but doing dierent quality choices, size choices or using dierent software for conversion. I suggest to choose from the list the le which has the name most similar to the one you are looking for but with more "sources". I'll add a specic guide in order to do the best choices based on quality and resulting download speed. After choosing the le which ts your needs you have simply to click to the desired lename in order to start that download. Naturally you can start more than one download at one time.

Manage Downloads
Clicking on the Transfers button in the main menu you can access the transfers page. Here you can see the status of downloads, download progress, technical details about downloads and so on. You can also decide to Pause download, Resume download (continue a paused download), or Cancel downloads. To do this, toggle a selection box to the left side of the le name. The letter in the header shows what operation is selected (Pause, Resume or Cancel). After selecting the operation, click 'Submit changes' button. You can select operation for multiple les at a time. Clicking on the le row you'll see detailed information about a particular download.

Emule Network Notes


Mldonkey is a lesharing application which grant access to the wide Emule p2p network.The Emule ( aka eDonkey ) network is a big p2p which is sometimes wrongly compared with Bittorrent network. The main dierence between Emule network and Bittorrent network is the search and share paradigm. In the bittorrent network you need a bittorrent web site in order to search for les and you are bound to the trackers in order to share your les (you have to subscribe). The Emule's search engine is integrated in to the emule's compatible clients and all searches spread immediately far and wide all the network.So you need a unique place, your program interface, in order to look for les which result in a very quick and integrated way to search&donwload les. Emule network permits to simply share a le to all the world by simply moving the le in a shared folder. This is quite immediate and easy way to share things which you think worth spread. In fact common emule's users philosophy is: to share what is wothing based on quality and rarity to keep sharing valuable stu help the network by contributing with new content helping selecting les based on comments and le naming left client uploading as more as you can. If you embrace the Emule(Edonkey) network you'll join the most reach p2p network.Emule oers the widest range of rare, old and new content ranging from videos to music and programs. In detail: more than 4.000.000 users, extimation ranges between 4.000.000 and 8.000.000. les are shared and preserved, this is a network for new and old content both le corruption detection easy share and contribuite There are few suggestion about correct emule usage: Network freedom and decentralization is a great advantage but this also grants stupid guys to pollute changin' names to the les or releasing originally empty or useless les. This is quite important you read the guides about Emule network, so you 'll be able to correctly tune your client, set the correct server's lists and iplter for happy kademlia experience too. Reading this guide you'll learn the easy ways to search and download the right contents and you'll learn about avoiding the fake ones.It is quite simply as far you read&learn. Share a le with Emule is so simple and you have to be careful to not share a private le or a wrong folder cause a mistake. There is a last performance note: Usually Emule is a bit slower than bittorrent but this depends on the chosen les, it is suggested to launch more donwloads at once in order to optimize banwith usage and to left it run unattended.Choosing the right les to download is an art which is quite funny to learn. Good sharing, Good downloads don't forget to contribuite too.. ;-)

Languages: English Franais

Retrieved from "http://mldonkey.sourceforge.net/Quickstart_guide" This page was last modied on 2 January 2011, at 18:59. This page has been accessed 234,094 times.