This is my first attempt and I feel like I have followed the installation guide step-by-step and everything works perfectly up until extracting the maps, mmpas, vmaps, etc. and I am stuck as I can't find a whole lot of detailed instructions.

I am trying to install mangos WOTLK 3.3.5 on Ubuntu 18.04.5 LTS, Release:  18.04, Codename: bionic on a VM but I keep getting the errors shown below. the auth server seems to be running fine and I can log in with the default credentials but running the world server keeps erroring out about missing map, mmap, etc. files

I didn't change anything from the install guide and defaults except chaining the mangos password. Does you see any issues with the output here that can help?

 

mangos@DAL-VM-TFBS-1:/opt/wow/install/mangos/bin$ ./mangosd
2201075 [world-daemon]
<Ctrl-C> to stop.
  __  __      _  _  ___  ___  ___        ____
 |  \/  |__ _| \| |/ __|/ _ \/ __|      /_  /___ _ _ ___
 | |\/| / _` | .` | (_ | (_) \__ \       / // -_) '_/ _ \
 |_|  |_\__,_|_|\_|\___|\___/|___/      /___\___|_| \___/
 Powered By MaNGOS Core
__________________________________________________________

Website/Forum/Wiki/Issue Tracker: https://www.getmangos.eu
__________________________________________________________


Using configuration file /opt/wow/install/mangos/conf/mangosd.conf.
OpenSSL 1.1.1  11 Sep 2018 (Library: OpenSSL 1.1.1  11 Sep 2018)
Using ACE: 6.5.9
World Database total connections: 2
Connected to MySQL database mangos@127.0.0.1:3306/mangos0
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
Connected to MySQL database mangos@127.0.0.1:3306/mangos0
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
The table `db_version` indicates that your [World] database hase the same version as the core requirements.

Character Database total connections: 2
Connected to MySQL database mangos@127.0.0.1:3306/character0
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
Connected to MySQL database mangos@127.0.0.1:3306/character0
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
The table `db_version` indicates that your [Character] database hase the same version as the core requirements.

Login Database total connections: 2
Connected to MySQL database mangos@127.0.0.1:3306/realmd
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
Connected to MySQL database mangos@127.0.0.1:3306/realmd
MySQL client library: 5.7.34
MySQL server ver: 5.7.34-0ubuntu0.18.04.1
AUTOCOMMIT SUCCESSFULLY SET TO 1
The table `db_version` indicates that your [Realmd] database hase the same version as the core requirements.


Realm running as realm ID 1

Using World DB: Version: 22, Structure: 1, Content: 17

Using DataDir /opt/wow/gamedata/1.12/mangos/
WORLD: VMap support included. LineOfSight:1, getHeight:1, indoorCheck:1
WORLD: VMap data directory is: /opt/wow/gamedata/1.12/mangos/vmaps
WORLD: MMap pathfinding enabled

Please check for the existence of map file '/opt/wow/gamedata/1.12/mangos/maps/0004331.map'
Correct *.map files not found in path '/opt/wow/gamedata/1.12/mangos/maps' or *.vmtree/*.vmtile files in '/opt/wow/gamedata/1.12/mangos/vmaps'. Please place *.map and vmap files in appropriate directories or correct the DataDir value in the mangosd.conf file.

Wait 10 secs for continue.
[**************************************************] 100%
Segmentation fault

1. Make a folder for ACE in your preferred location ( I use /opt)

mkdir /opt/ace && cd /opt/ace

2. Download and unpack ACE

wget http://download.dre.vanderbilt.edu/previous_versions/ACE-6.4.7.tar.gz
tar -xvf ACE-6.4.7.tar.gz

3. Add needed environment variables

cat >> /etc/profile <<EOF
export ACE_ROOT=/opt/ace/ACE_wrappers
EOF
source /etc/profile

4. Add the desired headers

cat > /opt/ace/ACE_wrappers/ace/config.h <<EOF
#include "ace/config-linux.h"
EOF
cat > /opt/ace/ACE_wrappers/include/makeinclude/platform_macros.GNU <<EOF
INSTALL_PREFIX = /usr/local
include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU
EOF

5. Build ACE

cd /opt/ace/ACE_wrappers
make
make install

6. Add the library to the public path

cat > /etc/ld.so.conf.d/ace.conf <<EOF
/opt/ace/ACE_wrappers/lib
EOF
ldconfig -v

This guide has been fully tested on an empty Debian 8 system with minimal installation.

Let's go..

Setup the database:

Debian is supporting MySQL by default. This part of the guide will help you to setup your instance of MySQL.

Launch a terminal, and if it's not already the case, you need to become the 'root' user:

sudo su - root

Then, install MySQL, enter your root password when you will be prompted for:

aptitude -y install mysql-server

     Once MySQLis installed, start it:

systemctl start mysql

I do advise you to add MySQL service at startup to execute it automatically:

systemctl enable mysql

Let's secure your MySQL installation, execute the following command:

mysql_secure_installation

I advise you to setup the following parameters:

Do not change the root password
Remove anonymous access
Disable remote access for the root user
Remove the test database
Reload the privileges

Now that the setup of the database is done, we need to add the prerequisites for the mangos database configuration. We need to start by creating an user for mangos, login to the database using:

mysql -u root -p

Create the user you wish, the example given is creating an user 'mangos' who can connect from the 'localhost' and has the password 'password' (do not forget the ';') at the end:

CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'password';

We then need to grant privileges to that user that we can use it later to setup the Mangos schemas (again, do not forget the ';' symbol):

GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost';

Exit the terminal:

quit

Congratulations, you have setup the pre-requisites for the database on Debian !

Install Mangos:

We are now at the interesting part, how do we install Mangos on Debian ? Well, assuming you are logged in as 'root', go to the home directory:

cd ~

Now, we can download our installer:

wget https://raw.githubusercontent.com/mangoszero/server/master/linux/getmangos.sh

Set the permissions to be allowed to execute it:

chmod 700 getmangos.sh

And execute it:

./getmangos.sh

Before we go further, some explanations on the available activities:

• Install Prerequisites will install all the necessary dependencies for you to build & run mangos. Toggled by default.
• Set Download And Install Paths will allow you to specify where the sources must be downloaded and where the binaries must be installed. Toggled by default.
• Clone Source repositories will help you cloning the Mangos sources. Toggled by default.
• Build MaNGOS will assist you in the building process of MaNGOS. Toggled by default.
• Install MaNGOS will help you installing MaNGOS. Toggled by default.
• Install Databases will assist you in the database schemas creation. Toggled by default.
• Extract Resources will help you to extract the DBC, maps, mmaps and vmaps from the game client. Toggled by default.
• Create Code::Blocks Project File will create a project for the Code::Blocks editor. Do not toggle this option if you don't plan to edit the MaNGOS sources.

Now that you know everything, let the default options selected and select 'Ok' thanks to the Tab key. The script is now installing the necessary dependencies on your Debian. You will be prompted to provide your agreement to install the build dependencies. Select 'Yes' two times.

User selection:

Mangos provides you the opportunity to run it under another user than the 'root' one. This is a good practice to isolate softwares and limit the security impact in case of an exploited vulnerability. The default proposed run user is 'mangos' but you can change if you wish. Select 'Ok' to continue.

If you have already performed this step, the installer will ask you whether you want to keep that user. I advise you to reply 'Yes' except if you know what you are doing.

Choose WoW Release:

The next screen is requesting you to choose the WoW release you are willing to install. Select the one you that fits your wish and select 'Ok'.

Source-Code Path:

The next screen is asking you to provide the source path. By default, the proposed format is /home/<run user>/<wow version>/src. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero/src

Reply 'Yes' to create the directory if it does not exist. If it does exist and contains sources, the installer will ask you whether you want to delete the content or not.

Installation Path:

The next screen is asking you to provide the installation path. This is the location from where you will execute the Mangos processes. By default, the proposed format is /home/<run user>/<wow version>. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero

If it does exist and contains compiled sources, the installer will ask you whether you want to delete the content or not.

Clone or update MaNGOS:

The next step of the script is asking you whether you want to clone, update or use an existing copy of the MaNGOS sources. For a fresh installation, select the option '0 Clone a fresh copy of MaNGOS'. The installer will now connect to Github and check the available development branch, currently, the last stable release is the Rel21 and is hosted in the 'master' branch.

The installer is now cloning the server and database repositories.

Build Options:

You are now at the build step. Some explanations over this screen:

• Enable Debug will setup debug flags and more tracing on Mangos. Use this build option only if you're requested to to fix a bug. Building a software in debug mode significantly reduces its performances.
• Use Standard Malloc, toggle this option to use the standard memory allocation. Untoggle this option only if you know what you are doing.
• Use External ACE libraries. Allows you to use the ACE libraries coming from your system. Untoggle this option only if you know what you are doing.
• Use PostgreSQL insteald of MySQL/MariaDB. Allows you to use another database provider than the default one. This option has not been tested and, if you have followed the tutorial so far, you should have setup MySQL ;-)
• Build Client Tools will build the extractors necessary to get dbc, maps, mmaps and vmaps out of the game client. Unselect this option only if you already have these resources extracted.
• Use SD3 will allow you to build the ScriptDev3 Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on C++ scripts.
• Use Eluna will allow you to build the Eluna Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on LUA scripts.

Select 'Ok' to proceed with the build process and confirm that would want to build MaNGOS. The installer is now building MaNGOS. Depending on the speed of your system, you have the time to drink a glass of water or a cup of coffee. :-)

Installation:

You will now be prompted to install Mangos. Select 'Yes' to install it.

Database Operations:

Wait.. another database setup ?! Yes, but this time, we are populating the database with the mangos data. You have three options here:

• Install clean databases to setup a fresh database
• Update existing databases to update your old version of the database
• Skip database work... but it wouldn't make sense :-)

Select the first option if you are performing a fresh installation. You will be prompted to select your type of database. If you followed the guide so far, you should select "MariaDB" because Debian is providing an old version of MySQL. The installer will then request your database information, if you followed the guide, you need to provide the following input:

Hostname: localhost
Port: 3306
User: mangos
Password: password

You can now choose into several options:

• ReInstall the realm database, containing all the realms information and the accounts
• ReInstall the world database, containing all the world configuration
• ReInstall the characters database, containing all the characters information
• Update the realmlist to setup an initial game server

By default, all options must be toggled. The installer will now perform the database import.

Extract Game Data:

This step will copy the extractors to the wow game location, extract dbc, maps, mmaps and vmaps and copy these extracted data to your installation directory. The installer will automatically look for a suitable WoW client into your /home directory. If it doesn't find anything, you will have to provide your game location path. If the provided path doesn't contain any game data, the installer will exit.

The extractor steps allows you to select the artifacts you want to extract:

• DBC and Maps, which are the minimum set of data you need to extract
• Mmaps which are the movement maps, based on vectoriel calculation, required for an efficient pathfinding
• Vmaps which are the virtual maps, used for collision detection and LoS detection

The Mmaps extraction is taking several hours, you will have the time to sleep or drink several coffees. :-)

Congratulations !

You almost did it ! Still few steps to perform before you can play on your preferred game. First of all, you need to switch to your run user. If you used mangos, the command will look like:

su - mangos

You need then to go to the configuration directory of your installation, if you installed Vanilla, it will look like the following command:

cd /home/mangos/zero/etc

Copy the realmd.conf.dist and mangosd.conf.dist files to their expected name:

cp realmd.conf.dist realmd.conf
cp mangosd.conf.dist mangosd.conf

Edit the realmd.conf and find the line LoginDatabaseInfo. Provide your database information, according to this guide and if you have installed Vanilla, it should look like:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"

Save your file and edit the file mangosd.conf. You need to provide the database information for the three database we have configured with our installer:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"
WorldDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_world"
CharacterDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_characters"

Save your file and go back to the 'root' user:

exit

Make sure it keeps running !

What could be cooler than having the MaNGOS server starting automatically with your server ? Not much... so let's configure systemd to do so ! First of all, we need to tell it that we have two new services. Declare them by creating the corresponding files:

touch /etc/systemd/system/realmd.service
touch /etc/systemd/system/mangosd.service # Or give it a better name like zero.service if it's a vanilla gaming server for instance.

Now, edit the /etc/systemd/system/realmd.service file and add the following content (Replace the installation path and the run user by the settings you have provided during the installation):

[Unit]
Description=Realmd service
After=network.target mysql.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/realmd -c /home/mangos/zero/etc/realmd.conf
Restart=on-abort

[Install]
WantedBy=multi-user.target

Save this file and edit the /etc/systemd/system/mangosd.service file (or the better name you gave to it) with the following content (same remark than above the installation path and the run user):

[Unit]
Description=WoW Vanilla service
After=network.target mysql.service getty@tty3.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/mangosd -c /home/mangos/zero/etc/mangosd.conf
WorkingDirectory=/home/mangos/zero/bin
StandardInput=tty
TTYPath=/dev/tty3
TTYReset=yes
TTYVHangup=yes
Restart=on-abort

[Install]
WantedBy=multi-user.target

We are almost there ! You now need to tell systemd to reload its configuration:

systemctl daemon-reload

And let's start our processes to verify that they work:

systemctl start realmd
systemctl start mangosd

To verify that it worked, execute the following command:

systemctl status realmd
systemctl status mangosd

If it's working properly, you should have an output indicating you the success status for both service. The last step is to tell systemd to execute them at startup, for this, execute the following commands:

systemctl enable realmd
systemctl enable mangosd

Congratulations ! You are now done with the MaNGOS setup on Debian 8 :-) You can now reboot your computer to verify that everything is indeed started:

reboot

Required Packages

First we need to install all of the required programs and library's.

Open up a root terminal. If your not root, enter this to become root

sudo su

Install the following packages

apt install git make cmake libssl-dev libbz2-dev build-essential default-libmysqlclient-dev

We need to grab the mysql stuff from here. Follow the instructions there. Also, choose mysql 5.7. A script needed later requires this so don't install mysql 8. Install the server with

apt install mysql-server

You also need to grab and compile libace. You can get it from here. Extract it and read the instructions.They're pretty straight-forward. It should be named 'ACE-INSTALL.html' or something similar.

When thats done, enter this command. I highly recommend doing this even if your just keeping the server to yourself

mysql_secure_installation

 I suggest these options:

Don't use the password plugin
Change the root password
Remove the anonymous user
Disable remote access for root
Remove the test database
Reload privileges

Restart your system with

init 6

Getting the Mangos source code

Now we need the source code for mangos. Open up a terminal as root and go to the home directory:

cd ~

Lets create a root directory for all of the mangos files

mkdir mangos

Now we clone the source code. Mangos servers above two are unstable or incomplete. Don't be surprised if something doesn't work or is missing.

git clone https://github.com/mangoszero/server.git --recursive --depth 1

For the database

git clone https://github.com/mangoszero/database.git --recursive --depth 1

If you want a different server(say mangos one), simply change the url. For example

git clone https://github.com/mangosone/server.git --recursive --depth 1

For the mangos one server. If you want mangos two, simply do the same. Do the same with the database.

Wait for the repos to be cloned (the server is about 200-250mb-ish)

Compilaton

The good part. Enter the mangos source directory

cd server

Make a new directory for the build files.

mkdir build

Go into it

cd build

Now run this to configure the makefiles

cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/bin/mangos

If cmake doesn't complain about anything, your good to go with compiling it.  To speed up compilation, you need to know how many cores your cpu has. Most cpus have 2 or 4 cores. Search it up if your not sure. Now to compile it, simply enter this

make -j2

Change -j2 to how cores you have. If you have 4 cores, change it to

make -j4

If you only have one core, don't bother with the -j flag, just type in 'make' and hit enter.

This will take a while depending on how fast your cpu is. Just be paitent.

After a bit, mangos will be compiled(yay)and you will need to separate the needed files from the source code. To install it into your install prefix(default is /usr/local/bin/mangos), do this

make install

Database Setup: The Sequel
Now for another database setup (i know, its crazy). This time, we will be loading some stuff into it. Enter the database folder you cloned earlier and execute InstallDatabases.sh

./InstallDatabases.sh

If it says something similar to 'bash: ./InstallDatabases.sh: Permission denied', the script isn't marked as executable. Mark everything needed as executable by running this

chmod -R +x *.sh

Now have a go at running the script again. When execute it, you'll be brought to a menu. The defaults are fine for a new server so just press 'n' and hit enter

You will have to give it your mysql details. This needs to be your server hostname(ip address), username, password and server port. The only things you need to change are the username and password. Keep in mind all of this must be done as the ROOT user.

Game Data

Now this is the longest part if decide to get mmaps. To run the server, you MUST extract the .dbc and .map files. To do this, copy everything in the tools folder to where your wow client is. Keep in mind the version of the client as it must be a specific version for this(mangoszero is a bit more lenient then others). You need 1.12.x (x can be any number) for mangoszero, 2.3.4 for mangosone, 3.3.5 for mangostwo(favourite), 4.3.4 for mangosthree and 5.4.1 for mangosfour. To extract the dbc and map files, execute this when in your wow client folder

./mapextractor

This can take around 5 minutes to complete. Once thats done, copy over the folders "dbc" and "maps" to where you installed mangos. I recommend getting all of the data though so to get the vmaps, make sure the maps folder is still in your wow folder and exectute this

./vmaps4extractor

Once thats done, type this in your terminal

./vmaps4assembler

Just copy over the "vmaps" folder to where mangos is. Now for movemaps. This can take anywhere from an hour to a whole day depending on your computer and what client data you're extracting. Make sure the vmaps and maps folders are still in your wow folder and type this out

./MoveMapGen.sh 2

Now, you might want to know how many cores your computer has. Most computers have 2 so if you don't know, just leave the command as is. If you got 4 or 8 cores, replace the 2 with a 4 or a 8. More threads the better but your computer will be a lot slower if you use all of your cpu. Press enter and prepare to wait a while. Once its finished extracting, copy over the folder "mmaps" to where mangos is. You can delete the maps, dbc, vmaps, buildings and mmaps from your client folder now if you want.

Server Configuration

Now to configure the server. Go to the mangos configuration folder

cd /usr/local/bin/mangos/etc

Copy the files to their proper name. DON'T delete them. They're a backup in case your .conf files get corrupted or you mess up some settings

cp mangosd.conf.dist mangosd.conf

cp realmd.conf.dist realmd.conf

Edit realmd.conf and find the line 'LoginDatabaseInfo', change the information to suit your database. For example if my database hostname is localhost or 127.0.0.1, the port is 3306, username is root, the password is mangos and my realm database is realmd, it would look like this

LoginDatabaseInfo = "127.0.0.1;3306;root;mangos;realmd"

Save the file and edit mangosd.conf. Look for lines, LoginDatabaseInfo, WorldDatabaseInfo and CharacterDatabaseInfo. Do the same to those lines as you did to the one in realmd.conf. You may wish to fully read mangosd.conf to fine-tune your server if you wish.

Save the file.

Starting the Server

Now to see if your hard work has paid off. Go to where you installed the server and start realmd

./realmd

Now start mangosd

./mangosd

If theres a error mangosd or realmd can't fix, it'll tell you problem then exit. It will be up to fix it however. The most common problem is that the password or username is wrong or that the database isn't running. Try editing mangosd.conf or realmd.conf if thats the case and making sure the db is running

If it started and gives you a prompt, the server is loaded and awaiting a connection from a client.

Starting the server with systemd

This allows you to startup your computer and have mangosd and realmd load with it. Very useful on a dedicated server. We need to make 2 .service files to do this.

touch /etc/systemd/system/mangosd.service

touch /etc/systemd/system/realmd.service

Edit mangosd.service with your preferred text editor. Don't type 'edit /etc/systemd/system/mangosd.service' unless you know how to quit vi.

[Unit]
Description=WoW server
After=network.target mysql.service

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/mangos/bin/mangosd -c /usr/local/bin/mangos/etc/mangosd.conf
Restart=on-abort

[Install]
WantedBy=multi-user.target

Do the same with realmd.service

[Unit]
Description=WoW server
After=network.target mysql.service

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/mangos/bin/realmd -c /usr/local/bin/mangos/etc/realmd.conf
Restart=on-abort

[Install]
WantedBy=multi-user.target

Let systemd reload.

systemctl daemon-reload

Start realmd via systemd to see if the .service file is valid

systemctl start realmd

Do the same with mangosd

systemctl start mangosd

Check the status of both services with

systemctl status realmd

systemctl status mangosd

If it's working, you should see something like a green OK on both daemons (fun fact: daemons and services are the same thing) then you should be good to enable them at startup. Do this for realmd

systemctl enable realmd

systemctl enable mangosd

Restart your system

init 6

Check that they started as root

systemctl status realmd

Do the same with mangosd

If its good then mangosd and realmd will always start with your system until you disable them.

Letting WoW clients connect to your server
This is the 2nd last thing you need to do. This will allow WoW clients to connect to your server. We need to edit a table in the database. If you know what your doing with mysql, follow along but do the equivalent on the terminal. If you prefer doing things with a gui(graphical user interface, your using one right now!), lets install a gui mysql client. We'll use 'mysql-workbench'

apt install mysql-workbench

After its installed, check your start menu in 'Programming'. Start mysql workbench and click on your server. Enter your password and look on the lower left. Click on the little arrow next to realmd and scroll down to realmlist. Right click on it and click on 'Alter Table'. Go down to localAddress and double click on the '127.0.0.1'. Change this to your lan ip. You can find out your lan ip by opening a terminal and typing in

ifconfig

You will see about 4-5 interfaces. If your connection is a wired one, you should look at a interface named 'enp' followed by letters and numbers. For example, 'enp14s0'. Then look at the 'inet' part. This is your lan ip. Do the same if your connection is wireless or wi-fi. Wireless connections will be named like 'wlp' with some letters and numbers. 'wlp20s0' is a example.

Once you have changed localAddress to your lan ip, you need to change address to your external ip. Go here to find out your ip. Now we need to let realmd know that the database has changed. Stop it with

systemctl stop realmd

Now start it again with

systemctl start realmd

Connecting a WoW client to your server

Nearly there! Go to where your wow client is and look for a file named realmlist.wtf. Delete everything in this file and put the following stuff in it

set realmlist 10.1.1.1
set patchlist 10.1.1.1

Change 10.1.1.1 to your server ip. It can be the lan ip if its on the same network as the server. Now for the moment of truth. Open up WoW.exe(not the launcher)and wait for it to load. Skip the cinematic if want by pressing escape(esc). Now login into the server by using administrator as the email and no password.  Choose the only realm and create your character. You now have a functioning WoW server for you and your friends to play on! Also, since you logged in using the admin account, you can use game master commands. Type in the chat '.gm help' for a list of commands currently in mangos. Have fun with it!

This guide has been fully tested on an empty Fedora 25 system with minimal installation.

Let's go..

Setup the database:

Fedora is supporting MariaDB instead of MySQL by default. This part of the guide will help you to setup your instance of MariaDB.

Launch a terminal, and if it's not already the case, you need to become the 'root' user:

sudo su - root

Then, install MariaDB:

yum -y install mariadb-server

     Once MariaDB is installed, start it:

systemctl start mariadb

I do advise you to add mariadb service at startup to execute it automatically:

systemctl enable mariadb

Let's secure your mariadb installation, execute the following command:

mysql_secure_installation

I advise you to setup the following parameters:

Setup a Root password
Remove anonymous access
Disable remote access for the root user
Remove the test database
Reload the privileges

Verify that you database configuration is working properly.

systemctl status mariadb

Now that the setup of the database is done, we need to add the prerequisites for the mangos database configuration. We need to start by creating an user for mangos, login to the database using:

mysql -u root -p

Create the user you wish, the example given is creating an user 'mangos' who can connect from the 'localhost' and has the password 'password' (do not forget the ';') at the end:

CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'password';

We then need to grant privileges to that user that we can use it later to setup the Mangos schemas (again, do not forget the ';' symbol):

GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost';

Exit the terminal:

quit

Congratulations, you have setup the pre-requisites for the database on Fedora !

Install Mangos:

We are now at the interesting part, how do we install Mangos on Fedora ? Well, assuming you are logged in as 'root', go to the home directory:

cd ~

Now, we can download our installer:

wget https://raw.githubusercontent.com/mangoszero/server/master/linux/getmangos.sh

Set the permissions to be allowed to execute it:

chmod 700 getmangos.sh

And execute it:

./getmangos.sh

Before we go further, some explanations on the available activities:

• Install Prerequisites will install all the necessary dependencies for you to build & run mangos. Toggled by default.
• Set Download And Install Paths will allow you to specify where the sources must be downloaded and where the binaries must be installed. Toggled by default.
• Clone Source repositories will help you cloning the Mangos sources. Toggled by default.
• Build MaNGOS will assist you in the building process of MaNGOS. Toggled by default.
• Install MaNGOS will help you installing MaNGOS. Toggled by default.
• Install Databases will assist you in the database schemas creation. Toggled by default.
• Extract Resources will help you to extract the DBC, maps, mmaps and vmaps from the game client. Toggled by default.
• Create Code::Blocks Project File will create a project for the Code::Blocks editor. Do not toggle this option if you don't plan to edit the MaNGOS sources.

Now that you know everything, let the default options selected and select 'Ok' thanks to the Tab key. The script is now installing the necessary dependencies on your Fedora. You will be prompted to provide your agreement to install the build dependencies. Select 'Yes' two times. On Fedora, ACE will also be downloaded and built, at this moment, it is the version 6.4.2 which is built by the installer.

User selection:

Mangos provides you the opportunity to run it under another user than the 'root' one. This is a good practice to isolate softwares and limit the security impact in case of an exploited vulnerability. The default proposed run user is 'mangos' but you can change if you wish. Select 'Ok' to continue.

If you have already performed this step, the installer will ask you whether you want to keep that user. I advise you to reply 'Yes' except if you know what you are doing.

Choose WoW Release:

The next screen is requesting you to choose the WoW release you are willing to install. Select the one you that fits your wish and select 'Ok'.

Source-Code Path:

The next screen is asking you to provide the source path. By default, the proposed format is /home/<run user>/<wow version>/src. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero/src

Reply 'Yes' to create the directory if it does not exist. If it does exist and contains sources, the installer will ask you whether you want to delete the content or not.

Installation Path:

The next screen is asking you to provide the installation path. This is the location from where you will execute the Mangos processes. By default, the proposed format is /home/<run user>/<wow version>. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero

If it does exist and contains compiled sources, the installer will ask you whether you want to delete the content or not.

Clone or update MaNGOS:

The next step of the script is asking you whether you want to clone, update or use an existing copy of the MaNGOS sources. For a fresh installation, select the option '0 Clone a fresh copy of MaNGOS'. The installer will now connect to Github and check the available development branch, currently, the last stable release is the Rel21 and is hosted in the 'master' branch.

The installer is now cloning the server and database repositories.

Build Options:

You are now at the build step. Some explanations over this screen:

• Enable Debug will setup debug flags and more tracing on Mangos. Use this build option only if you're requested to to fix a bug. Building a software in debug mode significantly reduces its performances.
• Use Standard Malloc, toggle this option to use the standard memory allocation. Untoggle this option only if you know what you are doing.
• Use External ACE libraries. Allows you to use the ACE libraries coming from your system. Untoggle this option only if you know what you are doing.
• Use PostgreSQL insteald of MySQL/MariaDB. Allows you to use another database provider than the default one. This option has not been tested and, if you have followed the tutorial so far, you should have setup MariaDB ;-)
• Build Client Tools will build the extractors necessary to get dbc, maps, mmaps and vmaps out of the game client. Unselect this option only if you already have these resources extracted.
• Use SD3 will allow you to build the ScriptDev3 Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on C++ scripts.
• Use Eluna will allow you to build the Eluna Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on LUA scripts.

Select 'Ok' to proceed with the build process and confirm that would want to build MaNGOS. The installer is now building MaNGOS. Depending on the speed of your system, you have the time to drink a glass of water or a cup of coffee. :-)

Installation:

You will now be prompted to install Mangos. Select 'Yes' to install it.

Database Operations:

Wait.. another database setup ?! Yes, but this time, we are populating the database with the mangos data. You have three options here:

• Install clean databases to setup a fresh database
• Update existing databases to update your old version of the database
• Skip database work... but it wouldn't make sense :-)

Select the first option if you are performing a fresh installation. You will be prompted to select your type of database. If you followed the guide so far, you should select "MariaDB". The installer will then request your database information, if you followed the guide, you need to provide the following input:

Hostname: localhost
Port: 3306
User: mangos
Password: password

You can now choose into several options:

• ReInstall the realm database, containing all the realms information and the accounts
• ReInstall the world database, containing all the world configuration
• ReInstall the characters database, containing all the characters information
• Update the realmlist to setup an initial game server

By default, all options must be toggled. The installer will now perform the database import.

Extract Game Data:

This step will copy the extractors to the wow game location, extract dbc, maps, mmaps and vmaps and copy these extracted data to your installation directory. The installer will automatically look for a suitable WoW client into your /home directory. If it doesn't find anything, you will have to provide your game location path. If the provided path doesn't contain any game data, the installer will exit.

The extractor steps allows you to select the artifacts you want to extract:

• DBC and Maps, which are the minimum set of data you need to extract
• Mmaps which are the movement maps, based on vectoriel calculation, required for an efficient pathfinding
• Vmaps which are the virtual maps, used for collision detection and LoS detection

The Mmaps extraction is taking several hours, you will have the time to sleep or drink several coffees. :-)

Congratulations !

You almost did it ! Still few steps to perform before you can play on your preferred game. First of all, you need to switch to your run user. If you used mangos, the command will look like:

su - mangos

You need then to go to the configuration directory of your installation, if you installed Vanilla, it will look like the following command:

cd /home/mangos/zero/etc

Copy the realmd.conf.dist and mangosd.conf.dist files to their expected name:

cp realmd.conf.dist realmd.conf
cp mangosd.conf.dist mangosd.conf

Edit the realmd.conf and find the line LoginDatabaseInfo. Provide your database information, according to this guide and if you have installed Vanilla, it should look like:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"

Save your file and edit the file mangosd.conf. You need to provide the database information for the three database we have configured with our installer:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"
WorldDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_world"
CharacterDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_characters"

Save your file and go back to the 'root' user:

exit

Make sure it keeps running !

What could be cooler than having the MaNGOS server starting automatically with your server ? Not much... so let's configure systemd to do so ! First of all, we need to tell it that we have two new services. Declare them by creating the corresponding files:

touch /etc/systemd/system/realmd.service
touch /etc/systemd/system/mangosd.service # Or give it a better name like zero.service if it's a vanilla gaming server for instance.

Now, edit the /etc/systemd/system/realmd.service file and add the following content (Replace the installation path and the run user by the settings you have provided during the installation):

[Unit]
Description=Realmd service
After=network.target mariadb.service

[Service]
Type=simple
User=mangos
Environment=LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
ExecStart=/home/mangos/zero/bin/realmd -c /home/mangos/zero/etc/realmd.conf
Restart=on-abort


[Install]
WantedBy=multi-user.target

Save this file and edit the /etc/systemd/system/mangosd.service file (or the better name you gave to it) with the following content (same remark than above the installation path and the run user):

[Unit]
Description=WoW Vanilla service
After=network.target mariadb.service getty@tty3.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/mangosd -c /home/mangos/zero/etc/mangosd.conf
WorkingDirectory=/home/mangos/zero/bin
StandardInput=tty
TTYPath=/dev/tty3
TTYReset=yes
TTYVHangup=yes
Restart=on-abort

[Install]
WantedBy=multi-user.target

We are almost there ! You now need to tell systemd to reload its configuration:

systemctl daemon-reload

And let's start our processes to verify that they work:

systemctl start realmd
systemctl start mangosd

To verify that it worked, execute the following command:

systemctl status realmd
systemctl status mangosd

If it's working properly, you should have an output indicating you the success status for both service. The last step is to tell systemd to execute them at startup, for this, execute the following commands:

systemctl enable realmd
systemctl enable mangosd

Congratulations ! You are now done with the MaNGOS setup on Fedora 25 :-)

WARNING!

If you have installed mangos into your home directory, the SELinux will block your execution. To disable this check, you can:

• Install Mangos elsewhere
• Update the SELinux parameters

To update it, you need to edit the file /etc/selinux/config and change the following line:

SELINUX=PERMISSIVE

You can now reboot your computer to verify that everything is indeed started:

reboot

This guide has been fully tested on an empty Linux Mint 18 system with minimal installation.

Let's go..

Setup the database:

Linux Mint is supporting MySQL by default. This part of the guide will help you to setup your instance of MySQL.

Launch a terminal, and if it's not already the case, you need to become the 'root' user:

sudo su - root

Then, install MySQL, enter your root password when you will be prompted for:

aptitude -y install mysql-server

     Once MySQLis installed, start it:

systemctl start mysql

I do advise you to add MySQL service at startup to execute it automatically:

systemctl enable mysql

Let's secure your MySQL installation, execute the following command:

mysql_secure_installation

I advise you to setup the following parameters:

Do not enforce the use of the password plugin
Do not change the root password
Remove anonymous access
Disable remote access for the root user
Remove the test database
Reload the privileges

Now that the setup of the database is done, we need to add the prerequisites for the mangos database configuration. We need to start by creating an user for mangos, login to the database using:

mysql -u root -p

Create the user you wish, the example given is creating an user 'mangos' who can connect from the 'localhost' and has the password 'password' (do not forget the ';') at the end:

CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'password';

We then need to grant privileges to that user that we can use it later to setup the Mangos schemas (again, do not forget the ';' symbol):

GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost';

Exit the terminal:

quit

Congratulations, you have setup the pre-requisites for the database on Linux Mint !

Install Mangos:

We are now at the interesting part, how do we install Mangos on Linux Mint ? Well, assuming you are logged in as 'root', go to the home directory:

cd ~

Now, we can download our installer:

wget https://raw.githubusercontent.com/mangoszero/server/master/linux/getmangos.sh

Set the permissions to be allowed to execute it:

chmod 700 getmangos.sh

And execute it:

./getmangos.sh

Before we go further, some explanations on the available activities:

• Install Prerequisites will install all the necessary dependencies for you to build & run mangos. Toggled by default.
• Set Download And Install Paths will allow you to specify where the sources must be downloaded and where the binaries must be installed. Toggled by default.
• Clone Source repositories will help you cloning the Mangos sources. Toggled by default.
• Build MaNGOS will assist you in the building process of MaNGOS. Toggled by default.
• Install MaNGOS will help you installing MaNGOS. Toggled by default.
• Install Databases will assist you in the database schemas creation. Toggled by default.
• Extract Resources will help you to extract the DBC, maps, mmaps and vmaps from the game client. Toggled by default.
• Create Code::Blocks Project File will create a project for the Code::Blocks editor. Do not toggle this option if you don't plan to edit the MaNGOS sources.

Now that you know everything, let the default options selected and select 'Ok' thanks to the Tab key. The script is now installing the necessary dependencies on your Linux Mint. You will be prompted to provide your agreement to install the build dependencies. Select 'Yes' two times.

User selection:

Mangos provides you the opportunity to run it under another user than the 'root' one. This is a good practice to isolate softwares and limit the security impact in case of an exploited vulnerability. The default proposed run user is 'mangos' but you can change if you wish. Select 'Ok' to continue.

If you have already performed this step, the installer will ask you whether you want to keep that user. I advise you to reply 'Yes' except if you know what you are doing.

Choose WoW Release:

The next screen is requesting you to choose the WoW release you are willing to install. Select the one you that fits your wish and select 'Ok'.

Source-Code Path:

The next screen is asking you to provide the source path. By default, the proposed format is /home/<run user>/<wow version>/src. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero/src

Reply 'Yes' to create the directory if it does not exist. If it does exist and contains sources, the installer will ask you whether you want to delete the content or not.

Installation Path:

The next screen is asking you to provide the installation path. This is the location from where you will execute the Mangos processes. By default, the proposed format is /home/<run user>/<wow version>. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero

If it does exist and contains compiled sources, the installer will ask you whether you want to delete the content or not.

Clone or update MaNGOS:

The next step of the script is asking you whether you want to clone, update or use an existing copy of the MaNGOS sources. For a fresh installation, select the option '0 Clone a fresh copy of MaNGOS'. The installer will now connect to Github and check the available development branch, currently, the last stable release is the Rel21 and is hosted in the 'master' branch.

The installer is now cloning the server and database repositories.

Build Options:

You are now at the build step. Some explanations over this screen:

• Enable Debug will setup debug flags and more tracing on Mangos. Use this build option only if you're requested to to fix a bug. Building a software in debug mode significantly reduces its performances.
• Use Standard Malloc, toggle this option to use the standard memory allocation. Untoggle this option only if you know what you are doing.
• Use External ACE libraries. Allows you to use the ACE libraries coming from your system. Untoggle this option only if you know what you are doing.
• Use PostgreSQL insteald of MySQL/MariaDB. Allows you to use another database provider than the default one. This option has not been tested and, if you have followed the tutorial so far, you should have setup MySQL 😉
• Build Client Tools will build the extractors necessary to get dbc, maps, mmaps and vmaps out of the game client. Unselect this option only if you already have these resources extracted.
• Use SD3 will allow you to build the ScriptDev3 Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on C++ scripts.
• Use Eluna will allow you to build the Eluna Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on LUA scripts.

Select 'Ok' to proceed with the build process and confirm that would want to build MaNGOS. The installer is now building MaNGOS. Depending on the speed of your system, you have the time to drink a glass of water or a cup of coffee. 🙂

Installation:

You will now be prompted to install Mangos. Select 'Yes' to install it.

Database Operations:

Wait.. another database setup ?! Yes, but this time, we are populating the database with the mangos data. You have three options here:

• Install clean databases to setup a fresh database
• Update existing databases to update your old version of the database
• Skip database work... but it wouldn't make sense 🙂

Select the first option if you are performing a fresh installation. You will be prompted to select your type of database. If you followed the guide so far, you should select "MySQL". The installer will then request your database information, if you followed the guide, you need to provide the following input:

Hostname: localhost
Port: 3306
User: mangos
Password: password

You can now choose into several options:

• ReInstall the realm database, containing all the realms information and the accounts
• ReInstall the world database, containing all the world configuration
• ReInstall the characters database, containing all the characters information
• Update the realmlist to setup an initial game server

By default, all options must be toggled. The installer will now perform the database import.

Extract Game Data:

This step will copy the extractors to the wow game location, extract dbc, maps, mmaps and vmaps and copy these extracted data to your installation directory. The installer will automatically look for a suitable WoW client into your /home directory. If it doesn't find anything, you will have to provide your game location path. If the provided path doesn't contain any game data, the installer will exit.

The extractor steps allows you to select the artifacts you want to extract:

• DBC and Maps, which are the minimum set of data you need to extract
• Mmaps which are the movement maps, based on vectoriel calculation, required for an efficient pathfinding
• Vmaps which are the virtual maps, used for collision detection and LoS detection

The Mmaps extraction is taking several hours, you will have the time to sleep or drink several coffees. 🙂

Congratulations !

You almost did it ! Still few steps to perform before you can play on your preferred game. First of all, you need to switch to your run user. If you used mangos, the command will look like:

su - mangos

You need then to go to the configuration directory of your installation, if you installed Vanilla, it will look like the following command:

cd /home/mangos/zero/etc

Copy the realmd.conf.dist and mangosd.conf.dist files to their expected name:

cp realmd.conf.dist realmd.conf
cp mangosd.conf.dist mangosd.conf

Edit the realmd.conf and find the line LoginDatabaseInfo. Provide your database information, according to this guide and if you have installed Vanilla, it should look like:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"

Save your file and edit the file mangosd.conf. You need to provide the database information for the three database we have configured with our installer:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"
WorldDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_world"
CharacterDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_characters"

Save your file and go back to the 'root' user:

exit

Make sure it keeps running !

What could be cooler than having the MaNGOS server starting automatically with your server ? Not much... so let's configure systemd to do so ! First of all, we need to tell it that we have two new services. Declare them by creating the corresponding files:

touch /etc/systemd/system/realmd.service
touch /etc/systemd/system/mangosd.service # Or give it a better name like zero.service if it's a vanilla gaming server for instance.

Now, edit the /etc/systemd/system/realmd.service file and add the following content (Replace the installation path and the run user by the settings you have provided during the installation):

[Unit]
Description=Realmd service
After=network.target mysql.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/realmd -c /home/mangos/zero/etc/realmd.conf
Restart=on-abort

[Install]
WantedBy=multi-user.target

Save this file and edit the /etc/systemd/system/mangosd.service file (or the better name you gave to it) with the following content (same remark than above the installation path and the run user):

[Unit]
Description=WoW Vanilla service
After=network.target mysql.service getty@tty3.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/mangosd -c /home/mangos/zero/etc/mangosd.conf
WorkingDirectory=/home/mangos/zero/bin
StandardInput=tty
TTYPath=/dev/tty3
TTYReset=yes
TTYVHangup=yes
Restart=on-abort

[Install]
WantedBy=multi-user.target

We are almost there ! You now need to tell systemd to reload its configuration:

systemctl daemon-reload

And let's start our processes to verify that they work:

systemctl start realmd
systemctl start mangosd

To verify that it worked, execute the following command:

systemctl status realmd
systemctl status mangosd

If it's working properly, you should have an output indicating you the success status for both service. The last step is to tell systemd to execute them at startup, for this, execute the following commands:

systemctl enable realmd
systemctl enable mangosd

Congratulations ! You are now done with the MaNGOS setup on Linux Mint 18 :-) You can now reboot your computer to verify that everything is indeed started:

reboot

Hello, in this tutorial, I will explain a step-by-step approach to configure, install and run Mangos on a Ubuntu 16.04 LTS system. To fully execute the installation, you need an original copy of the game client version you want to run.

This guide has been fully tested on an empty Ubuntu 16.04 LTS system with minimal installation.

Let's go..

Setup the database:

Ubuntu is supporting MySQL by default. This part of the guide will help you to setup your instance of MySQL.

Launch a terminal, and if it's not already the case, you need to become the 'root' user:

sudo su - root

Then, install MySQL, enter your root password when you will be prompted for:

apt-get -y install mysql-server

     Once MySQLis installed, start it:

systemctl start mysql

I do advise you to add Mysql service at startup to execute it automatically:

systemctl enable mysql

Let's secure your mysql installation, execute the following command:

mysql_secure_installation

I advise you to setup the following parameters:

Do not enforce the use of the password plugin
Do not change the root password
Remove anonymous access
Disable remote access for the root user
Remove the test database
Reload the privileges

Now that the setup of the database is done, we need to add the prerequisites for the mangos database configuration. We need to start by creating an user for mangos, login to the database using:

mysql -u root -p

Create the user you wish, the example given is creating an user 'mangos' who can connect from the 'localhost' and has the password 'password' (do not forget the ';') at the end:

CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'password';

We then need to grant privileges to that user that we can use it later to setup the Mangos schemas (again, do not forget the ';' symbol):

GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost';

Exit the terminal:

quit

Congratulations, you have setup the pre-requisites for the database on Ubuntu !

Install Mangos:

We are now at the interesting part, how do we install Mangos on Ubuntu ? Well, assuming you are logged in as 'root', go to the home directory:

cd ~

Now, we can download our installer:

wget https://raw.githubusercontent.com/mangoszero/server/master/linux/getmangos.sh

Set the permissions to be allowed to execute it:

chmod 700 getmangos.sh

And execute it:

./getmangos.sh

Before we go further, some explanations on the available activities:

• Install Prerequisites will install all the necessary dependencies for you to build & run mangos. Toggled by default.
• Set Download And Install Paths will allow you to specify where the sources must be downloaded and where the binaries must be installed. Toggled by default.
• Clone Source repositories will help you cloning the Mangos sources. Toggled by default.
• Build MaNGOS will assist you in the building process of MaNGOS. Toggled by default.
• Install MaNGOS will help you installing MaNGOS. Toggled by default.
• Install Databases will assist you in the database schemas creation. Toggled by default.
• Extract Resources will help you to extract the DBC, maps, mmaps and vmaps from the game client. Toggled by default.
• Create Code::Blocks Project File will create a project for the Code::Blocks editor. Do not toggle this option if you don't plan to edit the MaNGOS sources.

Now that you know everything, let the default options selected and select 'Ok' thanks to the Tab key. The script is now installing the necessary dependencies on your Ubuntu. You will be prompted to provide your agreement to install the build dependencies. Select 'Yes' two times.

User selection:

Mangos provides you the opportunity to run it under another user than the 'root' one. This is a good practice to isolate softwares and limit the security impact in case of an exploited vulnerability. The default proposed run user is 'mangos' but you can change if you wish. Select 'Ok' to continue.

If you have already performed this step, the installer will ask you whether you want to keep that user. I advise you to reply 'Yes' except if you know what you are doing.

Choose WoW Release:

The next screen is requesting you to choose the WoW release you are willing to install. Select the one you that fits your wish and select 'Ok'.

Source-Code Path:

The next screen is asking you to provide the source path. By default, the proposed format is /home/<run user>/<wow version>/src. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero/src

Reply 'Yes' to create the directory if it does not exist. If it does exist and contains sources, the installer will ask you whether you want to delete the content or not.

Installation Path:

The next screen is asking you to provide the installation path. This is the location from where you will execute the Mangos processes. By default, the proposed format is /home/<run user>/<wow version>. For instance, for a run user 'mangos' and a wow version 'Vanilla', the proposed path will be:

/home/mangos/zero

If it does exist and contains compiled sources, the installer will ask you whether you want to delete the content or not.

Clone or update MaNGOS:

The next step of the script is asking you whether you want to clone, update or use an existing copy of the MaNGOS sources. For a fresh installation, select the option '0 Clone a fresh copy of MaNGOS'. The installer will now connect to Github and check the available development branch, currently, the last stable release is the Rel21 and is hosted in the 'master' branch.

The installer is now cloning the server and database repositories.

Build Options:

You are now at the build step. Some explanations over this screen:

• Enable Debug will setup debug flags and more tracing on Mangos. Use this build option only if you're requested to to fix a bug. Building a software in debug mode significantly reduces its performances.
• Use Standard Malloc, toggle this option to use the standard memory allocation. Untoggle this option only if you know what you are doing.
• Use External ACE libraries. Allows you to use the ACE libraries coming from your system. Untoggle this option only if you know what you are doing.
• Use PostgreSQL insteald of MySQL/MariaDB. Allows you to use another database provider than the default one. This option has not been tested and, if you have followed the tutorial so far, you should have setup MySQL 😉
• Build Client Tools will build the extractors necessary to get dbc, maps, mmaps and vmaps out of the game client. Unselect this option only if you already have these resources extracted.
• Use SD3 will allow you to build the ScriptDev3 Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on C++ scripts.
• Use Eluna will allow you to build the Eluna Engine provided with MaNGOS. We advise you to keep this option toggled except if you don't like living world based on LUA scripts.

Select 'Ok' to proceed with the build process and confirm that would want to build MaNGOS. The installer is now building MaNGOS. Depending on the speed of your system, you have the time to drink a glass of water or a cup of coffee. 🙂

Installation:

You will now be prompted to install Mangos. Select 'Yes' to install it.

Database Operations:

Wait.. another database setup ?! Yes, but this time, we are populating the database with the mangos data. You have three options here:

• Install clean databases to setup a fresh database
• Update existing databases to update your old version of the database
• Skip database work... but it wouldn't make sense 🙂

Select the first option if you are performing a fresh installation. You will be prompted to select your type of database. If you followed the guide so far, you should select "MySQL". The installer will then request your database information, if you followed the guide, you need to provide the following input:

Hostname: localhost
Port: 3306
User: mangos
Password: password

You can now choose into several options:

• ReInstall the realm database, containing all the realms information and the accounts
• ReInstall the world database, containing all the world configuration
• ReInstall the characters database, containing all the characters information
• Update the realmlist to setup an initial game server

By default, all options must be toggled. The installer will now perform the database import.

Extract Game Data:

This step will copy the extractors to the wow game location, extract dbc, maps, mmaps and vmaps and copy these extracted data to your installation directory. The installer will automatically look for a suitable WoW client into your /home directory. If it doesn't find anything, you will have to provide your game location path. If the provided path doesn't contain any game data, the installer will exit.

The extractor steps allows you to select the artifacts you want to extract:

• DBC and Maps, which are the minimum set of data you need to extract
• Mmaps which are the movement maps, based on vectoriel calculation, required for an efficient pathfinding
• Vmaps which are the virtual maps, used for collision detection and LoS detection

The Mmaps extraction is taking several hours, you will have the time to sleep or drink several coffees. 🙂

Congratulations !

You almost did it ! Still few steps to perform before you can play on your preferred game. First of all, you need to switch to your run user. If you used mangos, the command will look like:

su - mangos

You need then to go to the configuration directory of your installation, if you installed Vanilla, it will look like the following command:

cd /home/mangos/zero/etc

Copy the realmd.conf.dist and mangosd.conf.dist files to their expected name:

cp realmd.conf.dist realmd.conf
cp mangosd.conf.dist mangosd.conf

Edit the realmd.conf and find the line LoginDatabaseInfo. Provide your database information, according to this guide and if you have installed Vanilla, it should look like:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"

Save your file and edit the file mangosd.conf. You need to provide the database information for the three database we have configured with our installer:

LoginDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_realm"
WorldDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_world"
CharacterDatabaseInfo = "127.0.0.1;3306;mangos;password;zero_characters"

Save your file and go back to the 'root' user:

exit

Make sure it keeps running !

What could be cooler than having the MaNGOS server starting automatically with your server ? Not much... so let's configure systemd to do so ! First of all, we need to tell it that we have two new services. Declare them by creating the corresponding files:

touch /etc/systemd/system/realmd.service
touch /etc/systemd/system/mangosd.service # Or give it a better name like zero.service if it's a vanilla gaming server for instance.

Now, edit the /etc/systemd/system/realmd.service file and add the following content (Replace the installation path and the run user by the settings you have provided during the installation):

[Unit]
Description=Realmd service
After=network.target mysql.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/realmd -c /home/mangos/zero/etc/realmd.conf
Restart=on-abort

[Install]
WantedBy=multi-user.target

Save this file and edit the /etc/systemd/system/mangosd.service file (or the better name you gave to it) with the following content (same remark than above the installation path and the run user):

[Unit]
Description=WoW Vanilla service
After=network.target mysql.service getty@tty3.service

[Service]
Type=simple
User=mangos
ExecStart=/home/mangos/zero/bin/mangosd -c /home/mangos/zero/etc/mangosd.conf
WorkingDirectory=/home/mangos/zero/bin
StandardInput=tty
TTYPath=/dev/tty3
TTYReset=yes
TTYVHangup=yes
Restart=on-abort

[Install]
WantedBy=multi-user.target

We are almost there ! You now need to tell systemd to reload its configuration:

systemctl daemon-reload

And let's start our processes to verify that they work:

systemctl start realmd
systemctl start mangosd

To verify that it worked, execute the following command:

systemctl status realmd
systemctl status mangosd

If it's working properly, you should have an output indicating you the success status for both service. The last step is to tell systemd to execute them at startup, for this, execute the following commands:

systemctl enable realmd
systemctl enable mangosd

Congratulations ! You are now done with the MaNGOS setup on Ubuntu 16.04 :-) You can now reboot your computer to verify that everything is indeed started:

reboot

Guide is fully tested on MaNGOS Zero with bots module enabled.

Check the video with installation process:

https://asciinema.org/a/299001

If you do not want to use LXD, simple pass LXD instruction and go further.

Let's start

LXD installation & configuration:

sudo apt install lxd && reboot

Reboot is needed for reloading groups that will be assigned to your account.

sudo lxd init

with above command anserw defaults to all questions.

Create container for our server:

lxc launch ubuntu:bionic mangos-zero

check if your container is running:

lxc list
+-------------+---------+-----------------------+-----------------------------------------------+------------+-----------+
|   NAME      |  STATE  |         IPV4          |                     IPV6                      |    TYPE    | SNAPSHOTS |
+-------------+---------+-----------------------+-----------------------------------------------+------------+-----------+
| mangos-zero | RUNNING | *.*.*.* (eth1)        |                                               | PERSISTENT | 3         |
+-------------+---------+-----------------------+-----------------------------------------------+------------+-----------+

now we will connect to our container:

lxc exec mangos-zero bash

Please verify that you are on your contierner, you should have promt like this

root@mangos-zero:~#

if not you must try again with previous command providing your container name.

MaNGOS server installation

Install necessary packages:

apt install git make cmake libssl-dev libbz2-dev build-essential default-libmysqlclient-dev libace-6.4.5 libace-dev mysql-server

We need also install additional mysql package. I've attached file in this post so you don't need to search it.

Download this file and send to your container. Open another terminal window and type:

lxc file push /DOWNLOADED_DIRECTORY/mysql-apt-config_0.8.14-1_all.deb mangos-zero/root/

Go back to first terminal where you are logged to your container and type:

dpkg -i /root/mysql-apt-config_0.8.14-1_all.deb

on installation window check mysql 5.7 is selected and hit Enter, when window will close type:

apt update && apt full-upgrade -y

When all packages are installed, secure your mysql installation.

Please type and anserw to few questions to secure your mysql server.

mysql_secure_installation

Create new username and password to access our mysql server:

mysql
GRANT ALL ON *.* to 'mangos'@'localhost' IDENTIFIED BY 'set_database_password';

Getting MaNGOS source code, compile and configuration.

We will create new folder for sources:

mkdir /opt/mangos && cd /opt/mangos

Now we will download server and database sources to created folder.

MaNGOS zero source (if you want different mangos version please change mangoszero to different repo name):

git clone https://github.com/mangoszero/server.git --recursive --depth 1

Database files:

git clone https://github.com/mangoszero/database.git --recursive --depth 1

Compiling MaNGOS (if your CPU have less than 4cores change -j4 to -j2 for two core CPU):

cd server && mkdir build && cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/bin/mangos && make -j4 && make install

above command will create build folder, compile and install compiled server.

Database installation:

cd /opt/mangos/database && chmod -R +x *.sh && ./InstallDatabases.sh

above command will fix script permissions and install your database.

GameData files extraction:

This can me done inside or outside the container, choice is yours how you do it. Remember that extraction take some time, so go take a cup of tea/coffe and cookie and wait. (ETA 1-2h)

We need proper files for exctraction, go to your mangos installation and copy those files to yor game client:

cd /usr/local/bin/mangos/bin/ && chmod -R +x *.sh && cp -av tools/* ExtractResources.sh MoveMapGen.sh mmap_excluded.txt offmesh.txt /GAME_CLIENT_DESTINATION

now go to your game client and run:

./ExtractResources.sh

Server configuration:

First we have to fix path to MaNGOS configruation. We can do this in config files or simply creating a symlink. In this tutorial we will create symlink to keep defaults.

cd /usr/local/bin/mangos/ && ln -s ../etc

Now we have to copy config files:

cd etc/ && cp -av mangosd.conf.dist mangosd.conf && cp -av realmd.conf.dist realmd.conf

In realmd.conf find "LoginDatabaseInfo" and change database username and password to credentials we created before.

In mangosd.conf find "LoginDatabaseInfo", "WorldDatabaseInfo", "CharacterDatabaseInfo" and change database username and password to credentials we created before.

Systemd configuration:

Create systemd configuration to autostart your realmd and mangosd. In LXD I recommend to run mangosd in screen, we prepare such a configuration in this tutorial.

Realmd service:

cat > /etc/systemd/system/realmd.service <<EOF
[Unit]
Description=MangosZ server
After=network.target mysql.service

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/mangos/bin/realmd -c /usr/local/bin/mangos/etc/realmd.conf
WorkingDirectory=/usr/local/bin/mangos/bin/
Restart=on-abort

[Install]
WantedBy=multi-user.target
EOF

Mangosd service:

cat > /etc/systemd/system/mangosd.service <<EOF
[Unit]
Description=MangosZ server
After=network.target mysql.service

[Service]
Type=simple
User=root
#ExecStart=/usr/local/bin/mangos/bin/mangosd -c /usr/local/bin/mangos/etc/mangosd.conf
ExecStart=/usr/bin/screen -mdS mangosd /usr/local/bin/mangos/bin/mangosd -c /usr/local/bin/mangos/etc/mangosd.conf
WorkingDirectory=/usr/local/bin/mangos/bin/
PIDFile=/usr/local/bin/mangos/etc/mzero.pid
RemainAfterExit=true
Restart=on-abort

[Install]
WantedBy=multi-user.target
EOF

Reload systemd with:

systemctl daemon-reload

Enable services for autostart:

systemctl enable realmd
systemctl enable mangosd

Start services:

systemctl start realmd
systemctl start mangosd

Checking status of running services:

systemctl status realmd
systemctl status mangosd

If you want to attach to mangosd console, simply type:

screen -r mangosd

to detach mangosd screen press keyboard combination:

CTRL+A+D

Update IP address in database, so you can connect to your server:

mysql realmd -h localhost -u mangos -p

check your values in realmlist table

select address,localAddress from realmlist;
+---------------+---------------+
| address       | localAddress  |
+---------------+---------------+
| 192.168.1.180 | 192.168.1.180 |
+---------------+---------------+

then update address and localAddress values with two query (replace IP_ADDRESS with yours)

update realmlist set address='IP_ADDRESS';
update realmlist set localAddress='IP_ADDRESS';

Last thing is to restart both services and try to connect.

At the end I wan't to share with you LXD container image, I made this tutorial based on it. Container do not include GameData so you have to extract it by yourself.

MaNGOS-Zero LXD container based on Ubuntu 18.04

How to use it? Download the file and type in terminal (you must have LXD)

lxc image import mangoszero-serv.tar.gz --alias mangosz-img
lxc launch mangosz-img mangos-zero

mysql-apt-config_0.8.16-1_all.deb

Hi everyone,

I re-write the procedure since there are many questions about linux install procedure.
Many of them are no more applicable today and the  getmangos.sh script needs rework as I write this article.

PREREQUISITES

I am assuming you are running your server on a Linux Operating system with Ubuntu Server 18.04 flavor.

Your OS should be up to date. If not, log in as root and run :

apt update && apt upgrade

PART 1 : Configuring the environment

This tuto will use the MaNGOS zero repo URL but it is replicable with all of our cores repos. Just change the git repo URL and you will be fine.

> Creating system user

Be sure you have created a Linux user for your server, since it is not a good idea to run it as root for obvious security reasons.

We will then assume you have created a mangos linux user using the command : 

adduser mangos

To be more handy you can add this user to the sudoers in order to be able to run administrative commands.

usermod -aG sudo mangos

After this point, be sure to be logged-in as mangos Linux user. We do not need root account anymore (or perhaps once or twice.. but..never mind ! do not use root when not needed)

> Installing useful programs

MaNGOS requires some libraries to be built and to run properly. 

We also need some programs to run further commands or simply to handle some scripts which are in the repo (e.g : python scripts O_o)

apt install git make cmake libssl-dev libbz2-dev build-essential default-libmysqlclient-dev libace-6.4.5 libace-dev python

> Preparing your system folders

A good practice is to separate locations for the needs :

• sources, db sql files and build folder under the mangos system user : /home/mangos/
• binaries, confs, logs, gamedata in /opt/

Thus you can create the folders when logged-in as mangos system user :

mkdir /home/mangos/sources
mkdir /home/mangos/build
mkdir /home/mangos/db

Then the /opt/ folder is only accessible to root so you need to use sudo and impersonate root to make things there.
The aim to to create a fodler using the root account then giving the good rights to be able to use it with the mangos system user.

The opt folder will a have a wow subfolder in which the mangos folder will be. It would let you install other cores if you want to (Trinitycore, Cmangos etc..) all should be installed in /opt.

sudo su
cd /opt/
mkdir wow
chown -R mangos:root wow
chmod g+s wow
exit

Now you will have a wow folder in /opt/ that will be writable by the mangos system user.

Create all necessary useful folders to handle future files using mangos system user : 

cd /opt
mkdir wow/install && mkdir wow/install/mangos && mkdir wow/install/mangos/bin && mkdir wow/install/mangos/bin/logs && mkdir wow/install/mangos/conf 
cd /opt/wow && mkdir gamedata && mkdir gamedata/1.12 && mkdir gamedata/1.12/mangos

> Getting Game data

Since MaNGOS is an educationnal project we will not redistribute exctracted game data.

In order to be able to run your server, you will need to extract these data from your game folder using the extractor programs that are built when you build the project.

To run the server the best way, you will have to extract :

• dbc
• maps
• vmaps (takes a long time)
• mmaps (takes a long time)

Please remind to put all extracted data on the folders you pre-created on previous steps.

If you work with a VM you can use Linux extractors against a shared game folder betwwen your PC and the Linux VM, or if you have the Game folder on your server, you will have to use extractors in this folder.

More information on this topic : 

PART 2 : Getting the sources & Compiling the core

Note that we always use the mangos system user.

Get into your source folder :

cd /home/mangos/sources

Retrieve the sources (WARNING do not forget to get them recusrsively !!) :

git clone https://github.com/mangoszero/server.git . --recursive --depth=1

Well, that good now we are going to build the solution.

/!\ WARNING ABOUT ACE DEPENDENCIES  /!\
It is possible that the build fails due to he ACE linked sources in the "dep" folder. It is related to a bug between Linux build and Windows build.
The main "server" repository is set to refer to a speficif commit that allows by default a correct build on Windows. If you are on Linux you will probably have to manuall pull & checkout the "dep" folder (wich is a git submodule) : 

cd /home/mangos/sources/dep
git pull
git checkout master

Keep in mind that this example show a default build. You can tweak teh buidl option in cmake to build or not some parts of the software.

cd /home/mangos/build
cmake ../sources/ -DCMAKE_INSTALL_PREFIX=/opt/wow/install/mangos -DCONF_INSTALL_DIR=/opt/wow/install/mangos/conf

When it's finished, depending on the number of your cores you will adapt the following make command :

make -j<NbCores>
(e.g : for an intel i7 octocore you can tupe  'make -j8')

The build process should begin, and when it's finished, you will have to install the built binaries : 

make install

After that, all binaries and default conf files woudl have been copied to their destination folders which you have set in the previous cmake command.

PART 3 : Installing MySQL

First things first : you have to install MySQL server.

With Ubuntu Server 18.04 the reference MySQL version is 5.7.30 (this statement is valid at the date when this guide is written, it can evolve in the future).

To install mysql-server :

sudo apt install mysql-server

After installation, you may wonder : "Why the program did not ask me for a root password ?".

Well, on new MySQL versions, the default auth protocol is set to "auth_socket" but all our software will use a password to connect to the database.

Don(t worry, we are going to create a user that would be able to authenticate with standard credentials :

sudo su
mysql

Now you are logged-in to mysql command prompt with the root account. you will notice no password was asked to you because roto user uses auth_socket protocol to authenticate.

Now you are going to create the MySQL mangos user :

CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'mangos';
GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost' WITH GRANT OPTION;

The "WITH GRANT OPTION" is not mandatory but can be useful for future use if you want to administer other users with this mangos account.

Then leave MySQL command prompt and root shell :

exit;
exit

PART 4 : Database Setup

> Main databases (auth, characters, world)

You first have to clone the database repo in the db folder :

cd /home/mangos/db/
git clone https://github.com/mangoszero/database.git . --recursive --depth=1
./InstallDatabases.sh

You will be prooted a screen with several questions :

You will also be prompted to determine your dabases names.

A good practice is to set the realm db name to : mangos_auth, and also to suffix all others db names with the core versions you are running  (e.g characters db for mangos zero : mangos_characters0 , world db : mangos_world0 )

Note : you need only 1 realm database if you run several cores (mangos zero, mangos one etc..) on teh same server, BUt you will need 2 db (characters and world) for each core you run.

> Apply database updates

On a fresh install, World updates should also be applied.

In order to see if it is Ok, check on the World db (the process is the same for other databases) : connect to mysql using mangos user :

mysql -u mangos -pmangos mangos_world0
SELECT * FROM db_version ORDER BY VERSION DESC, structure DESC, content DESC LIMIT 0,1;
exit;

If the return show you the same version that the most recent file in the World/Updates/Rel21 folder. You are OK.

The version number alwas increase so it will be easy to determien if your version/structure/content is ok or not.

If not, then go to the World update folder (World/Updates/Rel21) and apply missing updates to the databases.

mysql -u mangos -pmangos mangos_world0 < nameOfUpdateSQlFile.sql

> Translations

In case you run a non english speaking server, you can apply translation fiels to the world database.

You will find the correct sql files to apply in the Translations folder :

cd /home/mangos/overload/db/Translations

Since I cannot ensure the Linux scripts are working, here is how to do manually : Apply the 3 first .sql files in teh folder :

mysql -u mangos -pmangos mangos_world0 < 1_LocaleTablePrepare.sql
mysql -u mangos -pmangos mangos_world0 < 2_Add_NewLocalisationFields.sql
mysql -u mangos -pmangos mangos_world0 < 3_InitialSaveEnglish.sql

Of course you will have to replace the db name "mangos_world0" with your db name etc... if you have changed default db names and user and password

You will need to go to the translation folder of the desired language (e.g for French language ) :

cd /home/mangos/db/Translations/Translations/French

The more easy solution would be to compile all files in one and import it

cat *.sql > full.sql
mysql -u mangos -pmangos mangos_world0 < full.sql
rm full.sql

There, your translations should be applied.

PART 5 : Configuring *.conf files for executables

Go to the conf folder an create a copy of each .dist file :

cd /opt/wow/install/mangos/conf/
cp realmd.conf.dist realmd.conf && cp mangosd.conf.dist mangosd.conf

Change database connection information in each file in order to allow your binaries to connect to the database.

Update your game data path in mangosd.conf too.
Update the logs folder to "logs" value (relative to binary)

A lot of behaviours can be configured in these files. Please consider studying it carefully.

PART 6 : Auto-restarting

When operating a game server it is nice to use an auto-restarter.

Otherwise, you will have to keep up 2 terminals for realmd and mangosd.

./opt/wow/install/mangos/bin/realmd

and

./opt/wow/install/mangos/bin/mangosd 

That can be really annoying because daemons would be killed after terminal exit.

Read this article to know how to use a restarter on Linux operating systems : 

PART 7 : Final comments

> Nice to have

When your system is running, you could perhaps check : 

• Do you have a DB backup system ? You can easily put one in place with a CRON job  
• Do you have a backup system for your conf files ?
• Do you have a flushing system for the server log files if you keep them timestamped ?

> About errors at core start-up

You can have some DB errors at startup like this one :

It means you have applied DB updates beyond core expectation but since it is only content related, it is not a big issue.

The core would not start id the version or structure is different, but the core can start with a content mismatch.

> How to first connect whith default accounts ?

If you have any questions - please ak on the forum on on Discord when anybody is connected  

Cheers !

I recently installed MaNGOS(Zero) on Ubuntu 22.04 and thought it would be nice to share my step-by-step guide with you. You can use this guide for all cores, just replace GIT repository URL accordingly.

_______________________________________________________________________________________________________________________________

PREREQUISITES

You should have a running server with Ubuntu Server 22.04 operating system.

Before starting with the guide you should update the OS:

sudo apt update && apt upgrade

Upgrading to higher release of Ubuntu Server is on own risk. You should backup your DB before!

Also you will need an installation of the game client with the addons installed for which you would like to create the server for.

_______________________________________________________________________________________________________________________________

PREPARATION

1. Create system user to be used for installation, if not already available. We will use in the guide a specific user named "mangos":

adduser mangos

1.1 You can add root rights to the user, otherwise you need to execute some parts of the guide with root:

usermod -aG sudo mangos

2. Install usefull tools for this guide

MaNGOS requires some libraries to be built and to run properly. We also need some programs to run further commands or simply to handle some scripts which are in the repo (e.g : python scripts).

sudo apt install git make cmake libssl-dev libbz2-dev build-essential mariadb-server mariadb-client default-libmysqlclient-dev libace-dev python2 net-tools screen gdb

3. Create folder structure

You can structure your fodlers as you like, you just have to take care to change the folder names accordingly in the scripts below. I try to seperate the different components and wanted to have the option to install different cores in parallel.

You can check your user name with the command:

whoami

If you are using user "mangos", go to the home directory.

cd ~

Then create folders:

mkdir ~/mangos
mkdir ~/mangos/zero
mkdir ~/mangos/zero/db
mkdir ~/mangos/zero/bin
mkdir ~/mangos/zero/gamedata
mkdir ~/mangos/zero/logs

4. prepare database

Login to the MariaDB with:

sudo mysql

4.1 create a new user for mangos

Execute the follwoing create statement in the DB, replace <password> with a secret password which you can remember. Also grant the user with all required DB rights (very powerful rights, so don't share this user with anybody):

CREATE USER 'mangos'@'localhost' IDENTIFIED BY '<password>';
GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost' WITH GRANT OPTION; 
exit; 

Afterwards you are able to login to MariaDB with new user:

mysql -u mangos -p<password>

_______________________________________________________________________________________________________________________________

INSTALL DATABASE

1. Go to the db folder and download the database from the GIT repository. If you want to install a different version, exchange the url accordingly:

cd ~/mangos/zero/db
git clone https://github.com/mangoszero/database.git --recursive

2. This will create a new sub-folder database and downloads all required tools and scripts to install the database for the Mangos core selected. Go to new sub-folder and start installation script:

cd ~/mangos/zero/db/database
bash ./InstallDatabase.sh

You will see the following screen:

3. Press "N" to start process. It should automatically identify your MariaDB installed on your server.

3.1 In general you can accept the default values in brackets, but following information needs to be set correctly:

• The user name for MariaDB: mangos
• The password for the user to allow scritp to create all required tables: <password>
• Set the names for DB schemas (it's recommended to use separate schemas for characters and world for each core, so adjsut the numbering if needed)
  • Character DB: mangos_character0 (0 - Classic; 1 - TBC; 2 - WOTLK; ...)
  • World DB: mangos_world0
  • Realm DB: mangos_auth (Note: you just need one Realm DB, even if you run multiple cores on your server!)

After providing all informaion, the script will install all databases and tables.

3.2 To configure the database, get at first your IP address by executing the command:

ifconfig

Note down your IP and open MariaDB again:

mysql -u mangos -p<password>

You can check the realmlist with the following SQL, note down the proper ID of the server you want to configure:

select * from realmlist;

Update the realmlist with proper name and IP address, use the right ID:

UPDATE realmlist SET name = “<Your Server-Name>” WHERE id = <ID>;
UPDATE realmlist SET address = “<Server-IP address>” WHERE id = <ID>;

The database is now ready!

_______________________________________________________________________________________________________________________________

BUILD MANGOS

Next we will install the server related to the Mangos core DB you installed before.

1. Go to the core version folder and download the server from GIT repository (don't forget to change the URL to appropriate core version, if needed). It creates a new sub-fodler "server" and stores all data in it:

cd ~/mangos/zero/
git clone https://github.com/mangoszero/server.git --recursive

2. Build the core

After download, we have to build the core by executing e.g. the following command:

cmake -S ~/mangos/zero/server/ -B ~/mangos/zero/build/ -DBUILD_MANGOSD=1 -DBUILD_REALMD=1 -DBUILD_TOOLS=1 -DUSE_STORMLIB=1 -DSCRIPT_LIB_ELUNA=1 -DSCRIPT_LIB_SD3=1 -DPLAYERBOTS=1 -DPCH=1

3. The script creates all necessary build files and stores then in the sub-folder "build". If it's done we can switch to the folder and build/install mangos (a server with minimum 2 cores/cpus is recommended):

make -j<# of CPUs assigned to your server>
make -j<# of CPUs assigned to your server> install

4. Copy server files to our "bin" folder after the install scripts finished successfully:

cd ~/mangos/zero/build/install/bin
cp mangosd ~/mangos/zero/bin/ && cp realmd ~/mangos/zero/bin/

5. Copy game extractor files to our "gamedata" folder:

cp ./tools/*-extractor ~/mangos/zero/gamedata/
cp ./tools/*.sh ~/mangos/zero/gamedata/
cp ./tools/offmesh.txt ~/mangos/zero/gamedata/

_______________________________________________________________________________________________________________________________

EXTRACT GAMEDATA

You will require an iinstallation of the game client on your local machine and a sFTP connection to your server to copy whole game fodler to the server. Safe the client in folder: ~/mangos/zero/gamedata/! If this is done you can continue.

1. Go to "gamedata" folder and change executable rights to extractor script and make all files read-/writeable:

cd ~/mangos/zero/gamedata
chmod -R a+w ~/mangos/zero/gamedata
chmod a+x ExtractResources.sh

2. Execute the Extractor Script and follwo the onscreen instructions (minimum of 4 GB RAM is required, recommended are 8 GB):

• extract everything (dbc, maps, mmaps, vmaps)
• choose all CPUs available on your server to extract MMaps (1-4)
• extract MMaps without delay

After starting the process it will take a lot of time to complete. If the message "Finished creating MoveMaps" appears it's done. Check that no errors occured!

3. Clean up unnecessary files, you can delete all folders and files from "gamedata" folder except:

• dbc
• maps
• mmaps
• vmaps

_______________________________________________________________________________________________________________________________

CONFIGURE SERVER

1. Go to main server folder and copy server config files:

cd ~/mangos/zero
cp -R ~/mangos/zero/build/etc ./
cd etc

2. In the folder "etc" you find now all config files, copy the default files for editing and use by the server:

cp ahbot.conf.dist ahbot.conf
cp mangosd.conf.dist mangosd.conf
cp realmd.conf.dist realmd.conf
cp aiplayerbot.conf.dist aiplayerbot.conf

3. You should edit all files according to your needs, especially the db connection information. For comfortable editing use "nano":

nano <filename>

4. Start script for services to run the server:

cd ~/mangos/zero/bin
nano wowadmin.sh

Insert into the file the following script and save (replace the "/path/to/your/realmd" and "mangosd" to proper path, if you changed them:

5. Start the server with command:

bash wowadmin.sh start

_______________________________________________________________________________________________________________________________

PLAY GAME

1. update your realmlist.wtf in your game client folder.

• you can find the file in your %WoWDir%\realmlist.wtf
• Set the realmlist to your new IP (you should save the old realmlist.wtf as backup):

set realmlist <IP of your server>

2. The standard users are accessible directly, if server is up and running:

• User: PLAYER - Password: PLAYER
• User: ADMINISTRATOR - Password: ADMINISTRATOR
• User: GAMEMASTER - Password: GAMEMASTER
• User: MODERATOR - Password: MODERATOR

3. To create a new account, go to your server and execte command:

cd ~/mangos/zero/bin
bash wowadmin.sh wmonitor

In the world monitor console, enter the following commands:

account create <account name> <password>
account set addon <account name> #

replace <account name> with new name and set a proper password, also grant the addons to be used for the user by changing # to a proper number: 0 - Classic; 1 - TBC; 2 - WOTLK; ...)

To exit the monito, press CTRL +a +d at the same time.

firewall-cmd --zone=public --permanent --add-port=3724/tcp
firewall-cmd --zone=public --permanent --add-port=8085/tcp
firewall-cmd --reload

Please, anyone with permissions to write to closed topics, add this to the linux setup topic if possible. Thank you.

Client Side: You will need version 3.3.5a (Wrath of The Lich King) of the client for this server setup.

Hardware specs used for this guide:

Quad-core CPU
8 Gigs of RAM
120 Gb HDD

Step 1: Install the OS

Install base Ubuntu server with updates.
There are a ton of tutorials on how to do that: YouTube Tutorials

Step 2: Install required packages

apt-get install git make cmake libssl-dev libbz2-dev build-essential default-libmysqlclient-dev libace-dev python mysql-server

Step 3: Setup the database

mkdir ~/mangos/
mkdir ~/mangos/db
cd ~/mangos/db/
mysql
CREATE USER 'mangos'@'localhost' IDENTIFIED BY 'mangos';
GRANT ALL PRIVILEGES ON *.* TO 'mangos'@'localhost' WITH GRANT OPTION;
exit;
git clone https://github.com/mangostwo/database.git --recursive
cd database
./InstallDatabases.sh

Select N - Next Step when prompted and fill out the host details.
You will also be prompted to determine your databases names.
A good practice is to set the realm database name to:

mangos_auth

Also to suffix all others database names with the core versions you are running:
Examples - mangos_characters2 and mangos_world2

Note: You only need one realm database if you run several cores (M0, M1, etc..) on the same server.
But you will need two databases (characters and world) for each additional core.

mysql
USE mangos_auth;
UPDATE realmlist SET name = "ServerNameGoesHere" WHERE id = "1";
UPDATE realmlist SET address = "ServerWANIPAddressHere" WHERE id = "1";
exit;

Step 4: Download and compile mangos

cd ~/mangos
git clone https://github.com/mangostwo/server.git --recursive
cmake -S ~/mangos/server/ -B ~/mangos/build/
cd ~/mangos/build
make -j<# of CPUs/Cores>
make -j<# of CPUs/Cores> install

Step 5: Copy files

mkdir /srv/mangos
mkdir /srv/mangos/bin
mkdir /srv/mangos/gamedata/
cd install/bin
cp mangosd /srv/mangos/bin/
cp realmd /srv/mangos/bin/
cp tools/*-extractor /srv/mangos/gamedata/
cp tools/*.sh /srv/mangos/gamedata/
cp tools/offmesh.txt /srv/mangos/gamedata/
	<Aquire gamedata files and copy them to /srv/mangos/gamedata>

<Optional simple FTP setup>

apt-get install vsftpd

vi /etc/vsftpd.conf
	Change: listen=NO to YES
	Uncomment: write_enable=YES
	Add the line: local_root = <path to gamedata folder>

service vsftpd restart
chmod -R a+w /srv/mangos/gamedata

<End optional FTP setup>

cd /srv/mangos/gamedata
chmod a+x ExtractResources.sh
./ExtractResources.sh <This bit takes forever.>

Step 6: Setup and Configure *.conf files

cp -R ~/mangos/build/etc /srv/mangos/
cd /srv/mangos/etc
cp ahbot.conf.dist ahbot.conf
cp mangosd.conf.dist mangosd.conf
cp realmd.conf.dist realmd.conf  Update realmd.conf <read file comments for details>
Update mangos.conf <read file comments for details>

Suggested tweaks:

LogLevel = 1 (Default is 3)
GameType = #
Server realm style
	0 = NORMAL; 1 = PVP; 4 = PVE; 6 = RP; 8 = RPPVP
RealmZone = <read file comments for details>
Ra.Enable = 1 (Default is 0) <This will allow you to remotely access the server console>
	*Use putty in a raw mode to connect to port 3443 of the server.

Step 7: Start services

You can start these processes in other ways but I recommend this screen method for starting out. Using screen will allow you to run multiple processes in the background from the same terminal without the need to stay logged in.

screen -S realm -d -m ./realmd
screen -S mangos -d -m ./mangosd

Step 8: Play the game

Update %WoWDir%\Data\enUS\realmlist.wtf
	set realmlist <Server Hostname or IP Address>

Open the desktop client and log in with one of the premade user accounts.

	USERNAME		PASSWORD
	ADMINISTRATOR		ADMINISTRATOR
	GAMEMASTER		GAMEMASTER
	MODERATOR		MODERATOR
	PLAYER			PLAYER

Optional Step 9: Add users

 From the running mangos server instance: <This is where a remote Putty session comes in handy.>

account create <username> <password>
account set addon <username> #
	(0 - Normal, 1 - The Burning Crusade, 2 - Lich King)

After setting-up your server on a Linux-based distro, you may wonder : 

• how to let the realmd & mangosd deamons run on your server with all consoles closed ?
• how to automatically restart theses daemons if they crash ?
• how to restart theses dameons ?
• how to get access to the daemons consoles after having closed all your terminals ?

Well, you are at the right place !

PREREQUISITE

The "screen" app must be installed and also "gdb" in order to correctly dump chrash data :

sudo apt install screen gdb

PART 1 : Localize your bin folder

Go to a folder where you would like to install the script.

By default mangso should be installed in :

/opt/wow/install/mangos/bin

PART 2 : Creating the file

Create a file called wowadmin.sh.

touch wowadmin.sh

Make it executable :

chmod +x wowadmin.sh

Paste the code below in the file  and change the variables "/path/to/your/realmd" and "/path/to/your/mangosd" as your real paths to realmd and mangosd :

#!/bin/bash

THIS_FULLPATH=$(cd `dirname "${BASH_SOURCE[0]}"` && pwd -P)/`basename "${BASH_SOURCE[0]}"`
THIS_FOLDERPATH=$(cd `dirname "${BASH_SOURCE[0]}"` && pwd -P)

APATH=/path/to/your/realmd
WPATH=/path/to/your/mangosd
ASRV_BIN=realmd         #This usually doesnt change. TrinityCore: authserver  MaNGOS: realmd  ArcEmu: whocares?
WSRV_BIN_ORG=mangosd    #This usually doesnt change. TrinityCore: worldserver MaNGOS: mangosd ArcEmu: whocares?
WSRV_BIN=mangosd
WSRV_SCR=mangosd

echo "run" > gdbcommands
echo "shell echo -e \"\nCRASHLOG BEGIN\n\"" >> gdbcommands
echo "info program" >> gdbcommands
echo "shell echo -e \"\nBACKTRACE\n\"" >> gdbcommands
echo "bt" >> gdbcommands
echo "shell echo -e \"\nBACKTRACE FULL\n\"" >> gdbcommands
echo "bt full" >> gdbcommands
echo "shell echo -e \"\nTHREADS\n\"" >> gdbcommands
echo "info threads" >> gdbcommands
echo "shell echo -e \"\nTHREADS BACKTRACE\n\"" >> gdbcommands
echo "thread apply all bt full" >> gdbcommands

DEBUG=false

#WORLD FUNCTIONS
startWorld()
{
    if [ "$(screen -ls | grep $WSRV_SCR)" ]
    then
        echo $WSRV_BIN is already running
    else
        cd $WPATH
        screen -AmdS $WSRV_SCR $THIS_FULLPATH $WSRV_BIN $DEBUG
        echo $WSRV_BIN is alive
    fi
}

restartWorld()
{
    screen -S $WSRV_SCR -X stuff "saveall$(printf \\r)"
    echo saved all characters, and server restart initialized
    screen -S $WSRV_SCR -X stuff "server restart 5$(printf \\r)"
}

stopWorld()
{
    screen -S $WSRV_SCR -X stuff "saveall
    "
    echo saveall sent, waiting 5 seconds to kill $WSRV_BIN
    sleep 5
    screen -S $WSRV_SCR -X kill &>/dev/null
    echo $WSRV_BIN is dead
}

monitorWorld()
{
    echo press ctrl+a+d to detach from the server without shutting it down
    sleep 5
    screen -r $WSRV_SCR
}
#AUTH FUNCTIONS
startAuth()
{
    if [ "$(screen -ls | grep $ASRV_BIN)" ]
    then
        echo $ASRV_BIN is already running
    else
        cd $APATH
        screen -AmdS $ASRV_BIN $THIS_FULLPATH $ASRV_BIN
        echo $ASRV_BIN is alive
    fi
}

stopAuth()
{
    screen -S $ASRV_BIN -X kill &>/dev/null
    echo $ASRV_BIN is dead
}

restartAuth()
{
    stopAuth
    startAuth
    echo $ASRV_BIN restarted
}

monitorAuth()
{
    echo press ctrl+a+d to detach from the server without shutting it down
    sleep 5
    screen -r $ASRV_BIN
}

#FUNCTION SELECTION
case "$1" in
    $WSRV_BIN )
    if [ "$2" == "true" ]
    then
        while x=1;
        do
            gdb $WPATH/$WSRV_BIN --batch -x gdbcommands | tee current
            NOW=$(date +"%s-%d-%m-%Y")
            mkdir -p $THIS_FOLDERPATH/crashes
            mv current $THIS_FOLDERPATH/crashes/$NOW.log &>/dev/null
            killall -9 $WSRV_BIN
            echo $NOW $WSRV_BIN stopped, restarting! | tee -a $THIS_FULLPATH.log
            echo crashlog available at: $THIS_FOLDERPATH/crashes/$NOW.log
            sleep 1
        done
    else
        while x=1;
        do
            ./$WSRV_BIN
            NOW=$(date +"%s-%d-%m-%Y")
            echo $NOW $WSRV_BIN stopped, restarting! | tee -a $THIS_FULLPATH.log
            sleep 1
        done
    fi
    ;;
    $ASRV_BIN )
        while x=1;
        do
            ./$ASRV_BIN
            NOW=$(date +"%s-%d-%m-%Y")
            echo $NOW $ASRV_BIN stopped, restarting! | tee -a $THIS_FULLPATH.log
            sleep 1
        done
    ;;
    "wstart" )
    startWorld
    ;;
    "wdstart" )
    DEBUG=true
    startWorld
    ;;
    "wrestart" )
    restartWorld
    ;;
    "wstop" )
    stopWorld
    ;;
    "wmonitor" )
    monitorWorld
    ;;

    "astart" )
    startAuth
    ;;
    "arestart" )
    restartAuth
    ;;
    "astop" )
    stopAuth
    ;;
    "amonitor" )
    monitorAuth
    ;;
    
    "start" )
    startWorld
    startAuth
    ;;
    "stop" )
    stopWorld
    stopAuth
    ;;
    "restart" )
    restartWorld
    restartAuth
    ;;
    * )
    echo Your argument is invalid
    echo "usage: start | stop | restart | wstart | wdstart | wrestart | wstop | wmonitor | astart | arestart | astop | amonitor"
    exit 1
    ;;
esac

PART 3 : How to use ?

You can use the script with its options like :

./wowadmin.sh start

Available options are :

• start : Starts realmd and mangosd - in a screened process.
• stop : Stops realmd and mangosd - in a screened process.
• restart : Retarts realmd and mangosd - in a screened process.
• wstart : Starts only mangosd - in a screened process.
• wdstart : Starts only mangosd in DEBUG mode - in a screened process.
• wrestart : Restarts only mangosd - in a screened process
• wstop : Stops mangosd - screened process.
• wmonitor : Brings back the mangosd console from the screened process (press "Ctrl+A+D" to re-detach it).
• astart : Starts only realmd - in a screened process.
• arestart : Restarts only realmd - in a screened process.
• astop : Stops only realmd - in a screened process.
• amonitor : Brings back the realmd console (press "Ctrl+A+D" to re-detach it).

Moreover, when there is a crash, the daemons will auto-restart dans there will be a crashlog dumped in "crashes" directory next to your deamons executable binaries.

For your information, you can see the screened processes by typing :

screen -ls

You can use multiple wowadmin.sh files if you manage multiple realms but the more simple would be to add specific options in the same script for your differents mangosd dameons as there could be only 1 realmd daemon running and many mangosd daemons running.

Source : adapted from  Lillecarl Gist