trying another way to rootify paths

1 files changed, 204 insertions, 0 deletions

diff --git a/docs/Installation.md b/docs/Installation.md
new file mode 100644
index 0000000..1392422
--- /dev/null
+++ b/docs/Installation.md
@@ -0,0 +1,204 @@
+This tutorial explains how to compile and install AzerothCore in your host system.
+
+Alternatively, it is also possible to [use AzerothCore with Docker](install-with-Docker).
+
+For macOS users: the build on mac is currently broken (see [this issue](https://github.com/azerothcore/azerothcore-wotlk/issues/122)), but you can still use AzerothCore on macOS with Docker.
+
+## 1) Installing the requirements
+
+Make sure your system fits with the [Requirements](Requirements).
+
+
+## 2) Getting the source files
+
+Choose one of the following method:
+
+
+```
+1) Clone only the master branch + full history (smaller size - recommended):
+git clone https://github.com/azerothcore/azerothcore-wotlk.git --branch master --single-branch azerothcore
+
+2) Clone only the master branch + no previous history (smallest size):
+git clone https://github.com/azerothcore/azerothcore-wotlk.git --branch master --single-branch azerothcore --depth 1
+
+3) Clone all branches and all history:
+git clone https://github.com/azerothcore/azerothcore-wotlk.git azerothcore
+```
+
+Note: If you want to get the full history back, use `git fetch --unshallow` (if you chose option 2).
+
+
+## 3) Compiling
+
+### Compiling on GNU/Linux or Mac OS X
+
+```
+cd azerothcore
+mkdir build
+cd build
+```
+
+Before running the CMake command, replace `/home/youruser/azeroth-server/` with the path of the server installation (where you want to place the compiled binaries).
+
+**CMAKE OPTIONS**
+
+Check the options here if you know what you're doing: [CMake options](Cmake-options)
+
+
+**CMake on Linux:**
+
+At this point, you must be in your "build/" directory.
+
+```
+cmake ../ -DCMAKE_INSTALL_PREFIX=/home/youruser/azeroth-server/ -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DTOOLS=0 -DSCRIPTS=1
+```
+
+Then, replacing `4` with the number of threads that you want to execute, type:
+
+```
+make -j 4
+make install
+```
+
+**CMake on Mac OS X:**
+
+```
+cmake ../ -DCMAKE_INSTALL_PREFIX=/home/youruser/azeroth-server/ -DTOOLS=0 -DSCRIPTS=1 -DMYSQL_ADD_INCLUDE_PATH=/usr/local/include -DMYSQL_LIBRARY=/usr/local/lib/libmysqlclient_r.dylib -DREADLINE_INCLUDE_DIR=/usr/local/opt/readline/include -DREADLINE_LIBRARY=/usr/local/opt/readline/lib/libreadline.dylib -DOPENSSL_INCLUDE_DIR=/usr/local/opt/openssl/include -DOPENSSL_SSL_LIBRARIES=/usr/local/opt/openssl/lib/libssl.dylib -DOPENSSL_CRYPTO_LIBRARIES=/usr/local/opt/openssl/lib/libcrypto.dylib
+```
+
+Then, replacing `4` with the number of threads that you want to execute, type:
+
+```
+make -j 4
+make install
+```
+
+### Compiling on Windows
+
+Open CMake , press `Browse Source...` button and select the folder that you cloned earlier then press `Browse Build...` and select a folder where the CMake will generate the build files. Press the `Configure` button.
+
+CMake will ask you to select what compiler to use. For example you'll want to select `Visual Studio 14 2015 Win64` to compile x64 binaries using Visual Studio 2015. Do not change the `Use default native compilers` option. Press `Finish` and wait until CMake is done checking for requires files.  
+
+Change `CMAKE_INSTALL_PREFIX` to the location where you will run your server from.  
+Press `Configure` once again and then press `Generate`. If no error occurred you can close CMake.  
+Go to the location where the build files have been generated and open AzerothCore.sln  
+
+_Note: If MySQL is not found by CMake it is required to set MYSQL_INCLUDE_DIR = C:/mysql_libs/include and MYSQL_LIBRARY= C:/mysql_libs/lib_XX/libmysql.lib._
+_XX depends if you are compiling in 32 or 64 bits mode. ( See [[Windows Requirements article|Requirements#windows]] )_
+
+Press `BUILD` then select `Build solution` or press F6.  
+Wait until the Build has been finished (It should take between 10-40 minutes depending on your hardware).  
+
+You will find your freshly compiled binaries in the Build\bin\Release or Build\bin\Debug folder. These are all used to run your server at the end of this instruction.
+ 
+You will need the following files in order for the core to function properly:
+ 
+```
+libeay32.dll
+libmySQL.dll 
+ssleay32.dll 
+ace.dll
+worldserver.conf.dist
+worldserver.exe 
+authserver.conf.dist 
+authserver.exe
+```
+
+Copy `libeay32.dll` and `ssleay32.dll` from OpenSSL install folder into `CMAKE_INSTALL_PREFIX`.
+
+Copy `libmysql.dll` from your MYSQL_LIBRARY path into `CMAKE_INSTALL_PREFIX`
+
+
+**Note:** Do not use ARM architecture as azerothcore requires SSE2 and ARM doesn't support it.  
+
+
+## 4) Setting the configuration files
+
+Inside the directory where you installed the binaries (e.g. `/home/youruser/azeroth-server/`), open the directory where configuration files has been installed  ( `etc/` on linux ) , then:
+
+- copy the file `authserver.conf.dist` and rename it to `authserver.conf` ( DO NOT REMOVE THE .dist FILE )
+- copy the file `worldserver.conf.dist` and rename it to `worldserver.conf` ( DO NOT REMOVE THE .dist FILE )
+
+_Please Read [How to edit .conf files](how-to-work-with-conf-files.md) article to understand how configuration files work, and why you need the .dist file too_
+
+Open both `authserver.conf` and `worldserver.conf` files and go to the `MYSQL SETTINGS` section, then set the variables:
+
+```
+LoginDatabaseInfo     = "127.0.0.1;3306;root;your_password;auth"
+WorldDatabaseInfo     = "127.0.0.1;3306;root;your_password;world"
+CharacterDatabaseInfo = "127.0.0.1;3306;root;your_password;characters"
+```
+
+replacing `your_password` with the password of your MySQL server root user
+(the `authserver.conf` has the `LoginDatabaseInfo` variable only).
+
+In the worldserver.conf file, also set:
+
+`DataDir = "/home/youruser/azeroth-server/data"`
+
+replacing `/home/youruser/azeroth-server` with the path where you installed the binaries.
+
+
+## 5) Download the data files
+
+Go to the directory of your azeroth server (e.g. `/home/youruser/azeroth-server`) and create a new directory named `data`
+
+Two options to choose from:
+
+#### A) [[Extract Client Data]] from your own WOW client with AzerothCore extractors
+#### B) (Easier) Download directly from mega with the links below:
+
+- [From 03/01/19 to now](https://mega.nz/#F!Am4DBKCR!o9Qj_xFLfsg4sczqg0xq2A) (choose this version if you are installing AzerothCore for the first time)
+- [From 07/18/18 to 03/01/19](https://mega.nz/#!utg3hKJL!TtSzcWxVkvxF4HJvor8LFWhrBwwpH2pHpI-xHGr-HZo) (before commit [59d4e1d3a806a4f2f48f535be366bde1b24d737e](https://github.com/azerothcore/azerothcore-wotlk/commit/59d4e1d3a806a4f2f48f535be366bde1b24d737e)) 
+- For older versions, check out this page's history.
+
+
+
+Extract all the archives and place the extracted `dbc`, `maps`, `mmaps`, `vmaps` directories inside the data directory.
+
+
+## 6) Setting up the database
+
+### Base DB setup
+Follow these instructions: [Database Setup](Database-Setup).
+
+**Note**: by default, database names are configured to be named:
+
+- `acore_characters`
+- `acore_auth`
+- `acore_world`
+
+ if, for some reasons, you decide to name them differently, remember to edit your `authserver.conf` and `worldserver.conf` accordingly.
+
+### Configure your auth.realmlist table
+
+In the `auth` database, you must fill the `realmlist` table with your connection info.
+It must correspond with your configuration file (for realmid, flag and realmzone).
+
+	Address: 127.0.0.1 OR <Your LOCAL NETWORK ip>  OR <Your PUBLIC NETWORK ip>
+	Port :	worldserver port
+
+
+## 7) Starting the servers
+
+### GNU/Linux and Mac OS X
+
+Open 2 terminal windows (or terminal tabs) and move to the `bin` directory of your azeroth server (for example `/home/youruser/azeroth-server/bin`), 
+
+then in one window/tab type:
+
+`./authserver`
+
+in the other one:
+
+`./worldserver`
+
+
+### Windows
+
+Run `worldserver.exe` and `authserver.exe` from `CMAKE_INSTALL_PREFIX`.
+
+
+## 8) Connecting to the server
+
+Edit your `realmlist.wtf` and add the IP you set in the realmlist table (and the port if needed). Then you can connect with a newly made account or the test accounts (`test1` to `test10`, with password `a`)