View source for Migrate from eMule to aMule

<h1 style="text-align: center;">Migrate
from eMule to aMule</h1>
<div style="text-align: left;"><span
 style="font-style: italic;">Sandro
Tosi, 22 August
2005<br>
</span>
<hr
 style="height: 2px; width: 50%; margin-left: 0px; margin-right: auto;"></div>
<p style="text-align: justify;">Here
you'll find some tips about the
migration of configuration &amp; download files from eMule (read
Windows) to aMule (read Linux).</p>
<h3 style="text-align: left;">1.
Brief history</h3>
<p><a
 href="http://www.edonkey.com/">EDonkey</a>
born some years ago
and its great protocol takes itself into the Olympo of file sharing
programs.</p>
<p>Some coders, unsatisfied by
that client, starts developing a new one, called <a
 href="http://www.emule-project.net/">eMule</a>.
Its
source code is open, so anyone (able...) can read it and modify it, and
so was. Many client versions came up with patch and new code. Fastly,
the EDonkey guys starts arguing against eMule, blaming that the p2p
network goes constantly slower due to the large number of eMule
clients. After an initial study phase, eMule developers decided to
create a new p2p network leaving EDonkey net alone. It was a success.</p>
<p>The Linux community starts
developing a Linux client able to connect
to eMule network: <a
 href="http://www.xmule.ws/">xMule</a>
is born. A
multi p2p network program, <a
 href="http://mldonkey.berlios.de/">MLdonkey</a>
added the support to eMule network; even another client came out, <a
 href="http://mldonkey.berlios.de/">lmule</a>.
But the winner has yet
to come...</p>
<p>xMule got few coders but a
project starts rumping up: try to port
the changes from eMule to a Linux client: <a
 href="http://www.amule.org/">aMule</a>
was born. This fastly became
the de facto standard enkey client for Linux.</p>
<p> EDonkey is now almost dead,
and wants even to be payed for a
professional version of its client...</p>
<h4>1.1. Migration</h4>
<p>Searching around the web you
will find a lot of people saying the
migration is easy: do not believe them! ;) Or better, it's easy because
temporary file format is compatible, but if we are talking about
configurations files, then the things change.</p>
<p>Below follow my notes about the
migration from eMule to aMule of all
my downloads.</p>
<h3>2. Configuration Files</h3>
<p>There are two important parts
in eMule: the configuration files and
temp/shared files. Let's start with configuration files.</p>
<p>In eMule, these files are store
under <span style="font-style: italic;">config</span>
directory. In aMule,
instead, the configuration files are store under <span
 style="font-style: italic;">~/.aMule</span>
directory. So the easy
step is copy the files from the configuration directory of eMule to the
one of aMule. Good, so let's look further...</p>
<h4>2.1. Configuration Files
Automatically Imported</h4>
<p>Many files are read and
correctly imported into aMule; from them we
can find:</p>
<ul style="list-style-type: circle;">
  <li><span
 style="font-style: italic;">clients.met</span>,
stores the other clients credits. When you download some from a client,
you'll store
in this file how much have you get, so you could promote that client
when it will be in your upload queue;</li>
  <li><span
 style="font-style: italic;">known.met</span>,
it's where
were stored the downloaded files, the ones printed in green when
searched
again (I really don't know what contains the <span
 style="font-style: italic;">known2.met</span>
eMule files...);</li>
  <li><span
 style="font-style: italic;">server.met</span>,
it contains
the saved eMule servers;</li>
  <li><span
 style="font-style: italic;">ipfilter.dat</span>
and <span style="font-style: italic;">ipfilter_static.dat</span>,
which contain
the IP denied to connect/share files with you;</li>
  <li><span
 style="font-style: italic;">emfriends.met</span>,
it
contains the friends list;</li>
  <li><span
 style="font-style: italic;">criptkey.dat</span>
and <span style="font-style: italic;">preferences.dat</span><span
 style="font-style: italic;"></span><span
 style="font-style: italic;"></span><span
 style="font-style: italic;"></span>:
they&nbsp;uniquely identify&nbsp;you for other clients, so you
can keep credits to their side;</li>
  <li>other files: <span
 style="font-style: italic;">key_index.dat</span>,
    <span style="font-style: italic;">load_index.dat</span>,
    <span style="font-style: italic;">nodes.dat</span>,
    <span style="font-style: italic;">preferences.dat</span>,
    <span style="font-style: italic;">preferencesKad.dat</span>,
    <span style="font-style: italic;">shareddir.dat</span>
and <span style="font-style: italic;">src_index.dat</span>;&nbsp;I
don't know
what's written inside, but I think some are Kademlia related (but they
were written running aMule, so I suppose they are used...).</li>
</ul>
<p>This were the good news, the
bad ones have still to come...</p>
<h4>2.2. Configuration Files NOT
Automatically Imported</h4>
<p>Here start the "war bulletin":</p>
<ul style="list-style-type: circle;">
  <li>configuration file: eMule
uses <span style="font-style: italic;">preferences.ini</span>
but aMule uses <span
 style="font-style: italic;">amule.conf</span>;</li>
  <li>categories: they are the
tabs separating files in the download
list; in eMule they are written in the file <span
 style="font-style: italic;">Category.ini</span>
but aMule writes them
down into <span style="font-style: italic;">amule.conf</span>;</li>
  <li>some files in eMule config
