Building MTASA Server on GNU Linux: Difference between revisions
No edit summary |
|||
Line 5: | Line 5: | ||
In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution. | In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution. | ||
Our network module is distributed as a precompiled binary library. The | Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from [http://nightly.mtasa.com/ here]. Use the net.so from 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of ''MTA10_Server/version.h'' as it contains directions on how to compile the different build types. | ||
Line 23: | Line 23: | ||
* '''libsqlite3-dev:''' contains the SQLite library (version 3) | * '''libsqlite3-dev:''' contains the SQLite library (version 3) | ||
* '''libreadline5-dev:''' contains the readline library (version 5) | * '''libreadline5-dev:''' contains the readline library (version 5) | ||
* '''subversion:''' contains the | * '''subversion:''' contains the SVN client used to check out our code repository | ||
To install these packages through apt, use the apt-get install <package list> command as in the following example (executed as root): | To install these packages through apt, use the apt-get install <package list> command as in the following example (executed as root): | ||
Line 37: | Line 37: | ||
* '''sqlite:''' contains the SQLite library | * '''sqlite:''' contains the SQLite library | ||
* ''' | * '''subversion:''' contains the SVN client used to check out our code repository | ||
* '''curl:''' contains the cURL library; to compile with SSL support, apply the net-misc/curl ssl USE flag | * '''curl:''' contains the cURL library; to compile with SSL support, apply the net-misc/curl ssl USE flag | ||
To compile and install these packages through emerge, use the emerge -v <package list> command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge. | To compile and install these packages through emerge, use the emerge -v <package list> command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge. | ||
Line 113: | Line 113: | ||
Grab the | Grab the net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the ''mods/deathmatch/'' directory and put the latest resources from [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project] into the ''mods/deathmatch/resources/'' directory . You can then run your server. | ||
<syntaxhighlight lang="lua">cd MTA10_Server/output | <syntaxhighlight lang="lua">cd MTA10_Server/output |
Revision as of 08:17, 16 November 2010
Building on GNU/Linux
Preparing your system
In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution.
Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from here. Use the net.so from 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of MTA10_Server/version.h as it contains directions on how to compile the different build types.
Debian Linux
Includes derivative distributions such as Ubuntu.
You will need the necessary build tools, headers and libraries, which are distributed through the following Debian packages (e.g. Debian Lenny):
- build-essential: contains the necessary tools, headers and libraries to build applications
- automake: contains the automake tools
- libtool: contains the libtool software required to build libraries
- libcurl3-dev: contains the cURL library (version 3 without SSL support)
- libpcre3-dev: contains the PCRE library (version 3)
- libsqlite3-dev: contains the SQLite library (version 3)
- libreadline5-dev: contains the readline library (version 5)
- subversion: contains the SVN client used to check out our code repository
To install these packages through apt, use the apt-get install <package list> command as in the following example (executed as root):
apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion
Gentoo Linux
You will need the necessary build tools, headers and libraries. Because Gentoo’s portage system is designed to compile any packages on your own system, the necessary build tools will have already been installed. This only leaves you to install the necessary libraries:
- sqlite: contains the SQLite library
- subversion: contains the SVN client used to check out our code repository
- curl: contains the cURL library; to compile with SSL support, apply the net-misc/curl ssl USE flag
To compile and install these packages through emerge, use the emerge -v <package list> command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the Gentoo Handbook or manual for more information on emerge.
Example:
emerge -v subversion sqlite USE=“net-misc/curl ssl” emerge -v curl
Fedora
You will need these packages to be able to successfully compile a MTA server on Fedora:
- glibc-devel:
- curl-devel: contains the cURL library
- pcre-devel: contains the PCRE library
- sqlite3-devel: contains the SQLite library
- readline-devel: contains the readline library
- lua-devel: contains the Lua libraries
- subversion: contains the SVN client to check out the source code
To install these packages through yum, use the yum install <package list> command as in the following example (executed as root):
yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion
A warning for x64
The MTA:SA server currently cannot be properly compiled in 64-bit mode. Instead, you should compile it in 32-bit mode and run it using 32-bit compatibility mode (use the -m32 flag).
General instructions
Downloading the source.
First you need to download the source.
svn checkout http://mtasa-blue.googlecode.com/svn/trunk/ mtasa-blue cd mtasa-blue
Prepare the sparsehash library
You can skip this step if your distribution’s package manager provides a sparsehash package that you can install.
cd vendor/sparsehash/current autoreconf -fi sh ./configure make install cd ../../..
Compiling the server
autoreconf -fi ./configure make install
Your vanilla server will now be compiled and installed into the MTA10_Server/output/ directory.
Run the server
Grab the net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the mods/deathmatch/ directory and put the latest resources from multitheftauto-resources project into the mods/deathmatch/resources/ directory . You can then run your server.
cd MTA10_Server/output ./mta-server
Troubleshooting
Any errors during the compilation of json-c can be solved by calling autoreconf -fi from the json-c directory.
If you’re getting any unexpected errors while compiling, please check our Bug tracker or our IRC channel