- ETHEOS
Visual Studio 2017 or 2019 is required for the compiler toolchain in order to build on Windows. You will need to select the "Desktop Development with C++" workload when installing. Windows 10 SDK is required for the ODBC (SQL server) driver libraries (can be installed as part of Visual Studio).
⚠️ If you have previously attempted to build eoserv using MinGW on Windows, please uninstall MinGW as it conflicts with the standard libraries provided by Visual Studio.
⚠️ You must use git to clone the repository. Downloading the zip and trying to build the source from there is not supported due to the fact that there is an ICO file that is stored in git-lfs, which is an invalid format when downloaded via the zip file.
You may download git for Windows from: https://git-scm.com/downloads. Most users will want to use the installation defaults. If you don't know what a setting means during installation, do not change it.
The following commands must be run on a new system
-
git lfs installa. This command only needs to be run once per machine.
-
git clone https://github.com/ethanmoffat/etheos.git -
cd etheos
The build and dependency install scripts may now be run from the etheos directory.
The dependencies for building ETHEOS on Windows are:
- CMake (>= 2.8.2)
- SQLite
- MariaDB
- vswhere
- git (for getting bcrypt/googletest components)
A convenience script has been provided which installs Chocolatey (package manager) and each of the required dependencies. To automatically install the dependencies, run .\scripts\install-deps.ps1 as administrator or from an elevated powershell terminal. Examine the script contents to view the options for running this script.
Run .\build-windows.ps1 in a new powershell terminal to build the source with support for all available database engines (default: SQL server) and install the project into a local directory (default: install) under the repository root. To compile with support for all database engines, run .\build-windows.ps1 -SqlServer ON -MariaDB ON -Sqlite ON . -Debug can be added to the command-line arguments to build in debug mode, otherwise, release mode is used.
If you are experiencing issues related to unary_function and are using C++11 or later, please include the header in your socket.hpp file.
// In socket.hpp
#include <functional> // Resolve unary_function issues
This process has been tested on Ubuntu 18.04 and 20.04 (including WSL/Windows Subsystem for Linux).
The dependencies for building ETHEOS on Linux are:
- g++
- CMake (>= 2.6)
- SQLite
- MariaDB
- git (for getting bcrypt/googletest components)
- ODBC (SQL server) [optional]
A convenience script has been provided which installs each of the required dependencies. To automatically install the dependencies, run sudo ./scripts/install-deps.sh. Examine the script contents to view the options for running this script.
Run ./build-linux.sh -i to build the source with support for all available database engines (default: SQL server) and install the project into a local directory (default: install) under the repository root.
A docker image is available on docker hub at darthchungis/etheos. Environment variables in the form of ETHEOS_### (all uppercase, case-sensitive) may be used to set configuration options. These options will override what is set by default in the configuration files.
For example:
docker pull darthchungis/etheos
docker run -it --rm -e 'ETHEOS_PORT=8079' -p 8079:8079 -v .\install\data:/etheos/data -v .\install\config_local:/etheos/config_local darthchungis/etheos:latest
⚠️ Configuration and data files need to be placed before executing.
From the local install directory, run the ETHEOS executable (.\etheos.exe on Windows or ./etheos on Linux).
Development within Visual Studio Code (vscode) is supported. The following vscode extensions are recommended:
Integration tests have been added under src/test/integration. These are integration test scripts that are run via EOBot.
These tests are run as part of the release pipeline that deploys the sample server to etheos.moffat.io:8078 (see below section). However, they may also be run locally to validate integration scenarios or add more integration test coverage.
Running these integration tests is only supported on Linux. Ubuntu 22.04 is the suggested platform. WSL 2 is supported.
First, download/install the following dependencies (installation instructions are left as an exercise for the user):
- python3
- docker cli
- Please ensure you add your local user to the
dockergroup viasudo usermod -aG docker <username>to avoid running the ci-test script withsudo
- Please ensure you add your local user to the
- EOBot from the latest EndlessClient release
- You may also clone EndlessClient, build the
EndlessClient.Linux.slnfile, and reference the EOBot output directory
- You may also clone EndlessClient, build the
Then, run the script as follows (where path/to/eobot is the path to the directory container the EOBot executable file):
cd deploy
./ci-test.sh --self-contained --use-local --botdir path/to/eobotThis script will use a self-contained docker environment based on your local repository, build the source + docker image locally (omit --use-local to use the latest public etheos image), and set up an etheos container with a SQLite database backend on port 8078. Integration tests defined in the src/test/integration directory and listed in the exec_tests() function in ci-test.sh will be executed against the local docker container.
For more information on authoring test scripts, see the output of EOBot --help.
Sample servers are hosted in different environments. These servers use SQL Server as a database backend. Servers use default assets from EO v28.
-
moffat.io:8078⚠️ This server is not guaranteed to be running the latest version
-
etheos.moffat.io:8078- This server is deployed on completion of successful CI builds