directory seems not to be used by
aMule: <span style="font-style: italic;">AC_BootstrapIPs.dat</span>,
    <span style="font-style: italic;">AC_IPFilterUpdateURLs.dat</span>,
    <span style="font-style: italic;">AC_SearchStrings.dat</span>,
    <span style="font-style: italic;">AC_ServerMetURLs.dat</span>,
    <span style="font-style: italic;">adresses.dat</span>,&nbsp;<span
 style="font-style: italic;"></span><span
 style="font-style: italic;"></span><span
 style="font-style: italic;">fileinfo.ini</span>,
    <span style="font-style: italic;">k_index.dat</span>,&nbsp;<span
 style="font-style: italic;"></span><span
 style="font-style: italic;">preferencesK.dat</span>,
    <span style="font-style: italic;">s_index.dat</span>,
    <span style="font-style: italic;">staticservers.dat</span>,
    <span style="font-style: italic;">statistics.ini</span>
and <span style="font-style: italic;">webservices.dat</span>.
I don't know their
function under eMule and maybe some of the above files come from old
eMule installations and know their are not used anymore even by eMule.</li>
</ul>
<p>Further you'll find how I've
imported the missing configurations.</p>
<h3>3. Importing Missing
Configurations</h3>
<p>We have just said that some
configurations are not automatically
loaded into aMule from eMule; try to find out what
we can do to import those data into aMule.</p>
<h4>3.1. Importing Categories</h4>
<p>This command line should help
you generate the categories
information from eMule <span
 style="font-style: italic;">Category.ini</span>
file (put the commando&nbsp;on the same line):</p>
<p style="margin-left: 40px;"><span
 style="font-family: monospace;">$
grep -E "^\[Cat|^Title|^Incoming|^Comment|^Color|^a4afPriority"
Category.ini | sed 1,6d | sed 's/#/\\#/g' | sed
's/&amp;/\\&amp;/g' |
sed 's/a4afPriority/Priority/g'</span></p>
<p>this escapes even # and
&amp; characters, because I've got in my <span
 style="font-style: italic;">Category.ini</span>
file; maybe there will
be other chars to be escaped that have to included in the script (let
me know, in this case). The script deletes the first 6 rows, that is
the
first category, since it's a dummy one: that category is the first one
in eMule, which contains all/uncategorized/etc files; aMule has its
"all" tab and do not need this entry. Cut&amp;paste the script
result
into <span style="font-style: italic;">amule.conf</span>.</p>
<p>Under <span
 style="font-family: monospace;">[General]</span>
of <span style="font-style: italic;">amule.conf</span>,
you have to define a
variable <span
 style="font-family: monospace;">count</span>
(or change
its value if already defined) with value:</p>
<p style="margin-left: 40px;"><span
 style="font-family: monospace;">$
echo `grep -c "^\[Cat" Category.ini` -1 | bc</span></p>
<p>this variable holds the number
of tabs to display: note that even if you have
imported 10 categories, but leave <span
 style="font-family: monospace;">count=1</span>,
only one category will be displayed.</p>
<p>At the end, the categories
configuration in amule.conf should look
like:</p>
<p style="margin-left: 40px;"><span
 style="font-family: monospace;">[General]</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Count=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">[Cat\#1]</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Title=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Incoming=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Comment=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Color=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Priority=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">[Cat\#2]</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Title=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Incoming=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Comment=</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Color=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">Priority=...</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">...</span></p>
<p>I don't know if importing the
categories before importing the temp
files, they will be classified as in eMule; I've imported temp files
before the categories, but I don't think they will be placed in the
tabs as they were in eMule (if someone can confirm this...).</p>
<h4>3.2. Importing Statistics</h4>
<p>eMule statistics are available
in two distinct files: <span
 style="font-style: italic;">preferences.ini</span>
and <span style="font-style: italic;">statistics.ini</span>.
I found statistics in the latter file&nbsp;more up-to-date than the
ones
in the former file.</p>
<p>Looking into <span
 style="font-style: italic;">statistics.ini</span>
you'll find that all statistics are under <span
 style="font-family: monospace;">[Statistics]</span>
tag. Even inside <span
 style="font-style: italic;">amule.conf</span>
there exists this tag, so the logic conclusion is to copy from <span
 style="font-style: italic;">statistics.ini</span>
to <span style="font-style: italic;">amule.conf</span>.
In this last file, there are two keys, <span
 style="font-family: monospace;">MaxClientVersions</span>
and <span style="font-family: monospace;">DesktopMode</span>,
that should not be deleted (I don't know what they mean, so leave them
where they are...).</p>
<p>Sadly, very few values get
imported: seems only downloaded and uploaded bytes. Maybe it's not the
right place where I've written those keys, or maybe aMule uses other
ones. Only using aMule will reveal it...</p>
<h4>3.4. Other configurations
</h4>
<p>Configurations not yet imported
are the program strictly ones. They are, for example, about the TCP and
UDP port to use, Incoming and Temp directories, network limits and so
on.</p>
<p>Since they are very
client-specific and important for its correct
behavior, I suggest to redefine them by the <span
 style="font-style: italic;">Preferences</span>
aMule form. Maybe it
would be long and boring, but done it once, they will last forever,
almost... </p>
<p>If you're a real brave guy, you
can try to import directly some keys
from <span style="font-style: italic;">preferences.ini</span>
to <span style="font-style: italic;">amule.conf</span>,
but then do not argue
it won't work anymore...</p>
<h3>4. Temporary &amp; Sharing
Files</h3>
<p>Temporary files are compatible
between eMule and aMule, so you only
have to set the Temp dir inside aMule (and let it rehash all files) to
have them newly available to download.</p>
<p>For sharing files we have very
few things to do: since they are
already downloaded, the only thing to do is say to aMule where they are
and waiting for rehashing.</p>
<h3>5. At the end...</h3>
<p>Those are the steps I've
followed to migrate from eMule to aMule;
something maybe wrong, and something maybe could be do better, so let
me know any correction/ideas/addition come to your mind.</p>