Skip to end of metadata
Go to start of metadata
Table of contents

Homepage:

http://maven.apache.org/

Download:

http://maven.apache.org/download.html

File(s):

apache-maven-2.1.0-bin.zip (2.9 MB) or apache-maven-2.2.1-bin.tar.gz (2.7 MB)

Installation

Windows:

  • Unzip ZIP-file to an appropriate folder (C:\Program Files): New folder is "apache-maven-2.1.0"

Linux:

  • Unzip tar.gz-package
    Terminal
  • New folder is "/usr/local/bin/apache-maven-2.2.1"

Configuration

  • Add "bin" directory to PATH variable

Windows:

  • Start - Settings - Control Panel - System - Advanced - Environment Variables - System variables
  • "Path" - Edit: (add at the beginning of the line): C:\Program Files\apache-maven-2.1.0\bin;...

Ubuntu:

Terminal
  • User - create directory .m2 (located at "${user.home}/). Copy the default settings.xml coming with maven to this location:

Windows

Command Prompt

Linux:

Terminal
  • Maven configuration occurs at 3 levels:
    • Project - most static configuration occurs in pom.xml, should inherit from a company-wide parent pom.xml
    • Installation - this is configuration added once for a Maven installation
    • User - this is configuration specific to a particular user (located at "${user.home}/.m2/settings.xml").

Configuration at a "Global Level" (for all users on a machine) can be done in "${maven.home}/conf/settings.xml"

Local Repository

The location of your local repository can be changed in your user configuration ("${user.home}/.m2/settings.xml").
The default value is "${user.home}/.m2/repository/" (= "~/.m2/repository").

File ${user.home}/.m2/settings.xml

Note: The local repository must be an absolute path.

HTTP Proxy

You can configure a proxy to use for some or all of your HTTP requests in Maven 2.0. The username and password are only required if your proxy requires basic authentication (note that later releases may support storing your passwords in a secured keystore - in the mean time, please ensure your settings.xml file (usually ${user.home}/.m2/settings.xml) is secured with permissions appropriate for your operating system).
The nonProxyHosts setting accepts wild cards, and each host not to proxy is separated by the | character. This matches the JDK configuration equivalent.

File ${user.home}/.m2/settings.xml

Using an intranet mirror repository

Behind the firewall of a company's network it is useful to set up a central repository mirror server (e.g. opensource product "Archiva").

  • Configure this central server in your maven settings file (e.g. "C:\Documents and Settings\<your_username>\.m2\settings.xml"):
File ${user.home}/.m2/settings.xml
  • Remove the configuration sections for local repository and for the http proxy to be sure that only the intranet maven mirror is used!
  • To assure that all dependencies are in the proxy repository, clean your local repository (.m2/repository) and choose "Update Dependencies" in the maven plugin for your project.

Test

Windows:

  • Open a new command prompt window
Command Prompt

The output is the same under Linux:

Terminal

This behaviour is ok, because maven does not find a pom.xml file to process and you didn't specify a goal.

Windows:

Command Prompt

The platform encoding is not "UTF-8". TODO ??? (set to UTF-8)

Linux:

Command Prompt

Documentation

  • No labels