Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Follow the instructions below to install WSO2 Application Data Services Server on Windows.

Info
titleNote

Before you install the Application Data Services Server, ensure that your system meets the minimum hardware and software requirements described in Application Server DSS Installation Prerequisites.

...

Table of Contents
maxLevel3
minLevel3
styleborder:1
locationtop
typeflat
separatorpipe

...

Step 1. Obtain Installation Pack

Download the latest version of the program (for downloading instructions, see Obtaining DSS).

Step 2. Extract the Archive

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

Image Removed

Step 3. Set up JAVA_HOME
Anchor
Set up JAVA_HOME
Set up JAVA_HOME

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

Info
titleReference

Environment variables are global system variables accessible by all the processes running under the operating system.

...

Locate the Installation Folder of the Java™ Development Kit (JDK) on the Machine

...

1. In order to set the variable, it is necessary to know the system folder to which JDK is installed. Unless the installation path was changed by the user during the installation process, it is installed into the default folder C:\Program Files\Java. Open the directory C:\Program Files\Java using the browser.

...

There are two ways to set up JAVA_HOME: via "System Properties", or via "Windows Command Prompt".

...

JAVA_HOME Setup via System Properties

...

Follow the instructions below to set up the JAVA_HOME environment variable using "System Properties".

...

Note
titleNotice

Variable set up will be effective for the CMD opened after this operation. In case a CMD was run before the variable was set up, this change will not be effective for it. To ensure the variable set up is effective, and variable value is reset, close and reopen the CMD you will be running Application Server from, or close and reopen the browser (e.g. Total commander) you are going to run the CMD from.

...

JAVA_HOME Setup via Windows Command Prompt (CMD)

...

Alternatively, you can temporarily set the JAVA_HOME environment variable within a Windows command prompt window (CMD).

...

Note
titleNotice

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

...

...

Verify JAVA_HOME Set Up
Anchor
Verify JAVA_HOME Set Up
Verify JAVA_HOME Set Up

...

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

...

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

...

4: Set up the Environment and Tools

Maven:

The WSO2 AS DSS build is based on Apache Maven 2. Hence, it is a prerequisite to have Maven (version 2.1.0 or later) and JDK (version 1.56.x) installed in order to build WSO2 AS DSS 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 Data Services Server.

Step

...

5: Build WSO2

...

DSS

  1. Download the source distribution, which is available as a ZIP archive from URL: http://wso2.org/downloads/dss
  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 WSO2 ASDSS. Note that you will require a connection to the Internet for the Maven build to download dependencies required for the build.
    Command mvn clean install

...

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

...

6: Run

...

DSS Start Script

In order to run Application Server DSS management console, it is necessary to run the DSS start script.

Follow the instructions below:

1. Open the "CMD" prompt. (Click the "Start" -> "Run" and then type "cmd" and click "OK" to run the CMD)

2. Go to ASDSS_HOME\bin via command:

Code Block
cd <AS<DSS_HOME>\bin

For example, cd c:\wso2\wso2aswso2dataservices-42.16.23-src\bin.

3. Execute the following command:

Code Block
wso2server.bat --run

Image Removed

4. Operation log is will be displayed.

Image Removed

Note
titleNote

Make sure no errors occurred.

Step

...

7: Access

...

the GS

DSS is installed, started and environment variables are set up. Proceed to Starting Application Server Management Console on Windows for the Accessing the DSS section for instructions on how to run the AS Management Console.