This guide provides instruction for installing midPoint development snapshot. This is the very bleeding edge of midPoint development. We try really hard to have continuous iterative and incremental development and we pay great care not to break anything and have all imrpotant tests passing at any moment during the development. However, unexpected things happen. Parts of the development snapshot may behave in a strange fashion, there may be unfinished things and some things may be broken. You are going into uncharted territory. There be dragons. You have been warned.

This guide provides instruction for installing midPoint from the source code. It requires basic software development tools and some experience to build the product. This is recommended only for engineers that want to test the latest development version of midPoint and for developers who would like to participate in midPoint development. Everybody else will probably find installing from the binary build much easier.

Before You Start

Please make sure to see Release Notes for list of environments that are known to work and for the list of known issues in current release.

Prerequisites

Java Development Kit 11

OpenJDK 11 is recommended Java Development Kit (JDK) to build and run midPoint. JDK 8 will work for midPoint 4.0.x, but it is a deprecated environment. JDK 11 is strongly recommended.

JAVA_HOME environment variable should point to the JDK installation path.

Git

The midPoint source is available from a Git server. The details regarding Git, Git client software and Git server locations are described in Git page. Short summary of Git coordinates is provided in the following table.

GitHub project pagehttps://github.com/Evolveum/midpoint
Git Repository URLs
(public access)

https://github.com/Evolveum/midpoint.git

git@github.com:Evolveum/midpoint.git

Branchmaster

Maven

Download and install Apache Maven 3.6 or later: http://maven.apache.org/download.html

M2_HOME environment variable should point to the Maven installation path.

MidPoint 4.0.1 and later can be build only by using Apache Maven 3.6 or later.

Prepare MidPoint Software

Get MidPoint

Get the source from our Git repository

git clone https://github.com/Evolveum/midpoint.git

For more information about the source repository structure see Source Code.

Build MidPoint From Sources

Enter the directory with downloaded source code and execute either of the following commands:

mvn install

Complete build process also includes unit and integration tests and more than one hour. You can speed up the build by skipping automatic tests using the following command:

mvn install -DskipTests=true

After the successful build process there will be a binary distribution package located in dist/target directory.

If the WAR file is all you need you can speed the build even further by skipping the packaging of the distribution archive. Use the following command to turn off theĀ dist maven profile:

mvn clean install -DskipTests=true -P -dist

Please note the minus character (-) before profile name.
The resulting WAR file can be obtained from gui/admin-gui/target/midpoint.war

Run MidPoint


See Also