Page tree
Skip to end of metadata
Go to start of metadata

Development Trunk

This guide provides instruction for installing the most recent development version of midPoint known as trunk (see Source Code). This is recommended only for engineers that want to participate in midPoint development, testing or heavy customization. Everybody else will probably find installing binary release much easier.

Pre-requisites

Java SE Development Kit 6

The development environment requires JDK 6. Recommended is JDK 6 update 11 or above. Update 4 contains the JAX-WS 2.1 but there are some issues, so we suggest something after update 11 or the latest which you can download at http://java.sun.com/javase/downloads/widget/jdk6.jsp

JAVA_HOME environment variable should point to the JDK 6 installation path.

Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 6

The development environment and midPoint in runtime also requires JCE for cryptographic operations. You can download it from Oracle downloads page. After downloading zip file follow installation instructions written in README.txt

Subversion

The midPoint source is available from a Subversion Server (SVN).

If you need an SVN client, it is available at http://www.open.collab.net/downloads/subversion.html

For windows users a nice graphical client is available at http://tortoisesvn.tigris.org

Note: open.collab.net svn client provides command line svn client that is required by maven build. However Tortoisesvn does not support standard command line svn client interface.

Maven

Download and install Maven2: http://maven.apache.org/download.html

M2_HOME environment variable should point to the Maven installation path.

Apache Tomcat

midPoint needs an application server. Currently, Apache Tomcat 6.0.x is supported. More application servers will be supported in later releases.

Apache Tomcat can be downloaded from http://tomcat.apache.org/download-60.cgi. The Apache Tomcat installation directory is further referenced as <tomcat>.

Prepare midPoint software

Get midPoint

Get the revision-1.10 source from our SVN repository using the URL: https://svn.evolveum.com/midpoint/tags/midpoint-1.10/

svn checkout https://svn.evolveum.com/midpoint/tags/midpoint-1.10/

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
  • for building without automatic tests
    mvn install -DskipTests=true
    
    After the successful build process, there will be a new WAR file located in gui/admin-gui/target/idm.war.

The build process has been tested with Maven 2.2.1, but may work with Maven 3.0 too.

Deploy midPoint

Continue with installation like binary release Installing midPoint from Binary Release - 1.10, but you need to use your own WAR from gui/admin-gui/target/idm.war.

  • No labels