Difference between revisions of "Install-amule-freebsd"

From AMule Project FAQ
Jump to: navigation, search
 
(46 intermediate revisions by 17 users not shown)
Line 1: Line 1:
==  Installing official [[aMule]] ports  ==
+
<center>
 +
[[Install-amule-freebsd|English]] |
 +
[[Install-amule-freebsd-ru|Русский]] |
 +
[[Install-amule-freebsd-es|Espa&ntilde;ol]] |
 +
[[Install-amule-freebsd-it|Italiano]]
 +
</center>
  
The official port is ''/usr/ports/net/amule''
+
== Install aMule 2.2.4 on [http://www.freebsd.org FreeBSD] 6.X, 7.X ==
 +
Check that your /usr/ports is up-to-date, for example using portsnap:
 +
          portsnap fetch update
  
This is the stable version [[aMule]] 1.2.6
+
(you may need portsnap extract or portsnap fetch extract if not done before, you should be told at the end if this is necessary)
  
We wanna stay current? help testing / debugging: read how to install/compile aMule on your won in this article! Read below.
+
Then, as the ports tree has been updated to 2.2.4, you should be able to just
  
== Install [[aMule CVS]] on [http://www.freebsd.org FreeBSD] 5.3 ==
+
Install aMule
  
Make sure you have installed:
+
            cd /usr/ports/net/amule2
 +
            make config
 +
            make install clean
  
''/usr/ports/x11-toolkits/wxgtk2''
 
  
* Ignore the "problems" about [[wxGTK]]2 on [http://www.freebsd.org FreeBSD]. It works perfectly!
+
That should download and make all necessary dependencies etc.
  
Download the latest [[aMule CVS]] snapshot
+
But if that doesn't work you can try (should also be useful for a newer version of aMule then 2.2.4 and the cvs):
[http://www.amule.org/files/download.php?file=5 here].
+
  
(This article is tested with http://amule.hirnriss.net/cvs/aMule-cvs-20041215.tar.bz2)
 
  
''tar -zxvf aMule-cvs-20041215.tar.bz2''
 
  
''cd amule-cvs/''
+
Upgrade the FreeBSD 6.X (not needed on FreeBSD 7.X) flex release (2.5.4) with the new one (2.5.35):
  
''./configure --prefix=~/amule-cvs/
+
            cd  /usr/ports/textproc/flex
--with-wx-config=/usr/X11R6/bin/wx-config
+
            make install clean
--with-wxbase-config=/usr/X11R6/bin/wx-config
+
--disable-debug --with-curl-config=/usr/local/bin/curl-config
+
--enable-optimize --x-libraries=/usr/X11R6/lib
+
--x-includes=/usr/X11R6/include --localstatedir=/usr/X11R6/share/gnome
+
--datadir=/usr/X11R6/share/gnome --with-html-dir=/usr/X11R6/share/doc
+
--with-crypto-prefix=/usr/local --with-included-gettext --disable-cas''
+
  
''gmake''
+
This installation didn't override the old /usr/bin/, but put a new release on /usr/local/bin/.
  
''cd ~/amule-cvs/src/amule''
+
Then we need to rename the old flex release:
  
If you would like to compile/install [[aMule]] 2.0.0-rc7, you can follow the same instructions.
+
            mv /usr/bin/flex /usr/bin/flex.old
  
Greetz,
+
And check your version with this command:
Martin
+
  
[mailto://amule@air-maxx.net amule@air-maxx.net]
+
            flex --version
  
== Manual compilation ==
+
You should obtain: 2.5.35 (or newer)
  
Follow this guide to compile [[aMule]] on your [http://www.freebsd.org FreeBSD] system.
+
Install wxgtk28:
  
===  Requirements ===
+
            cd /usr/ports/x11-toolkits/wxgtk28-unicode/
 +
            make install clean
  
Install this ports if you don't already have them installed (see ''pkg_info''), since they are needed to compile [[aMule]]:
+
Install cryptopp:
  
''x11-toolkits/wxgtk''
+
            cd /usr/ports/security/cryptopp
 +
            make install clean
  
If you are installing any [[aMule]] version between 2.0.0-rc1 and 2.0.0-rc5 (inclusive), you will also need ''security/cryptopp''
+
Install GD:
  
Also (but you will have these already ;-)) ''devel/gettext'' and ''devel/gmake''
+
            cd /usr/ports/graphics/gd
 +
            make install clean
  
You know how to install ports as a [http://www.bsd.org BSD] user, so I don't have to tell you, I hope. It's just too easy you know. In case you're very new to [http://www.freebsd.org FreeBSD], consult the great [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook handbook] at [http://www.freebsd.org http://www.freebsd.org].
+
Install GeoIP:
  
'''NOTE:''' If you think you have [[wxWidgets|wxGTK]] installed because you see [[wxWidgets|wxGTK2]], you should know, [[wxWidgets|wxGTK]] is linked against [http://www.gtk.org GTK1] and [[wxWidgets|wxGTK2]] is linked against [http://www.gtk.org GTK2]. Using [[wxWidgets|wxGTK2]] with [[aMule]] might become [[aMule]] unstable! You should use [[wxWidgets|wxGTK]], not [[wxWidgets|wxGTK2]].
+
            cd /usr/ports/net/GeoIP/
 +
            make install clean
  
===  Configure  ===
+
Download the aMule 2.2.4 source code
 +
[http://www.amule.org/files/files.php?cat=42 here].
  
(Tested with  [http://www.freebsd.org FreeBSD] 5.2-CURRENT 03-May-2004)
+
            tar -zxvf aMule-2.2.4.tar.bz2
 +
            cd aMule-2.2.2/
  
The ''./configure'' does not work 100% automagically, we must help it out a bit.
+
You need to edit the file src/Scanner.l and after the line:
 +
            #include <wx/string.h>
 +
Add the line:
 +
            #include "Scanner.h.in"
  
Edit the '''<your home>''' tag, of course, or install it elsewhere.
+
Configure some environement variable, for bash user:
 +
            export CPPFLAGS="-I/usr/local/include"
 +
            export LDFLAGS="-L/usr/local/lib"
 +
Or for csh user (default under FreeBSD):
 +
            setenv CPPFLAGS "-I/usr/local/include"
 +
            setenv LDFLAGS "-L/usr/local/lib"
 +
Then start the compilation:
 +
           
 +
            ./configure --prefix=/home/'''user'''/aMule-2.2.4/ \
 +
            --with-wx-config=/usr/local/bin/wxgtk2u-2.8-config --with-crypto-prefix=/usr/local/ \
 +
            --disable-debug --with-curl-config=/usr/local/bin/curl-config --enable-webserver  \
 +
            --enable-optimize --with-included-gettext --enable-amule-daemon --enable-amulecmd \
 +
            --enable-cas --enable-alcc --enable-geoip
  
''./configure --prefix=/home/'''<your home>'''/amule --with-wx-config=/usr/X11R6/bin/wxgtk-2.4-config --with-wxbase-config=/usr/X11R6/bin/wxgtk-2.4-config''
+
'''NOTE:''' Check [[configure]]. Also, change '''user''' for your user name.
  
'''NOTE:''' This is one single line, not 3 lines or whatever [http://wiki.org/wiki.cgi?WhatIsWiki wiki]/HTML/your browser wraps this line into.
+
            gmake
 +
            gmake install
  
You will see configure doesn't find ''gdlib-config'', even if you installed ''gdlib''. Don't care, it's just not there and it's no "must have". Just skip it.
+
And start it:
 +
          ./amule-2.2.4/bin/amule &
  
'''NOTE:''' If you get the following warning:
 
  
''WARNING!! Your wxWidgets copy has been linked against GTK2 and this will make aMule be unstable, use so much cpu and ram. You have been advised, don't report bugs so.''
+
== Configuration info ==
  
at the end of ''configure'' you are probably linking against [[wxWidgets|wxGTK2]] instead of [[wxWidgets|wxGTK]]. [[aMule]] will memleak and eat your CPU. It will probably crash as well. Use [[wxWidgets|wxGTK]] as mentioned above!
+
After successfully installing:
  
===  Make  ===
+
The program directory can be found: (~./aMule/). Means as root:
  
''make'' will fail, use ''gmake''
+
/root/.aMule/
  
''make'' is [http://www.bsd.org BSD] [http://www.gnu.org/software/make make], ''gmake'' is [http://www.gnu.org GNU] [http://www.gnu.org/software/make make]. They are '''not''' compatible.
+
any other user:
  
Now do:
+
/usr/home/<username>/.aMule/
  
''gmake''
+
amule.conf can be found directly in the program folder. The webserver config file has to be made:
  
Get yourself a hot green tea (I prefer some sort of sencha) while it is compiling.
+
# amuleweb -w.
  
Then do:
+
and is called remote.conf
 
+
''gmake install''
+
 
+
===  Use it  ===
+
 
+
Just start it with ''/home/<your home>/amule/bin/amule''
+
or wherever you installed it to...
+
 
+
Have phun
+
 
+
Eugene
+
 
+
== The [[aMule]] 2.0.0-rc7 port ==
+
 
+
Hi all, the rc7 port is now available on my website:
+
http://contribs.martymac.com
+
 
+
I've also added binaries for those who don't want to spend time to compile. The port works on [http://www.freebsd.org FreeBSD] 4.10 and 5.2.1. Any feedback welcome. I've changed some options to the Makefile: amule-ed2k-handler is now amule-ed2k, and cmd+GUI options are now joined in global ones. Do a "make config" prior to the "make install" to update your config file.
+
 
+
Enjoy :)
+
 
+
Ganael LAPLANCHE
+
 
+
http://contribs.martymac.com
+
 
+
[mailto://ganael.laplanche@martymac.com ganael.laplanche@martymac.com]
+
 
+
== The [[aMule]] 2.0.0-rc6 port ==
+
 
+
Visit http://www.amule-project.net/amule/thread.php?threadid=3758 and do as it says ;-)
+
 
+
== The [[aMule]] 2.0.0-rc4a ports ==
+
+
Hi all, new update to this wiki: 2.0.0rc4a ports are available. No, you ain't dreaming, you've just seen an 's' appended, because there are two ports.
+
 
+
Unfortunately, [http://www.freebsd.org FreeBSD] 4.x (and [http://gcc.gnu.org GCC] 2.95) doesn't provide some required libs (see the patches inside the archive) to build this brand-new [[aMule]] version, so I released two ports :
+
 
+
*One for the 4.x branch, which won't compile under 5.x:
+
Includes many patches, sometimes tricky, to make it work. This could lead to unstability and require further testing. Any feedback is welcome :)
+
 
+
*Another one for the 5.x branch, wich won't compile under 4.x:
+
This one doesn't include any patch.
+
 
+
To download the ports: http://www.amule.org/amule/download.php or http://contribs.martymac.com
+
 
+
Enjoy!
+
 
+
Ganael LAPLANCHE
+
 
+
http://contribs.martymac.com
+
 
+
[mailto://ganael.laplanche@martymac.com ganael.laplanche@martymac.com]
+
 
+
== The [[aMule]] 2.0.0-rc3 port ==
+
 
+
I've just released the 2.0.0rc3 port.
+
 
+
See http://www.amule.org/amule/download.php (and http://contribs.martymac.com) to download it.
+
 
+
== Installing non-official ports ==
+
 
+
If you download a port which is not officially available, you'll have to uncompress it (''tar xvzf file.tgz'') into the ''/usr/ports/net'' directory and then do a standard ''make install''.
+
 
+
Any feedback welcome, many thanks to Eugene for this great wiki :)
+
 
+
Ganael Laplanche.
+
 
+
== Compilation problems ==
+
 
+
If you still can't compile [[aMule]] see if the following patches work.
+
 
+
=== Patch 1 ===
+
 
+
The problem would be:
+
 
+
''<pre>[...]
+
/usr/bin/ld: cannot find -lcryptopp
+
gmake[2]: *** [cas] Error 1
+
gmake[2]: Leaving directory `/home/eugene/aMule-2.0.0rc3/src'
+
gmake[1]: *** [all-recursive] Error 1
+
gmake[1]: Leaving directory `/home/eugene/aMule-2.0.0rc3'
+
gmake: *** [all] Error 2</pre>''
+
 
+
So we patch it now:
+
 
+
''edit src/Makefile''
+
 
+
Search for the line containing
+
 
+
''cryptopp''
+
 
+
This line will read as:
+
 
+
''LIBS = -lcryptopp''
+
 
+
Add ''-L/usr/local/lib'' to that line
+
 
+
Now the line will read as:
+
 
+
''LIBS = -L/usr/local/lib -lcryptopp''
+
 
+
=== Patch 2 ===
+
 
+
The problem would be:
+
 
+
''<pre>[...]
+
amule.cpp:39:30: execinfo.h: No such file or directory
+
amule.cpp:40:28: mntent.h: No such file or directory
+
In file included from /usr/local/include/cryptopp/pkcspad.h:4,
+
from /usr/local/include/cryptopp/rsa.h:9,
+
from ClientCredits.h:32,
+
from amule.cpp:86:
+
/usr/local/include/cryptopp/cryptlib.h:1358:9: warning: "/*" within comment
+
amule.cpp: In member function `virtual bool CamuleApp: nInit()':
+
amule.cpp:423: error: `setmntent' undeclared (first use this function)
+
amule.cpp:423: error: (Each undeclared identifier is reported only once for
+
each function it appears in.)
+
amule.cpp:429: error: `getmntent' undeclared (first use this function)
+
amule.cpp:431: error: invalid use of undefined type `struct mntent'
+
amule.cpp:427: error: forward declaration of `struct mntent'
+
amule.cpp:432: error: invalid use of undefined type `struct mntent'
+
amule.cpp:427: error: forward declaration of `struct mntent'
+
amule.cpp:437: error: invalid use of undefined type `struct mntent'
+
amule.cpp:427: error: forward declaration of `struct mntent'
+
amule.cpp: In member function `virtual void CamuleApp: nFatalException()':
+
amule.cpp:982: error: `backtrace' undeclared (first use this function)
+
amule.cpp:987: error: `backtrace_symbols' undeclared (first use this function)
+
gmake[2]: *** [amule-amule.o] Error 1
+
gmake[2]: Leaving directory `/home/eugene/aMule-2.0.0rc3/src'
+
gmake[1]: *** [all-recursive] Error 1
+
gmake[1]: Leaving directory `/home/eugene/aMule-2.0.0rc3'
+
gmake: *** [all] Error 2</pre>''
+
 
+
So we patch it now:
+
 
+
As there is no official [http://www.freebsd.org FreeBSD] support in [[aMule]] yet we will patch it to work... Well there is [http://www.openbsd.org OpenBSD] support and this support will work for us too :-)
+
 
+
Edit ''src/amule.cpp''
+
 
+
and insert
+
 
+
''#define __OPENBSD__''
+
 
+
at the top of this file. I placed it right before the first ''#include'' line...
+
 
+
"What a workaround!" you may scream. Hey, we don't fiddle too much around with the code, just hack it to work and get ready to share ;-)
+

Latest revision as of 18:13, 8 February 2010

English | Русский | Español | Italiano

Install aMule 2.2.4 on FreeBSD 6.X, 7.X

Check that your /usr/ports is up-to-date, for example using portsnap:

          portsnap fetch update

(you may need portsnap extract or portsnap fetch extract if not done before, you should be told at the end if this is necessary)

Then, as the ports tree has been updated to 2.2.4, you should be able to just

Install aMule

           cd /usr/ports/net/amule2
           make config
           make install clean


That should download and make all necessary dependencies etc.

But if that doesn't work you can try (should also be useful for a newer version of aMule then 2.2.4 and the cvs):


Upgrade the FreeBSD 6.X (not needed on FreeBSD 7.X) flex release (2.5.4) with the new one (2.5.35):

           cd  /usr/ports/textproc/flex
           make install clean

This installation didn't override the old /usr/bin/, but put a new release on /usr/local/bin/.

Then we need to rename the old flex release:

           mv /usr/bin/flex /usr/bin/flex.old

And check your version with this command:

           flex --version

You should obtain: 2.5.35 (or newer)

Install wxgtk28:

           cd /usr/ports/x11-toolkits/wxgtk28-unicode/
           make install clean

Install cryptopp:

           cd /usr/ports/security/cryptopp
           make install clean

Install GD:

           cd /usr/ports/graphics/gd
           make install clean

Install GeoIP:

           cd /usr/ports/net/GeoIP/
           make install clean

Download the aMule 2.2.4 source code here.

           tar -zxvf aMule-2.2.4.tar.bz2
           cd aMule-2.2.2/

You need to edit the file src/Scanner.l and after the line:

           #include <wx/string.h>

Add the line:

           #include "Scanner.h.in"

Configure some environement variable, for bash user:

           export CPPFLAGS="-I/usr/local/include"
           export LDFLAGS="-L/usr/local/lib"

Or for csh user (default under FreeBSD):

           setenv CPPFLAGS "-I/usr/local/include"
           setenv LDFLAGS "-L/usr/local/lib"

Then start the compilation:

           ./configure --prefix=/home/user/aMule-2.2.4/ \
           --with-wx-config=/usr/local/bin/wxgtk2u-2.8-config --with-crypto-prefix=/usr/local/ \
           --disable-debug --with-curl-config=/usr/local/bin/curl-config --enable-webserver  \
           --enable-optimize --with-included-gettext --enable-amule-daemon --enable-amulecmd \
           --enable-cas --enable-alcc --enable-geoip

NOTE: Check configure. Also, change user for your user name.

           gmake
           gmake install

And start it:

          ./amule-2.2.4/bin/amule &


Configuration info

After successfully installing:

The program directory can be found: (~./aMule/). Means as root:

/root/.aMule/

any other user:

/usr/home/<username>/.aMule/

amule.conf can be found directly in the program folder. The webserver config file has to be made:

  1. amuleweb -w.

and is called remote.conf