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 install
a. 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.
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)
- OCDB (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.
⚠️ 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:
A few sample servers are hosted in different environments. These servers use SQL Server as a database backend.
-
moffat.io:8078
⚠️ This server is not guaranteed to be running the latest version
-
dev.etheos.moffat.io:8078
- This server is updated on each pull request build
-
test.etheos.moffat.io:8078
- This server is updated once integration tests pass (triggered by a CI build after a PR is merged)