Getting Started with Server

2018-10-29T21:18:24Z

RubiZockt: /* Setting up server */

== Introduction ==

This brief tutorial will show you how to run your server on both Windows and Linux distributions.

By default, the server makes use of port 22005 UDP for server access and the port after (here 22006) for the HTTP server hosting the client packages for the clients to download from.<br>
So make sure to have done the ports forwarding on your router process and have also unblocked the ports on your firewall before running the server.

=Bridge=
The following tutorial is found on [https://wiki.gtanet.work/index.php?title=Setting_up_the_Bridge_on_Linux/Windows Setting up the Bridge on Linux/Windows]

=Windows=
==Prerequisite==
For a hassle-less installation and operation, the latest VC Redist is recommended to have.

[https://aka.ms/vs/15/release/VC_redist.x64.exe Microsoft Visual C++ Redistributable 2017]

==Setting up server==
1. Download the latest [https://cdn.rage.mp/client/updater.exe updater.exe]

2. Run the downloaded '''updater.exe'''

3. Launch '''server.exe''' and you should be able to connect to it.

=Linux=
==Prerequisite==
===Ubuntu===
<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install libstdc++6
</syntaxhighlight>

===Debian===
<syntaxhighlight lang="bash">
echo 'deb http://httpredir.debian.org/debian testing main contrib non-free' > /etc/apt/sources.list
apt-get update
apt-get install -y -t testing gcc
</syntaxhighlight>

==Setting up server==
This bash snippet should automate the server installation.
<syntaxhighlight lang="bash">
# Downloading server
wget https://cdn.rage.mp/lin/ragemp-srv-036.tar.gz

# Extract the server files
tar -xzf ragemp-srv-036.tar.gz

# accessing the directory
cd ragemp-srv-036

# Set executable permission
chmod +x server

# Run the server
./server

</syntaxhighlight>

==Installing screen (Optional)==
For running the server in background, we recommend using screen mainly for its ease of use

===Debian based (Ubuntu & derivatives)===
<syntaxhighlight lang="bash">
sudo apt-get install screen
</syntaxhighlight>

===CentOS 6.x/7.x===
<syntaxhighlight lang="bash">
yum install screen
</syntaxhighlight>

===Starting the server===
<syntaxhighlight lang="bash">
screen -dmS GTASERVER -L bash -c 'cd ~/srv && ./server' &

# Parameter explanation
# screen -dmS = starts a separate shell without directly opening an interface towards it (detached mode). The S param defines a session name for the newly created session, so that it is easier to manage in the future.
# screen -L = basically logs whatever error that is shown by the server through the separate shell into a file for easier reference in the future.
# !IMPORTANT!
# Log output will be saved as screenlog._number_ in the server directory.
# &: IS IMPORTANT IF YOU WANT TO TERMINATE THE PROCESS GRACEFULLY
</syntaxhighlight>

===Stopping the server===
To stop the server, there's usually two ways to do that, one that we call a '''graceful''' shutdown that sends the server a signal for termination and the other, well, a '''crash''' since it does not allow the code to run through the termination process correctly.

'''RECOMMENDED:'''
<syntaxhighlight lang="bash">
kill $(ps h --ppid $(screen -ls | grep GTASERVER | cut -d. -f1) -o pid)
</syntaxhighlight>

'''NOT RECOMMENDED:''' It does not shut down the server gracefully
<syntaxhighlight lang="bash">
screen -S GTASERVER -X quit
</syntaxhighlight>

=Troubleshooting=
==Linux==
<syntaxhighlight lang="bash">
./server: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by ./server)
</syntaxhighlight>

Make sure GCC/G++ 6 or newer is installed, follow the [[Getting_Started_with_Server#Prerequisite|Prerequisite]]

[[Category:Tutorials]]

RAGE Multiplayer Wiki - User contributions [en]

Getting Started with Server