Project Skyfire - User contributions [en]

Installation (Ubuntu 22.04 LTS)

2024-04-14T17:30:13Z

Silent: Remove append bug since these commands should be repeatable

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz
tar -xvf openssl-1.1.1k.tar.gz
cd openssl-1.1.1k
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed.

For cases where you want to run an even newer release of ACE than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,
start by downloading and unzipping the source:

<pre>
wget https://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-7_1_4/ACE+TAO-7.1.4.tar.gz
tar xvzf ACE+TAO-7.1.4.tar.gz
cd ACE_wrappers/
</pre>

Add an environment variable called ACE_ROOT
<pre>
export ACE_ROOT=$(pwd)
</pre>

Create a configuration file, $ACE_ROOT/ace/config.h
<pre>
echo '#include "ace/config-linux.h"' > $ACE_ROOT/ace/config.h
</pre>

Create a build configuration file, $ACE_ROOT/include/makeinclude/platform_macros.GNU
<pre>
echo 'include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU' > $ACE_ROOT/include/makeinclude/platform_macros.GNU
</pre>

Here is where we compile ACE
<pre>
make
export INSTALL_PREFIX=/usr/local
make install
</pre>
Note: make install will need to be ran by the root user since /usr/local file permissions are usually under root

<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb
dpkg -i mysql-apt-config_0.8.12-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing GCC 9'''
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (BIONIC ONLY !!!)
<pre>
add-apt-repository ppa:ubuntu-toolchain-r/test -y
apt-get update
</pre>
Now we can install gcc-9 and g++-9.
<pre>
apt-get install gcc-9 g++-9
</pre>

Symbolic links cc and c++ are installed by default.
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.
<pre>
update-alternatives --remove-all gcc
update-alternatives --remove-all g++

update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10

update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10
update-alternatives --set cc /usr/bin/gcc
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10
update-alternatives --set c++ /usr/bin/g++
</pre>

The last step is configuring the default commands for gcc, g++.
<pre>
update-alternatives --config gcc
update-alternatives --config g++
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 18.04 LTS)

2024-04-11T02:30:32Z

Silent: Silent moved page Installation (Ubuntu 18.04 LTS) to Installation (Ubuntu 22.04 LTS)

#REDIRECT [[Installation (Ubuntu 22.04 LTS)]]

Installation (Ubuntu 22.04 LTS)

2024-04-11T02:30:31Z

Silent: Silent moved page Installation (Ubuntu 18.04 LTS) to Installation (Ubuntu 22.04 LTS)

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz
tar -xvf openssl-1.1.1k.tar.gz
cd openssl-1.1.1k
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed.

For cases where you want to run an even newer release of ACE than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,
start by downloading and unzipping the source:

<pre>
wget https://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-7_1_4/ACE+TAO-7.1.4.tar.gz
tar xvzf ACE+TAO-7.1.4.tar.gz
cd ACE_wrappers/
</pre>

Add an environment variable called ACE_ROOT
<pre>
export ACE_ROOT=$(pwd)
</pre>

Create a configuration file, $ACE_ROOT/ace/config.h
<pre>
echo '#include "ace/config-linux.h"' >> $ACE_ROOT/ace/config.h
</pre>

Create a build configuration file, $ACE_ROOT/include/makeinclude/platform_macros.GNU
<pre>
echo 'include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU' >> $ACE_ROOT/include/makeinclude/platform_macros.GNU
</pre>

Here is where we compile ACE
<pre>
make
export INSTALL_PREFIX=/usr/local
make install
</pre>
Note: make install will need to be ran by the root user since /usr/local file permissions are usually under root

<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb
dpkg -i mysql-apt-config_0.8.12-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing GCC 9'''
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (BIONIC ONLY !!!)
<pre>
add-apt-repository ppa:ubuntu-toolchain-r/test -y
apt-get update
</pre>
Now we can install gcc-9 and g++-9.
<pre>
apt-get install gcc-9 g++-9
</pre>

Symbolic links cc and c++ are installed by default.
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.
<pre>
update-alternatives --remove-all gcc
update-alternatives --remove-all g++

update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10

update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10
update-alternatives --set cc /usr/bin/gcc
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10
update-alternatives --set c++ /usr/bin/g++
</pre>

The last step is configuring the default commands for gcc, g++.
<pre>
update-alternatives --config gcc
update-alternatives --config g++
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 22.04 LTS)

2024-04-11T02:25:22Z

Silent: - libreadline-gplv2-dev was dropped from Ubuntu after 20.04 so use libreadline-dev

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz
tar -xvf openssl-1.1.1k.tar.gz
cd openssl-1.1.1k
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed.

For cases where you want to run an even newer release of ACE than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,
start by downloading and unzipping the source:

<pre>
wget https://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-7_1_4/ACE+TAO-7.1.4.tar.gz
tar xvzf ACE+TAO-7.1.4.tar.gz
cd ACE_wrappers/
</pre>

Add an environment variable called ACE_ROOT
<pre>
export ACE_ROOT=$(pwd)
</pre>

Create a configuration file, $ACE_ROOT/ace/config.h
<pre>
echo '#include "ace/config-linux.h"' >> $ACE_ROOT/ace/config.h
</pre>

Create a build configuration file, $ACE_ROOT/include/makeinclude/platform_macros.GNU
<pre>
echo 'include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU' >> $ACE_ROOT/include/makeinclude/platform_macros.GNU
</pre>

Here is where we compile ACE
<pre>
make
export INSTALL_PREFIX=/usr/local
make install
</pre>
Note: make install will need to be ran by the root user since /usr/local file permissions are usually under root

<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb
dpkg -i mysql-apt-config_0.8.12-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing GCC 9'''
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (BIONIC ONLY !!!)
<pre>
add-apt-repository ppa:ubuntu-toolchain-r/test -y
apt-get update
</pre>
Now we can install gcc-9 and g++-9.
<pre>
apt-get install gcc-9 g++-9
</pre>

Symbolic links cc and c++ are installed by default.
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.
<pre>
update-alternatives --remove-all gcc
update-alternatives --remove-all g++

update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10

update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10
update-alternatives --set cc /usr/bin/gcc
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10
update-alternatives --set c++ /usr/bin/g++
</pre>

The last step is configuring the default commands for gcc, g++.
<pre>
update-alternatives --config gcc
update-alternatives --config g++
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]