Event Store
Documentation is available at http://docs.geteventstore.com.
Development is on the branch aimed at the next release (usually prefixed with release-v0.0.0). Please make any pull requests to this branch.
This is the repository for the open source version of Event Store, which includes the clustering implementation for high availability. Information on commercial support and options such as LDAP authentication can be found on the Event Store website at https://geteventstore.com/support.
Building from Source
Event Store is written in a mixture of C#, C++ and JavaScript. It can run either on Mono or .NET, however because it contains platform specific code (including hosting the V8 JavaScript engine), it must be built for the platform on which you intend to run it.
Binaries are available from https://geteventstore.com, however if you want to build it from source, instructions for Windows and Linux are below.
Debug Builds on Linux or Mac OS X
There are two stages to building Event Store. First, a native library used for projections, libjs1
must be built. Following that, the main Event Store project can be built.
If you are running on Mac OS X Yosemite, Ubuntu Linux 14.04 or Amazon Linux 2015.03, it is not necessary to build libjs1
from source. Precompiled binaries are already included in this repository. If you are running a different distribution or version than those listed above, you will need to compile libjs1
yourself.
Compiling libjs1
#####Prerequisites
- git on
PATH
- svn on
PATH
- gcc installed
Instructions (Mac OS X)
From the root of the repository:
scripts/build-js1/build-js1-mac.sh
Instructions (Linux)
From the root of the repository:
scripts/build-js1/build-js1-linux.sh [werror=no]
It may be necessary to include werror=no
as the only parameter to the script if you have a newer compiler which treats warnings appearing as a result of compiling the Google V8 codebase as errors.
Compiling Event Store (Linux and Mac OS X)
From the root of the repository:
./build.sh [<version=0.0.0.0>] [<configuration=release>] [<distro-platform-override>]
Versions must be complete four part identifiers valid for use on a .NET assembly.
Valid configurations are:
- debug
- release
The OS distribution and version will be detected automatically unless it is overridden as the last argument. This script expects to find libjs1.[so|dylib]
in the src/libs/x64/distroname-distroversion/
directory, built using the scripts in the scripts/build-js1/
directory. Note that overriding this may result in crashes using Event Store.
The only supported Linux for production use at the moment is Ubuntu 14.04 LTS. However, since several people have asked for builds compatible with Amazon Linux in particular, we have included a pre-built version of libjs1.so
which will link to the correct version of libc on Amazon Linux 2015.03.
Currently the supported versions without needing to build libjs1
from source are:
- ubuntu-14.04 (Ubuntu Trusty)
- amazon-2015.03 (Amazon Linux 2015.03)
Note that it is no longer possible to build x86 builds of Event Store.
Debug Builds on Windows / .NET
Prerequisites
- .NET Framework v4.0+
- Windows platform SDK with compilers (v7.1) or Visual C++ installed (Only required for a full build)
- git on PATH
- svn on PATH (Only required for a full build)
Building the Event Store
From a command prompt:
build.cmd
— runs the Event Store buildbuild.cmd clean-all
— cleans the repository
Optional parameters (Specified using -ParameterName value
)
-Platform
—x64
(default) orx86
-Configuration
—release
(default) ordebug
-Version
— the semantic version number to give to the release. Defaults to version0.0.0.0
, which should be used for all non-released builds.-SpecificVisualStudioVersion
—2010
,2012
,2013
,Windows7.1SDK
. Default is to use whichever version is installed. This only needs to be overridden if you have multiple versions installed.-ForceNetwork
— true if you want to force the script to get dependencies even if Windows thinks theres no network connection (otherwise we don’t try to avoid sometimes lengthy delays).-Defines
— any additional defines you want to pass to the compiler. Should be enclosed in single quotes
Building the Event Store from Visual Studio
When building through Visual Studio, there are PowerShell scripts which run as pre- and post-build tasks on the EventStore.Common project, which set the informational version attribute of the EventStore.Common.dll assembly to the current commit hash on each build and then revert it.