Getting Help

Get Involved

Project Information

WSO2 Governance Registry Installation Guide

This installation guide provides information on,

the prerequisites for WSO2 Governance Registry

installation instructions

starting up WSO2 Governance Registry

accessing the management console

This document describes the distribution packages available in WSO2
Registry - the binary distribution and the source distribution for more
advanced users. It is followed by simple instructions on how to install and
run WSO2 Governance Registry using the binary distribution and how to build WSO2
Registry using the source distribution.

To build the WSO2 Governance Registry from its source distribution, you will
need Maven 2.1.0 or later

Web browser- To start the Registry Management Console

The Management Console requires you to enable JavaScript of the Web
browser, with MS IE 7, 8 and 9. In addition to JavaScript, ActiveX
should also be enabled with IE. This can be achieved by setting your
security level to medium or lower.

Memory

Minimum memory 1GB

Disk

The installation will require ~200MB excluding space allocated for
log files and Databases.

Operating System

Linux, MS Windows. As the WSO2 Governance Registry is a Java application, it
will generally be possible to run it on other operating systems with
a JDK 1.6 runtime.

Installing on Linux/Unix

The following steps will take you through the linux/unix distribution
installation.

Setting up the Environment and Tools

Maven:

The WSO2 Governance Registry build is based on Apache Maven. Hence, it is a prerequisite
to have Maven (version 2.1.0 or later) and JDK (version 1.6.0_24 or later) installed in
order to build WSO2 Governance Registry from the source distribution. Extensive
instructions on Maven builds are available on the Maven site.

Set the environment variable MAVEN_HOME and add MAVEN_HOME/bin to the
path as well.

Refer to more instructions on how to install Maven in Unix based
operating systems.

MS Windows

Download and run the Apache Maven Windows installer package.

Set the 'Environment Variables' (create the system variable MAVEN_HOME
and edit the path. e.g., "C:\Program Files\Apache Software
Foundation\maven-2.1.0"; path %MAVEN_HOME%\bin)

Make sure that the system variable JAVA_HOME is set to the location of
your JDK, e.g., C:\Program Files\Java\jdk1.6

Run mvn --version to verify that it is correctly installed.

Once Maven is properly installed, you can start building the WSO2
Registry.

Building WSO2 Governance Registry

Download the
source distribution, which is available as a zip archive.

Expand the source archive to a directory of your choice.

All the necessary build scripts are included with the source
distribution.

You can run the following command inside that directory to build the
WSO2 Governance Registry. You will need a connection to the Internet for the Maven
build to download dependencies required for the build.
mvn clean install

This will create the complete release artifacts including the binary and
source distributions in the modules/distribution/target/ directory which can
be installed using the above instructions.

Note: The first time you run Maven it will automatically download the
dependent .jar files. Therefore, the first run will take more time.