diff options
Diffstat (limited to '_docs/Installation.md')
| -rw-r--r-- | _docs/Installation.md | 204 |
1 files changed, 0 insertions, 204 deletions
diff --git a/_docs/Installation.md b/_docs/Installation.md deleted file mode 100644 index 45c9611..0000000 --- a/_docs/Installation.md +++ /dev/null @@ -1,204 +0,0 @@ -This tutorial explains how to compile and install AzerothCore in your host system. - -Alternatively, it is also possible to [use AzerothCore with Docker](https://github.com/azerothcore/azerothcore-wotlk/wiki/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](https://github.com/azerothcore/azerothcore-wotlk/wiki/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`) |