Difference between revisions of "Compilation Installation"

From AMule Project FAQ
Jump to: navigation, search
(tar -zxvf to untar a tar.gz file)
(47 intermediate revisions by 20 users not shown)
Line 1: Line 1:
 
<center>
 
<center>
'''English''' | [[Compilation_Installation-fr|Français]] | [[Compilation_Installation-nl|Nederlands]] | [[Compilation_Installation-br|Português]]
+
[[Compilation_Installation|English]] |  
 +
[[Compilation_Installation-de|Deutsch]] |
 +
[[Compilation_Installation-es|Espa&ntilde;ol]] |
 +
[[Compilation_Installation-fr|Fran&ccedil;ais]] |  
 +
[[Compilation_Installation-it|Italiano]] |
 +
[[Compilation_Installation-nl|Nederlands]] |  
 +
[[Compilation_Installation-pl|Polish]] |
 +
[[Compilation_Installation-br|Português]] |
 +
[[Compilation_Installation-ru|Russian]]
 
</center>
 
</center>
  
== Manual Installation ==
+
== Compiling from Sources ==
 +
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you continue have problems, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.
  
To install aMule you can either install it from scratch, as described in '''Compiling From Sources''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.
+
There are different versions of the wxWidgets for different platforms. wxGTK is used for Linux, Solaris and BSD, wxMSW for Windows and wxMac for Mac OS X. Here we'll explain the compilation using wxGTK, but it differs only slightly for other toolkits.
  
 +
Please see the specific articles for more detailed instructions.
 +
*[[HowTo_compile_on_Mac|Compile aMule on Mac]]
 +
*[[HowTo compile on Win32|Compile aMule on Windows]]
  
'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of [[libcrypto|Crypto++]] newer than 5.1. Starting with 2.0.0-rc6, you don't even need Crypto++.
+
=== Step 1: [[wxWidgets]] ===
 +
*Download [[wxWidgets]]: [http://prdownloads.sourceforge.net/wxwindows/wxWidgets-2.8.10.tar.gz wxWidgets-2.8.10.tar.gz]
  
== Compiling From Sources ==
+
*Compile [[wxWidgets]]
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.
+
**''tar -zxvf wxWidgets-2.8.10.tar.gz''
 +
**''cd wxWidgets-2.8.10''
 +
**''Linked against [http://www.gtk.org GTK]2: ./configure --enable-unicode --enable-optimise
 +
**''make''
  
'''NOTE:''' In [[wxWidgets]] >= 2.5.1, [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.x, skip the second step ([[wxBase]] compilation).
+
*As '''root''' (in some distributions simply use "sudo" before):
 
+
==== Step 1: [[wxWidgets|wxGTK]] ====
+
*download [[wxWidgets|wxGTK]] ->
+
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]
+
 
+
* compile [[wxWidgets|wxGTK]] ->
+
**''tar -zxvf wxGTK-2.4.2.tar.gz''
+
***''cd wxGTK-2.4.2''
+
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''
+
 
+
*as '''root''':
+
 
**''make install''
 
**''make install''
 
**''ldconfig''
 
**''ldconfig''
  
 +
==== Disable the GUI ====
 +
*To compile wxWidgets without a graphical User Interface, ''use the option --disable-gui''
  
==== Step 2: [[wxBase]] ====
+
=== Step 2: [[aMule]] ===
*download [[wxBase|wxBase]] ->
+
*Download the latest [[aMule SVN|source tarball]]: [http://amule.sourceforge.net/tarballs/tarballs.xml Download aMule]
**[http://download.berlios.de/amule/wxBase-2.4.2.tar.gz wxBase-2.4.2.tar.gz]
+
  
* compile [[wxBase]] ->
+
*Compile [[aMule]] (please check the [[configure|configure article]]) ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
+
**''cd wxBase-2.4.2''
+
**''./configure --prefix=/usr && make''
+
 
+
*as '''root''':
+
**''make install''
+
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
+
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
+
**''ldconfig''
+
 
+
 
+
==== Step 3: [[libcrypto|Crypto++]] ====
+
 
+
'''Note:''' Only needed from version 2.0.0-rc1 to 2.0.0-rc5 (included)
+
 
+
*download [[libcrypto]]++ ->
+
**[http://download.berlios.de/amule/crypto-5.2.1.tar.bz2 crypto-5.2.1.tar.bz2]
+
 
+
*compile [[libcrypto]]++ ->
+
**''tar xvjf crypto-5.2.1.tar.bz2''
+
**''cd crypto-5.2.1''
+
**''make''
+
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
+
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
+
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).
+
 
+
*as '''root''':
+
:On earlier [[libcrypto]]++ versions, running ''make install'' would be enough. Since [[libcrypto]]++ 5.2 this is no longer available. So do the following:
+
 
+
:*''cp libcryptopp.a /usr/lib/''
+
:*''mkdir /usr/include/cryptopp''
+
:*''cp *.h /usr/include/cryptopp/''
+
:*''ldconfig''
+
 
+
==== Step 4: [[aMule]] ====
+
*download latest [[aMule]] version ->
+
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
+
 
+
* compile [[aMule]] (please check the [[configure|configure article]]) ->
+
 
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
 
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
 
**''cd aMule-X.X.X''
 
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimise && make''
+
**''./configure --disable-debug --enable-optimize''
 +
**''make''
  
*as '''root''':
+
*As '''root''' (in some distributions simply use "sudo" before):
 
**''make install''
 
**''make install''
  
*run [[aMule]] as user from your console by typing -> ''amule''
+
*Run [[aMule]] as a regular user from console by typing ''amule'', or run [[aMule]] through a link from the proper application menu of your operating system
 
+
 
+
 
+
== Installing using RPMs ==
+
 
+
 
+
==== Step 1: [[wxWidgets|wxGTK]] ====
+
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
+
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]&nbsp;&nbsp; [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]
+
 
+
* install [[wxWidgets|wxGTK]] ->
+
**as '''root''':
+
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
+
***''ldconfig''
+
 
+
 
+
 
+
==== Step 2: [[wxBase]] ====
+
*download [[wxBase]] ->
+
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]
+
 
+
*install [[wxBase]] ->
+
**as '''root''':
+
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
+
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
+
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
+
***''ldconfig''
+
 
+
 
+
==== Step 3. [[libcrypto|Crypto++]] ====
+
 
+
'''Note:''' Only needed from version 2.0.0-rc1 to 2.0.0-rc5 (included)
+
 
+
*download [[libcrypto]]++ ->
+
**[http://www.redhat.com RedHat] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.2.1-1.i586-RH-SuSE.rpm libcryptopp-5.2.1-1.i586-RH-SuSE.rpm] and  [http://download.berlios.de/amule/libcryptopp-devel-5.2.1-1.i586-RH-SuSE.rpm libcryptopp-devel-5.2.1-1.i586-RH-SuSE.rpm]
+
**[http://fedora.redhat.com FC]: [http://download.berlios.de/amule/libcryptopp-5.2.1-1.i586-FC.rpm libcryptopp-5.2.1-1.i586-FC.rpm] and  [http://download.berlios.de/amule/libcryptopp-devel-5.2.1-1.i586-FC.rpm libcryptopp-devel-5.2.1-1.i586-FC.rpm]
+
**[http://www.mandrake.com MDK]: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and  [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
+
*as '''root''':
+
**''rpm -Uvh the-above-downloaded-package.rpm''
+
 
+
==== Step 4: [[aMule]] ====
+
*download latest [[aMule]] version ->
+
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
+
 
+
* install [[aMule]] ->
+
**as '''root''':
+
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)
+
 
+
* run [[aMule]] as user from your console by typing -> ''amule''
+

Revision as of 14:56, 20 September 2009

English | Deutsch | Español | Français | Italiano | Nederlands | Polish | Português | Russian

Compiling from Sources

WARNING: Make sure you have no copies of wxWidgets installed. If you already have wxWidgets installed, check How to uninstall wxWidgets before starting a new installation. If you continue have problems, then check if wx is installed twice, since that's a common compilation and runtime problem.

There are different versions of the wxWidgets for different platforms. wxGTK is used for Linux, Solaris and BSD, wxMSW for Windows and wxMac for Mac OS X. Here we'll explain the compilation using wxGTK, but it differs only slightly for other toolkits.

Please see the specific articles for more detailed instructions.

Step 1: wxWidgets

  • Compile wxWidgets
    • tar -zxvf wxWidgets-2.8.10.tar.gz
    • cd wxWidgets-2.8.10
    • Linked against GTK2: ./configure --enable-unicode --enable-optimise
    • make
  • As root (in some distributions simply use "sudo" before):
    • make install
    • ldconfig

Disable the GUI

  • To compile wxWidgets without a graphical User Interface, use the option --disable-gui

Step 2: aMule

  • Compile aMule (please check the configure article) ->
    • tar -zxvf aMule-X.X.X.tar.gz (replace X with the right version number..)
    • cd aMule-X.X.X
    • ./configure --disable-debug --enable-optimize
    • make
  • As root (in some distributions simply use "sudo" before):
    • make install
  • Run aMule as a regular user from console by typing amule, or run aMule through a link from the proper application menu of your operating system