Differences

This shows you the differences between two versions of the page.

--- doc:appunti:software:mldonkey_3_2_1 [2024/10/18 17:56] – [Initializing the server list] niccolo
+++ doc:appunti:software:mldonkey_3_2_1 [2024/10/22 12:45] (current) – [Initializing the Kademlia network] niccolo
@@ Line 70: / Line 70: @@
 FIXME Need to create the **/etc/logrotate.d/mldonkey-server** logrotate file.
+===== Opening the firewall =====
+The ports used by the program are declared in several configuration **.ini** files:
-===== Opening the firewall =====
+<code>
+downloads.ini: telnet_port = 4000
+downloads.ini: gui_port = 4001
+downloads.ini: http_port = 4080
-===== Initializing the server list =====
+# ED2k TCP port. The UDP port is TCP + 4.
+donkey.ini: port = 16566
-To start a client you need a list of servers **[[https://www.emule-security.org/serverlist/]]**
+donkey.ini: Kademlia = { port = 10709 }
+bittorrent.ini: tracker_port = 6881
+bittorrent.ini: client_port = 6882
+bittorrent.ini: dht_port = 16873
+</code>
+===== Using the Command Line Interface =====
 <code>
 telnet localhost 4000
 </code>
+<code>
+> auth admin MySecret
+Full access enabled
+</code>
+===== Initializing the server list =====
+As explaind into this [[https://www.emule-security.org/e107_plugins/faq/faq.php?0.cat.6.5|eMule FAQ]], you need a list of some servers to initialize your client to the **[[wp>EDonkey network]]**.
+The default URL used by MLDonkey to fetch the server list is **[[http://www.gruk.org/server.met.gz]]**, but it seems outdated now (October 2024). So we fetched the list from the URL provided by the FAQ: **[[http://upd.emule-security.org/server.met]]**.
+To change the source URL for **server.met**, edit the **downloads.ini** file while the program is stopped, and change the following part:
+<file>
+ web_infos = [
+  ("server.met", 0, "http://upd.emule-security.org/server.met");
+  ...
+</file>
+The number zero is the period between updates (in hours), a period of zero means the file is only loaded once on startup. The file will be fetched and stored into the **$HOME/.mldonkey/web_infos/** directory.
+Alternatively you can add single servers by hand: to view the servers listed by the emule-security.org site in an human-readable format, visit the URL **[[https://www.emule-security.org/serverlist/]]**; so you can view each IP address and port. You can manually add each server from the MLDonkey command line:
 <code>
@@ Line 88: / Line 125: @@
 ===== Initializing the Kademlia network =====
+FIXME It seems that the [[wp>Kademlia]] implementation of MLDonky is not compatible with e.g. the aMule 2.3.3 implementation (which is know as the [[wp>Kad network]]). See the **[[https://github.com/ygrek/mldonkey/issues/93|issue 93]]**.
+The implementation of Kademlia in MLDonkey was derived from the Overnet component. Overnet, which is now discontinued, was an attempt to enhance the [[wp>eDonkey2000]] program, to make it working without the use of central servers.
 As explained by this [[https://www.emule-security.org/e107_plugins/faq/faq.php?0.cat.6.6|eMule FAQ]], a list of some other users already connected to the Kademlia network can be downloaded here: **[[http://upd.emule-security.org/nodes.dat]]**.
@@ Line 120: / Line 161: @@
 ===== The GeoIP database =====
+MLDonkey uses a GeoIP database to show the country of servers and peers by the respective IP addresses. That database must be updated regularly, because IP assignments change over time. Unfortunately the default URL to download the database contained into the configuration file is outdated: [[http://www.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz]] returns a **404 Not Found** (October 2024).
+It seems that the GeoIP is a //discontinued legacy database//, but fortunately there is this site **[[https://mailfud.org/geoip-legacy/]]** that provides updated versions of it. The download URL is **[[https://mailfud.org/geoip-legacy/GeoIP.dat.gz]]**, but you cannot use it directly into the configuration file.
+If you set this in **download.ini**:
+<file>
+ (* WARNING: cannot use https URLs *)
+ web_infos = [
+  ("geoip.dat", 168, "https://mailfud.org/geoip-legacy/GeoIP.dat.gz");
+  ...
+</file>
+the MLDonkey program will try to connect the mailfud.org server on port TCP/0 instead of TCP/443. Specifying the port into the URL (e.g. **%%https://mailfud.org:443%%/...**) does not solve the problem because the HTTPS session does not start. I opened **[[https://github.com/ygrek/mldonkey/issues/119|issue 119]]**.
+Fortunately you can download the **GeoIP.dat.gz** file using your browser and copy it into the **$HOME/.mldonkey/web_infos/** directory; at the starting of the program it will be uncompressed and used.
+If you want the auto-update to work, you have to find (or host yourself) an **HTTP/1.0** server which provides that file.
 ===== Web References =====
@@ Line 127: / Line 187: @@
   * **[[https://medium.com/coinmonks/a-brief-overview-of-kademlia-and-its-use-in-various-decentralized-platforms-da08a7f72b8f|A Brief Overview of Kademlia]]**
   * **[[https://mailfud.org/geoip-legacy/|Free updated GeoIP legacy databases]]**
+  * **[[https://pages.di.unipi.it/ricci/A-performance-evaluation-of-the-Kad-protocol.pdf|A performance evaluation of the Kad protocol]]**