Skip to content

How to build

Jump to bottom
Timofey Bryksin edited this page Sep 23, 2016 · 13 revisions

First, make sure that your development environment is set up and ready.

Cloning project

We use git submodules for some of project's dependencies. So, cloning of WMP project is not as trivial as usually. Execute this commands to clone project:

  • git clone
  • git submodule init
  • git submodule update

Configuring Linux environment

  • install JDK 8 (install guide for Ubuntu)
  • install Apache Maven (sudo apt-get install maven for Ubuntu-based distros)
  • install Apache Thrift 0.9.3 (Ubuntu users have to build it from source, instructions here and here)

Configuring Windows environment

  • download and install [JDK 8] (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
  • create JAVA_HOME environment variable pointing to JDK install directory (e.g. C:\Program Files\Java\jdk1.8.0_102)
  • add the path to JDK bin subdirectory (e.g. C:\Program Files\Java\jdk1.8.0_102\bin) to PATH environment variable
  • download Apache Maven binary archive (link) and unpack it somewhere (e.g. C:\Users\username\bin\apache-maven-3.3.9)
  • add the path to Maven bin subdirectory (e.g. C:\Users\username\bin\apache-maven-3.3.9\bin) to PATH environment variable
  • download [Apache Thrift (compiler for Windows)] (https://thrift.apache.org/download), rename it to thrift.exe and put it into some directory which is present in PATH (or make a new directory for it and add it to PATH)

Make sure that JDK and Maven are installed correctly by running command java -version and mvn --version commands.

To build everything run mvn install command in the project root directory.

We use maven profiles to configure artifacts. By default one-tomcat-for-all profile will be used. It means that war-files, created after installation, will be configured to deploy on tomcat "allintomcat" configuration, which can be found in deployment directory. To start the service you have to run this deployment scenario.

Of course, you can use other profiles (like "different-ports" profile) or even create your own. In all that cases you have to run tomcat services separately.

NOTE: We use IntelliJ IDEA (preferably Ultimate Edition) as an IDE. Other IDEs or even no IDE should be used at your own risk.

Clone this wiki locally