Child pages
  • Building OpenIG from the Source Code
Skip to end of metadata
Go to start of metadata

Working with the OpenIG Project

This page contains information required to obtain and build the source code for the project. You may want to do this if you want to modify the code, debug behaviour or just look at the source. If you just want to try OpenIG, it will be easier for you to head over to Backstage and download the ForgeRock produced enterprise release binaries. 

Build Environment

Install the following on the machine you're going to build on;

OpenIGJava JDK VersionMavenGit
3.0.0, 3.1.0, 4.0.0 & 4.5.07 and above3.0 and above1.7.6 or above
5.07 and above3.2.51.7.6 or above

You should also set the following environment variables for the majority of versions;

JAVA_HOME - set to the directory in which your SDK is installed
M2_HOME - set to the directory in which maven in installed.
M2 - set to the bin directory in which the maven executable is found.
MAVEN_OPTS  - set to '-Xmx1g -XX:MaxPermSize=512m'

Getting the Code

To browse the project, commits and source, login to the Stash server using your ForgeRock Backstage Username (not email address!) and Password.

ForgeRock's Stash server is here;

https://stash.forgerock.org/projects/OPENIG

If you want to work with the code in a read only manner, i.e. you just want to build code, you don't want to modify the code and contribute your changes back to the project, then you can clone the above repository directly;

git clone https://stash.forgerock.org/scm/openig/openig-public.git

Git will ask you for your backstage username (not email address!) and password and clone the repository to your machine.

Building the Code

The code is built using Maven. 

Building the Latest Code ( master branch )

 

$ cd $REPO_HOME/openig-public
$ git checkout master
$ mvn clean install

 

Building the Enterprise Releases

The enterprise releases are marked in the OpenIG repository as tags. The process is similar to building the master branch ( the latest code ) but you will need to create a branch from the tag first. This is done using the -b option when doing the checkout as can be seen below;

 

$ cd $REPO_HOME/openig-public
$ git checkout -b releases/4.0.0 4.0.0 
$ mvn clean install

 

That code checks out the tag 4.0.0 into the releases/4.0.0 branch. Other tags may be treated in the same way. 

  • No labels