Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleNote

Before you proceed to install the WSO2 product, ensure that your system meets the minimum hardware and software requirements described in section Installation Prerequisites.

Step 1. Obtain Installation Pack

Download the latest version of the program (for downloading instructions, refer to section Obtaining the Product).

Step 2. Extract the Archive

After the download is complete, extract installation files to the user-defined folder (further to be referred to as PRODUCT_HOME).

Step 3. Set up JAVA_HOME

JAVA_HOME environment variable set up is needed to run WSO2 products. The variable points at the directory where the Java™ Development Kit (JDK) is installed on the computer.

...

2. In the opened CMD, enter the following command and press <Enter>:

Code Block

set JAVA_HOME=<JDK_INSTALLATION_PATH>

...

Note
titleNotice

A variable set via the SET command under CMD is a local variable, available to the current CMD session only.

Step 4. Verify JAVA_HOME Set Up

Follow the instructions below to check if JAVA_HOME was set up correctly:

...

2. In the opened CMD window, enter the following command and press "Enter":

Code Block

set JAVA_HOME

3. The program shows that JAVA_HOME is set to the JDK installation path, for example, JAVA_HOME=:c\Program Files\java\jdk1.6.0_27.
This means that JAVA_HOME was set up correctly.

Step 5: Set up the Environment and Tools

Maven:

WSO2 product builds are based on Apache Maven 2. Hence, it is a prerequisite to have Maven (version 2.1.0 or later) and JDK (version 1.5.x) installed in order to build the product from the source distribution. Extensive instructions on using Maven 2 are available on the Maven website.

...

Once Maven is properly installed, you can start building the Application Server.

Step 6: Build the WSO2 Product

  1. Download the product's source distribution, which is available as a ZIP archive. For more information, refer to section Obtaining the Product.
  2. Expand the source archive to a directory of your choice.
  3. All the necessary build scripts are included with the source distribution.
  4. You can run the following command inside that directory to build the product. Note that you will require a connection to the Internet for the Maven build to download dependencies required for the build.
Code Block

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.

Info
titleNote

The first time you run Maven it will automatically download the dependent JAR files. Therefore the first run will take more time.

Step 7: Running the Product

The WSO2 product is installed and environment variables are set up. Proceed to section Running the Product for instructions on how to access the Management Console.