Skip to content
This repository was archived by the owner on Jan 3, 2021. It is now read-only.

Files

Latest commit

ryancheungryancheung
Update installation docs
Dec 10, 2019
85c2be4 · Dec 10, 2019

History

History
115 lines (77 loc) · 5.12 KB

install_linux.md

File metadata and controls

115 lines (77 loc) · 5.12 KB

Install on Linux

Requirements

  1. Get mysql server 5.7 installed

  2. clang: Get the right LLVM repository here. Current supported clang versions are 7 and 8. gcc may work too but is not supported.

  3. Add LLVM key wget -O - http://apt.llvm.org/llvm-snapshot.gpg.key|sudo apt-key add -

  4. Minimal boost version is 1.62

  5. sudo apt-get install clang-7 make cmake libmysqlclient-dev mysql-server mysql-client openssl libssl-dev zlib1g-dev libtool libncurses5-dev patch build-essential git libreadline-dev libbz2-1.0 libbz2-dev libboost-dev libboost-thread-dev libboost-system-dev libboost-filesystem-dev libboost-program-options-dev libboost-regex-dev libboost-iostreams-dev

  6. If you plan to use the option USE_GPERFTOOLS you'll also need packages libgoogle-perftools-dev google-perftools

Compiling The Server

Note that the folder structure I use here is merely a suggestion, but I will assume you're using it to keep these instructions simple

  1. Create a root folder for your emulator installation. I will refer to this folder as <root_install_folder>.
    Inside, create the following folders :

    • build
    • data

  2. Move this repository in the <root_install_folder> as a sources folder, so that the file you're currently reading should be in <root_install_folder>/sources/doc.
    In the <root_install_folder>/build folder, create a script containing :

     cmake -DCMAKE_INSTALL_PREFIX="<root_install_folder>"  ../sources

    Then execute it (also from the build folder). This will create the make files into your build folder.

  3. The server is now ready to be compiled, stay in the same folder and type:
    make install -j <x> where x is a number of processors to use for the compilation.
    This will install the server binaries in <root_install_folder>/bin, and the configurations files in <root_install_folder>/etc

Setting Up The DB

  1. Download the last world database here, extract it to your CMAKE_INSTALL_PREFIX directory.

  2. You may follow the instructions here. Just use the world you just downloaded instead.

Extracting maps, vmaps and dbc

  1. If everything compiled correctly, the following binaries should have been created in your <root_install_folder>/bin folder:

    • mapextractor
    • vmap4extractor
    • vmap4assembler
    • mmaps_generator

    If not, make sure the TOOLS cmake option was enabled when building.
    You'll need a WoW client to extract to use them. Copy all those binaries into the WoW 2.4.3 client folder.

  2. Run mapextractor.exe in the game directory. This will create two directories named maps and dbc.

  3. Run vmap4extractor.exe in the game directory. This will create a directory named Buildings.

  4. Create a directory named vmaps, then run vmap4assembler.exe Buildings vmaps in the game directory.

  5. Create a directory named mmaps, then run mmaps_generator.exe in the game directory.

  6. Move the directories maps, dbc, vmaps and mmaps from your game directory to <root_install_folder>/data. You can delete the Buildings directory generated at step 3.

Install and Configure the Server

  1. The following files have been installed to your <root_install_folder>/etc folder :

    • authserver.conf.dist
    • worldserver.conf.dit

    Rename those files as authserver.conf and worldserver.conf.

  2. Update authserver.conf options:

    • LoginDatabaseInfo: See info in conf file.

  3. Update worldserver.conf options:

    • LoginDatabaseInfo: See info in conf file.
    • WorldDatabaseInfo: See info in conf file.
    • CharacterDatabaseInfo: See info in conf file.
    • LogsDatabaseInfo: See info in conf file.
    • DataDir: Set this your <root_install_folder>/data folder.
    • LogsDir*: Because you'll probably want logs. See info in conf file. I suggest setting this <root_install_folder>/logs (create the folder yourself).

Local realmlist entries are already configured in database for BC and LK, so you don't need to add one yourself for development.

Some dummy accounts are already in the database, from test1 to test5. The password are the usernames.

Running the Server

Just run both the worldserver and the authserver in the <root_install_folder>/bin folder.

Sunstrider also has some generic systemd scripts that you can use, see this directory.