Versions Compared

Key

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

...

Apache Maven v.2.1.0 or later is recommended for WSO2 products.

Info
titleNote

Refer to Installation Prerequisites for the list of all applications necessary to install and work with the WSO2 product you plan to install.

Follow the instructions below to set up Apache Maven.

Step 1. Check Java

Make sure you have a JDK installed on your system. Refer to Apache Maven System Requirements for details.

Step 2. Download Apache Maven

1. Open a Web browser and access the following URL:

...

3. The link redirects to the storage page of different download pack versions. Choose the version suitable for Windows.

...

Apache Maven versionImage Added

4. The link redirects to the page suggesting a mirror site for the download. Follow the link on the page.

...

Apache Maven buildImage Added

5. The download Save dialog box opens. Click "OK."

...

Apache Maven downloadImage Added

6. The download starts.

Step 3. Extract the Archive

After the download is complete, extract installation files to the user-defined folder. For example, c:\wso2\apache-maven-3.0.3.

...

Apache Maven HOMEImage Added

Step 4. Set up M2_HOME

In order to run Apache Maven, it is necessary to set up M2_HOME environment variable, and add "bin" to PATH variable. The variable points to the directory where Apache Maven is installed on the computer.

Info
titleReference

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

Locating the Apache Maven Installation Folder

In order to set the variable, it is necessary to know the Maven installation folder. Using a browser (e.g. Total Commander) open the user-defined directory to which Apache Maven archive was extracted (See Step 2). This is the path to Apache Maven installation folder.

Setting M2_HOME

Follow the instructions below.

1. Right-click the "My Computer" icon on the desktop and select "Properties" from the pop-up menu.

Wiki Markup
!Windows-computer-properties.png|alt="Windows computer properties"!

Windows computer propertiesImage Added

2. In the "System Properties" window, go to the "Advanced" tab and click "Environment Variables".

Wiki Markup
!windows-advanced-properties.png|alt="Windows advanced properties"!

Windows advanced propertiesImage Added

3. The "Environment variables" window opens. Click the "New" button under "System variables."

...

Windows new system variableImage Added

 4. The "New system variable" input box opens. Type "variable name": M2_HOME, and "variable value": Maven installation directory.

For example, c:\wso2\apache-maven-3.0.3. Click "OK."

...

Apache Maven HomeImage Added

5. In the "System variables" field select "PATH" and click on the "Edit" button.

...

Apache Maven HomeImage Added

6. The "Edit system variable" dialog opens. Add "<M2_HOME>\bin" without quotes to Variable value, where <M2_HOME> is the Maven installation directory.

For example, c:\wso2\apache-maven-3.0.3\bin.

Click "OK."

...

Apache Maven path variableImage Added

 7. Apache Maven set up is complete successfully.

Info

Make sure that the system variable JAVA_HOME is set to the JDK location.

Step 5. Verify Apache Maven Installation

Follow the instructions below to verify that Apache Maven is set up correctly.

...

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

Code Block
mvn --version
Wiki Markup
!windows-command-maven.png|alt="Apache Maven version"!

Apache Maven versionImage Added

3. Information on current version of Apache Maven and M2_HOME location is displayed. For example,

 

...

Apache Maven versionImage Added

Info
title*"System variables"* or *"User variables"*?

If it is needed to set up variables only for the user currently logged in, JAVA_HOME should be set up in "User Variables" (the same way as in "System variables"). These changes will not affect any other users.

...