You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by bu...@apache.org on 2012/03/01 17:35:47 UTC
svn commit: r806895 [44/46] - in /websites/staging/maventest/trunk: ./
content/ content/ant/ content/background/ content/css/ content/developers/
content/developers/conventions/ content/developers/release/
content/developers/website/ content/docs/ cont...
Added: websites/staging/maventest/trunk/content/repository-management.html
==============================================================================
--- websites/staging/maventest/trunk/content/repository-management.html (added)
+++ websites/staging/maventest/trunk/content/repository-management.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,240 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Repository Management with Maven Repository Managers</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+ Repository Management with Maven Repository Managers
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/referen
ces/apt-format.html --><div class="section"><h2>The List of Repository Managers<a name="The_List_of_Repository_Managers"></a></h2><p>The Following is a list of the known Maven repository managers and listed in chronological order of appearance in the community:</p><div class="section"><h3><a class="externalLink" href="http://nexus.sonatype.org">Nexus: Maven Repository Manager (previously Proximity)</a><a name="Nexus:_Maven_Repository_Manager_previously_Proximity"></a></h3><p>Anyone who was using Proximity is now encouraged to use Nexus. The entire codebase of Proximity was absorbed into Nexus and Nexus provides a migration path for all Proximity users.</p><p>Tamas Cservenak started working on Proximity in December 2005 as he was trying to find a way to isolate his own systems from an incredibly slow ADSL connection provided by a Hungarian ISP. Proximity started as a simple web application to proxy artifacts for a small organization with connectivity issues. Creating a local
on-demand cache for Maven artifacts from the central Maven repository gave an organization access to the artifacts on the Central Maven Repository, but it also made sure that these artifacts weren't downloaded over a very slow ADSL connection used by a number of developers. In 2007, Sonatype asked Tamas to help create a similar product named Nexus. Nexus is currently considered the logical next step to Proximity. Nexus currently has an active development team, and portions of the indexing code from Nexus are also being used in <a class="externalLink" href="http://m2eclipse.sonatype.org/">m2eclipse</a></p></div><div class="section"><h3><a class="externalLink" href="http://www.jfrog.org/sites/artifactory/latest/">Artifactory</a><a name="Artifactory"></a></h3><p>Artifactory is a Maven 2 enterprise repository. It offers advanced proxying, caching and security facilities to provide a robust, reproducible and independent build environment when using Maven. Artifactory is being use
d by clients ranging from small startup teams to international corporate teams employing distributed development, thus improving the development experience for tens of thousands of developers. Artifactory exposes a robust artifacts management platform using rich Ajax web UI and can be run out-of-the-box with a simple "unzip and launch".</p></div><div class="section"><h3><a class="externalLink" href="http://archiva.apache.org/">Apache Archiva</a><a name="Apache_Archiva"></a></h3><p>Apache Archiva is an extensible repository management software that helps taking care of your own personal or enterprise-wide build artifact repository. It is the perfect companion for build tools such as Maven, Continuum, and ANT.</p><p>Archiva offers several capabilities, amongst which remote repository proxying, security access management, build artifact storage, delivery, browsing, indexing and usage reporting, extensible scanning functionality... and many more!</p></div></div><div cl
ass="section"><h2>Why do I need a Repository Manager?<a name="Why_do_I_need_a_Repository_Manager"></a></h2><p>Maven Repository managers serve two purposes: they act as highly configurable proxies between your organization and the public Maven repositories and they also provide an organization with a deployment destination for your own generated artifacts.</p><p>Proxying a Maven repository brings a number of benefits. Proxying speeds up builds throughout your organization by installing a local cache for all artifacts from the Central Maven repository. If a developer in your organization needs to download version 2.5 of the Spring Framework and you are using a Maven Repository Manager, the dependencies (and the dependency's dependencies) only need to be downloaded from the remote repository once. With a high-speed connection to the Internet this might seem like a minor concern, but if you are constantly asking your developers to download hundreds of megabytes of third-party de
pendencies, the real cost savings are going to be the time it takes Maven to check for new versions of dependencies and to download dependencies. Serving Maven dependencies from a local repository can save you hundreds of requests over HTTP, and, in very large multi-project builds, this can shave minutes from a build.</p><p>If your project is relying on a number of SNAPSHOT dependencies, Maven will need to check for updated version of these snapshots. Depending on the configuration of your remote repositories, Maven will check for SNAPSHOT updates periodically, or it might be checking for SNAPSHOT updates on every build. When Maven checks for a snapshot update it needs to interrogate the remote repository for the latest version of the SNAPSHOT dependency. Depending on your connection to the public Internet and the load on the central Maven repository, a SNAPSHOT update can add seconds to your project's build for each SNAPSHOT update. When you host a local repository proxy wi
th a repository manager, your repository manager is going to check for SNAPSHOT updates on a regular schedule, and your applications will be able to interact with a local repository. If you develop software with a lot of SNAPSHOT dependencies, using a local repository manager can often shave minutes from a large multi-module project build, your 5-10 second SNAPSHOT update checks against the public central repository are going to execute in hundreds of milliseconds (or less).</p><p>In addition to the simple savings in time and bandwidth, a repository manager provides an organization with control over what is downloaded by Maven. You can include or exclude specific artifacts from the public repository, and having this level of control over what is downloaded from the central Maven repository is a prerequisite for organizations which need strict control over what dependencies are used throughout an organization. An organization which wants to standardize on a specific version o
f a dependency like Hibernate or Spring can enforce this standardization by only providing access to a specific version of an artifact in a repository manager. Other organizations might be concerned with making sure that every external dependency has a license compatible with the legal standards of that organization. If a corporation is producing a application which is distributed, they might want to make sure that no one inadvertently adds a dependency on a third-party library which is covered under a copy-left license like the GPL. Repository managers provide for the level of control that an organization needs to make sure that overall architecture and policy can be enforced.</p><p>Aside from the benefits of mediating access to remote repositories, a repository manager also provides something essential to full adoption of Maven. Unless you expect every member of your organization to download and build every single internal project, you will want to provide a mechanism for
developers and departments to share both SNAPSHOT and releases for internal project artifacts. A Maven repository manager provides your organization with such a deployment target. Once you install a Maven repository manager, you can start using Maven to deploy snapshots and releases to a custom repository managed by the repository manager. Over time, this central deployment point for internal projects becomes the fabric for collaboration between different development teams.</p><!-- TODO Link to instructions for configuring repositories and mirrors --><div class="section"><h3>Other resources<a name="Other_resources"></a></h3><ul><li><a class="externalLink" href="http://www.sonatype.com/books/nexus-book/reference/">Chapter on Nexus in Sonatype's <i>Maven: The Definitive Guide</i></a></li><li><a class="externalLink" href="http://docs.codehaus.org/display/MAVENUSER/Maven+Concepts+Repositories">Maven Concepts Repositories</a> from Maven wiki</li><li><a class="externalLink" href="
http://docs.codehaus.org/display/MAVENUSER/Maven+Repository+Manager+Feature+Matrix"> Continuously updated Feature matrix.</a></li></ul></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maventest/trunk/content/repository/index.html
==============================================================================
--- websites/staging/maventest/trunk/content/repository/index.html (added)
+++ websites/staging/maventest/trunk/content/repository/index.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,309 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>
+ Repository Centre</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Brett Porter" />
+ <meta name="author" content="Hervé Boutemy" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href=".././" id="bannerLeft">
+ <img src="../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../index.html">Maven</a>
+ >
+
+ Repository Centre
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="../docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="../license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="../eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="../netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="../maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="../general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="../powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="../run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="../users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="../plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <strong>Maven Repository Centre</strong>
+ </li>
+ <li class="none">
+ <a href="../developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="../guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="../guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="../users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="../source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="../team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- /*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ -->
+
+
+
+ <div class="section"><h2>Maven Repository Centre<a name="Maven_Repository_Centre"></a></h2>
+
+ <p>This documentation centre is for those that need to use or contribute to the Maven repository. This includes those
+ that need dependencies for their own build, notice errors in the repository metadata, or projects that wish to have
+ their releases added to the Maven repository.</p>
+
+<!-- TODO: tasks as buttons?
+ TODO: concepts -->
+
+ <ul>
+ <li><a href="../project-faq.html">Maintaining your Metadata</a> - Information for third-party projects</li>
+
+ <li><a href="../guides/mini/guide-maven-evangelism.html">Guide to Maven Evangelism</a> - Helping to improve
+ the metadata of the dependencies you use</li>
+
+ <li><a href="../guides/mini/guide-central-repository-upload.html">Guide to uploading artifacts</a> - How to
+ get things uploaded to the repository</li>
+ </ul>
+
+<!-- TODO: more documents to link to here. Use the navigation cues (how to upload, how to mirror, etc). -->
+
+ <p>
+ <img src="maven-repositories.png" width="735" height="591" border="0" usemap="#map" alt="" />
+
+ <map name="map">
+ <area shape="rect" coords="192,87,277,119" alt="Apache" href="http://repository.apache.org/content/groups/public/" />
+ <area shape="rect" coords="283,87,387,119" alt="Codehaus" href="http://repository.codehaus.org/" />
+ <area shape="rect" coords="392,87,478,119" alt="OSSRH" href="http://nexus.sonatype.org/oss-repository-hosting.html" />
+ <area shape="rect" coords="544,87,621,119" alt="java.net" href="http://download.java.net/maven/2/" />
+ <area shape="rect" coords="627,87,693,119" alt="JBoss" href="http://repository.jboss.org/maven2/" />
+ <area shape="rect" coords="384,247,445,284" alt="index" href="/maven-indexer/" />
+ <area shape="rect" coords="173,313,304,346" alt="repo" href="http://repo.maven.apache.org/maven2/" />
+ <area shape="rect" coords="332,344,372,376" alt="uk" href="http://uk.maven.org/maven2/" />
+ <area shape="rect" coords="389,344,459,376" alt="ibiblio" href="http://mirrors.ibiblio.org/pub/mirrors/maven2/" />
+ <area shape="rect" coords="305,313,523,391" alt="mirrors" href="http://docs.codehaus.org/display/MAVENUSER/Mirrors+Repositories" />
+ <area shape="rect" coords="260,536,345,569" alt="Maven" href="/what-is-maven.html" />
+ <area shape="rect" coords="347,567,463,589" alt="local repository" href="/guides/mini/guide-configuring-maven.html" />
+ <area shape="rect" coords="434,450,625,482" alt="Repository Manager" href="/repository-management.html" />
+ <area shape="rect" coords="354,493,491,530" alt="settings.xml <mirrorOf>" href="/guides/mini/guide-mirror-settings.html" />
+ <area shape="rect" coords="204,451,279,498" alt="central (default)" href="/guides/introduction/introduction-to-the-pom.html" />
+ <area shape="rect" coords="0,1,734,85" alt="standalone public artifact repositories" href="/guides/introduction/introduction-to-repositories.html" />
+ <area shape="rect" coords="484,534,621,574" alt="pom.xml <repository>" href="/guides/mini/guide-multiple-repositories.html" />
+ </map>
+ </p>
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maventest/trunk/content/repository/maven-repositories.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maventest/trunk/content/repository/maven-repositories.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/staging/maventest/trunk/content/run-maven/index.html
==============================================================================
--- websites/staging/maventest/trunk/content/run-maven/index.html (added)
+++ websites/staging/maventest/trunk/content/run-maven/index.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,264 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Running Maven</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Brett Porter" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href=".././" id="bannerLeft">
+ <img src="../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../index.html">Maven</a>
+ >
+ Running Maven
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="../docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="../license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="../eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="../netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="../maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="../general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="../powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <strong>Running Maven</strong>
+ </li>
+ <li class="collapsed">
+ <a href="../users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="../plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="../developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="../guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="../guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="../users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="../source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="../team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2>Building a Project with Maven<a name="Building_a_Project_with_Maven"></a></h2><p>This document centre is for those that have the source code to a project that builds with Maven, and would like to know how to use Maven to build it (or perform other common tasks).</p><p>The documents here are also helpful to new Maven users.</p><!-- TODO: tasks as buttons? --><ul><li><a href="../download.html"> Download and Install Maven</a> - Download the latest version of Maven and install it</li><li><a href="#Quick_Start"> Quick Start</a> - Get started building the project quickly</li><li><a href="../users/index.html"> Use Maven</a> - Learn how to use Maven on your own project</li></ul><!-- TODO: command line reference? --><div class="section"><h3><a name="Quick_Start">Quick Start</a></h3><div class="section"><h4>Configuring Maven<a name="Configuring_Maven"></a></h4><p>Maven will run with sensible defaults, so you can get right into it. However, if you are o
perating under a restricted environment or behind a firewall, you might need to prepare to run Maven, as it requires write access to the home directory (<tt>~/.m2</tt> on Unix/Mac OS X and <tt>C:\Documents and Settings\username\.m2</tt> on Windows) and network access to download binary dependencies.</p><ul><li><a href="../guides/mini/guide-configuring-maven.html"> Configuring Maven</a></li><li><a href="../guides/mini/guide-proxies.html"> Configuring a HTTP Proxy</a></li></ul></div><div class="section"><h4>Building a Project<a name="Building_a_Project"></a></h4><p>The vast majority of Maven-built projects can be built with the following command:</p><div><pre>mvn clean install</pre></div><p>This command tells Maven to build all the modules, and to install it in the <i>local repository</i>. The local repository is created in your home directory (or alternative location that you created it), and is the location that all downloaded binaries and the projects you built are stored.<
/p><p>That's it! If you look in the <tt>target</tt> subdirectory, you should find the build output and the final library or application that was being built.</p><p><b>Note:</b> Some projects have multiple modules, so the library or application you are looking for may be in a module subdirectory.</p><p>While this will build most projects and Maven encourages this standard convention, builds can be customisable. If this does not suffice, please consult the project's documentation.</p></div><div class="section"><h4>More than just the Build<a name="More_than_just_the_Build"></a></h4><p>Maven can do more than just build software - it can assist with testing, run web applications and produce reports on projects, as well as any number of other tasks provided by plug-ins.</p></div><div class="section"><h4>When Things go Wrong<a name="When_Things_go_Wrong"></a></h4><p>The following are some common problems when building with Maven, and how to resolve them.</p><div class="section"><h5
>Missing Dependencies<a name="Missing_Dependencies"></a></h5><p>A missing dependency presents with an error like the following:</p><div class="source"><pre>[INFO] Failed to resolve artifact.
+
+Missing:
+----------
+1) jnuit:junit:jar:3.8.1
+
+ Try downloading the file manually from the project website.
+
+ Then, install it using the command:
+ mvn install:install-file -DgroupId=jnuit -DartifactId=junit \
+ -Dversion=3.8.1 -Dpackaging=jar -Dfile=/path/to/file
+
+ Path to dependency:
+ 1) org.apache.maven:maven:pom:2.1-SNAPSHOT
+ 2) jnuit:junit:jar:3.8.1
+
+----------
+1 required artifact is missing.
+
+for artifact:
+ org.apache.maven:maven:pom:2.1-SNAPSHOT
+
+from the specified remote repositories:
+ central (http://repo1.maven.org/maven2)</pre></div><p>To resolve this issue, it depends on what the dependency is and why it is missing. The most common cause is because it can not be redistributed from the repository and must be manually installed using the instructions given in the message. This is most common with some older JARs from Sun (usually <tt>javax.*</tt> group IDs), and is further documented in the <a href="../guides/mini/guide-coping-with-sun-jars.html"> Guide to Coping with Sun JARs</a>.</p><p>You can check the list of repositories at the end of the error to ensure that the expected ones are listed - it may be that the project requires an alternative repository that has not been declared properly or is not accessible with your Maven configuration.</p><p>In other cases, it may be an incorrectly declared dependency (like the typo in the example above) which the project would need to fix, like a compilation error.</p><!-- TODO: compilation errors --><!-- TODO:
what are other common problems? --></div></div></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maventest/trunk/content/settings.html
==============================================================================
--- websites/staging/maventest/trunk/content/settings.html (added)
+++ websites/staging/maventest/trunk/content/settings.html Thu Mar 1 16:35:39 2012
@@ -0,0 +1,426 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Mar 1, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Settings Reference</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Eric Redmond" />
+ <meta name="Date-Revision-yyyymmdd" content="20120301" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+ Settings Reference
+ </div>
+ <div class="xright">
+ Last Published: 2012-03-01
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ <li class="none">
+ <a href="powered-by-m2.html">Powered By</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="expanded">
+ <a href="users/index.html">User Centre</a>
+ <ul>
+ <li class="none">
+ <a href="guides/getting-started/maven-in-five-minutes.html">Maven in 5 Minutes</a>
+ </li>
+ <li class="none">
+ <a href="guides/getting-started/index.html">Getting Started Guide</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <strong>Settings Reference</strong>
+ </li>
+ <li class="none">
+ <a href="pom.html">POM Reference</a>
+ </li>
+ </ul>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2>Settings Reference<a name="Settings_Reference"></a></h2><ol style="list-style-type: decimal"><li><a href="#Introduction">Introduction</a><ol style="list-style-type: decimal"><li><a href="#Quick_Overview">Quick Overview</a></li></ol></li><li><a href="#Settings_Details">Settings Details</a><ol style="list-style-type: decimal"><li><a href="#Simple_Values">Simple Values</a></li><li><a href="#Plugin_Groups">Plugin Groups</a></li><li><a href="#Servers">Servers</a><ol style="list-style-type: decimal"><li><a href="#Password_Encryption">Password Encryption</a></li></ol></li><li><a href="#Mirrors">Mirrors</a></li><li><a href="#Proxies">Proxies</a></li><li><a href="#Profiles">Profiles</a><ol style="list-style-type: decimal"><li><a href="#Activation">Activation</a></li><li><a href="#Repositories">Repositories</a></li><li><a href="#Plugin_Repositories">Plugin Repositories</a></li></ol></li><li><a href="#Active_Profiles">Active Profiles</a></li></ol></li><
/ol></div><div class="section"><h2><a name="Introduction">Introduction</a></h2><div class="section"><h3><a name="Quick_Overview">Quick Overview</a></h3><p>The <tt>settings</tt> element in the <tt>settings.xml</tt> file contains elements used to define values which configure Maven execution in various ways, like the <tt>pom.xml</tt>, but should not be bundled to any specific project, or distributed to an audience. These include values such as the local repository location, alternate remote repository servers, and authentication information.</p><p>There are two locations where a <tt>settings.xml</tt> file may live:</p><ul><li>The Maven install: <tt>$M2_HOME/conf/settings.xml</tt></li><li>A user's install: <tt>${user.home}/.m2/settings.xml</tt></li></ul><p>The former <tt>settings.xml</tt> are also called global settings, the latter <tt>settings.xml</tt> are referred to as user settings. If both files exists, their contents gets merged, with the user-specific <tt>settings.xml</t
t> being dominant.</p><p>Tip: If you need to create user-specific settings from scratch, it's easiest to copy the global settings from your Maven installation to your <tt>${user.home}/.m2</tt> directory. Maven's default <tt>settings.xml</tt> is a template with comments and examples so you can quickly tweak it to match your needs.</p><p>Here is an overview of the top elements under <tt>settings</tt>:</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ <localRepository/>
+ <interactiveMode/>
+ <usePluginRegistry/>
+ <offline/>
+ <pluginGroups/>
+ <servers/>
+ <mirrors/>
+ <proxies/>
+ <profiles/>
+ <activeProfiles/>
+</settings></pre></div><p>The contents of the <tt>settings.xml</tt> can be interpolated using the following expressions:</p><ol style="list-style-type: decimal"><li><tt>${user.home}</tt> and all other system properties <i>(since Maven 3.0)</i></li><li><tt>${env.HOME}</tt> etc. for environment variables</li></ol><p>Note that properties defined in profiles within the <tt>settings.xml</tt> cannot be used for interpolation.</p></div></div><div class="section"><h2><a name="Settings_Details">Settings Details</a></h2><div class="section"><h3><a name="Simple_Values">Simple Values</a></h3><p>Half of the top-level <tt>settings</tt> elements are simple values, representing a range of values which describe elements of the build system that are active full-time.</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ <localRepository>${user.home}/.m2/repository</localRepository>
+ <interactiveMode>true</interactiveMode>
+ <usePluginRegistry>false</usePluginRegistry>
+ <offline>false</offline>
+ ...
+</settings></pre></div><ul><li><b>localRepository</b>: This value is the path of this build system's local repository. The default value is <tt>${user.home}/.m2/repository</tt>. This element is especially useful for a main build server allowing all logged-in users to build from a common local repository.</li><li><b>interactiveMode</b>: <tt>true</tt> if Maven should attempt to interact with the user for input, <tt>false</tt> if not. Defaults to <tt>true</tt>.</li><li><b>usePluginRegistry</b>: <tt>true</tt> if Maven should use the <tt>${user.home}/.m2/plugin-registry.xml</tt> file to manage plugin versions, defaults to <tt>false</tt>. <i>Note that for the current version of Maven 2.0, the plugin-registry.xml file should not be depended upon. Consider it dormant for now.</i></li><li><b>offline</b>: <tt>true</tt> if this build system should operate in offline mode, defaults to <tt>false</tt>. This element is useful for build servers which cannot connect to a remote reposit
ory, either because of network setup or security reasons.</li></ul></div><div class="section"><h3><a name="Plugin_Groups">Plugin Groups</a></h3><p>This element contains a list of <tt>pluginGroup</tt> elements, each contains a groupId. The list is searched when a plugin is used and the groupId is not provided in the command line. This list automatically contains <tt>org.apache.maven.plugins</tt> and <tt>org.codehaus.mojo</tt>.</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <pluginGroups>
+ <pluginGroup>org.mortbay.jetty</pluginGroup>
+ </pluginGroups>
+ ...
+</settings></pre></div><p>For example, given the above settings the Maven command line may execute <tt>org.mortbay.jetty:jetty-maven-plugin:run</tt> with the truncated command:</p><div><pre>mvn jetty:run</pre></div></div><div class="section"><h3><a name="Servers">Servers</a></h3><p>The repositories for download and deployment are defined by the <a href="./pom.html#Repositories"><tt>repositories</tt></a> and <a href="./pom.html#Distribution_Management"><tt>distributionManagement</tt></a> elements of the POM. However, certain settings such as <tt>username</tt> and <tt>password</tt> should not be distributed along with the <tt>pom.xml</tt>. This type of information should exist on the build server in the <tt>settings.xml</tt>.</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <servers>
+ <server>
+ <id>server001</id>
+ <username>my_login</username>
+ <password>my_password</password>
+ <privateKey>${user.home}/.ssh/id_dsa</privateKey>
+ <passphrase>some_passphrase</passphrase>
+ <filePermissions>664</filePermissions>
+ <directoryPermissions>775</directoryPermissions>
+ <configuration></configuration>
+ </server>
+ </servers>
+ ...
+</settings></pre></div><ul><li><b>id</b>: This is the ID of the server <i>(not of the user to login as)</i> that matches the <tt>id</tt> element of the repository/mirror that Maven tries to connect to.</li><li><b>username</b>, <b>password</b>: These elements appear as a pair denoting the login and password required to authenticate to this server.</li><li><b>privateKey</b>, <b>passphrase</b>: Like the previous two elements, this pair specifies a path to a private key (default is <tt>${user.home}/.ssh/id_dsa</tt>) and a <tt>passphrase</tt>, if required. The <tt>passphrase</tt> and <tt>password</tt> elements may be externalized in the future, but for now they must be set plain-text in the <tt>settings.xml</tt> file.</li><li><b>filePermissions</b>, <b>directoryPermissions</b>: When a repository file or directory is created on deployment, these are the permissions to use. The legal values of each is a three digit number corrosponding to *nix file permissions, ie. 664, or 77
5.</li></ul><p><i>Note:</i> If you use a private key to login to the server, make sure you omit the <tt><password></tt> element. Otherwise, the key will be ignored.</p><div class="section"><h4><a name="Password_Encryption">Password Encryption</a></h4><p>A new feature - server password and passphrase encryption has been added to 2.1.0+. See details <a href="./guides/mini/guide-encryption.html">on this page</a></p></div></div><div class="section"><h3><a name="Mirrors">Mirrors</a></h3><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <mirrors>
+ <mirror>
+ <id>planetmirror.com</id>
+ <name>PlanetMirror Australia</name>
+ <url>http://downloads.planetmirror.com/pub/maven2</url>
+ <mirrorOf>central</mirrorOf>
+ </mirror>
+ </mirrors>
+ ...
+</settings></pre></div><ul><li><b>id</b>, <b>name</b>: The unique identifier and user-friendly name of this mirror. The <tt>id</tt> is used to differentiate between <tt>mirror</tt> elements and to pick the corresponding credentials from the <a href="#Servers"><tt><servers></tt></a> section when connecting to the mirror.</li><li><b>url</b>: The base URL of this mirror. The build system will use this URL to connect to a repository rather than the original repository URL.</li><li><b>mirrorOf</b>: The <tt>id</tt> of the repository that this is a mirror of. For example, to point to a mirror of the Maven <tt>central</tt> repository (<tt><a class="externalLink" href="http://repo1.maven.org/maven2/">http://repo1.maven.org/maven2/</a></tt>), set this element to <tt>central</tt>. More advanced mappings like <tt>repo1,repo2</tt> or <tt>*,!inhouse</tt> are also possible. This must not match the mirror <tt>id</tt>.</li></ul><p>For a more in-depth introduction of mirrors, plea
se read the <a href="./guides/mini/guide-mirror-settings.html">Guide to Mirror Settings</a>.</p></div><div class="section"><h3><a name="Proxies">Proxies</a></h3><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <proxies>
+ <proxy>
+ <id>myproxy</id>
+ <active>true</active>
+ <protocol>http</protocol>
+ <host>proxy.somewhere.com</host>
+ <port>8080</port>
+ <username>proxyuser</username>
+ <password>somepassword</password>
+ <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
+ </proxy>
+ </proxies>
+ ...
+</settings></pre></div><ul><li><b>id</b>: The unique identifier for this proxy. This is used to differentiate between <tt>proxy</tt> elements.</li><li><b>active</b>: <tt>true</tt> if this proxy is active. This is useful for declaring a set of proxies, but only one may be active at a time.</li><li><b>protocol</b>, <b>host</b>, <b>port</b>: The <tt>protocol://host:port</tt> of the proxy, seperated into discrete elements.</li><li><b>username</b>, <b>password</b>: These elements appear as a pair denoting the login and password required to authenticate to this proxy server.</li><li><b>nonProxyHosts</b>: This is a list of hosts which should not be proxied. The delimiter of the list is the expected type of the proxy server; the example above is pipe delimited - comma delimited is also common.</li></ul></div><div class="section"><h3><a name="Profiles">Profiles</a></h3><p>The <tt>profile</tt> element in the <tt>settings.xml</tt> is a truncated version of the <tt>pom.xml</tt> <t
t>profile</tt> element. It consists of the <tt>activation</tt>, <tt>repositories</tt>, <tt>pluginRepositories</tt> and <tt>properties</tt> elements. The <tt>profile</tt> elements only include these four elements because they concerns themselves with the build system as a whole (which is the role of the <tt>settings.xml</tt> file), not about individual project object model settings.</p><p>If a profile is active from <tt>settings</tt>, its values will override any equivalently ID'd profiles in a POM or <tt>profiles.xml</tt> file.</p><div class="section"><h4><a name="Activation">Activation</a></h4><p>Activations are the key of a profile. Like the POM's profiles, the power of a profile comes from its ability to modify some values only under certain circumstances; those circumstances are specified via an <tt>activation</tt> element.</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <profiles>
+ <profile>
+ <id>test</id>
+ <activation>
+ <activeByDefault>false</activeByDefault>
+ <jdk>1.5</jdk>
+ <os>
+ <name>Windows XP</name>
+ <family>Windows</family>
+ <arch>x86</arch>
+ <version>5.1.2600</version>
+ </os>
+ <property>
+ <name>mavenVersion</name>
+ <value>2.0.3</value>
+ </property>
+ <file>
+ <exists>${basedir}/file2.properties</exists>
+ <missing>${basedir}/file1.properties</missing>
+ </file>
+ </activation>
+ ...
+ </profile>
+ </profiles>
+ ...
+</settings></pre></div><p>Activation occurs when all specified criteria have been met, though not all are required at once.</p><ul><li><b>jdk</b>: <tt>activation</tt> has a built in, Java-centric check in the <tt>jdk</tt> element. This will activate if the test is run under a jdk version number that matches the prefix given. In the above example, <tt>1.5.0_06</tt> will match. Ranges are also supported as of Maven 2.1. See the <a class="externalLink" href="http://maven.apache.org/enforcer/enforcer-rules/versionRanges.html"> maven-enforcer-plugin</a> for more details about supported ranges.</li><li><b>os</b>: The <tt>os</tt> element can define some operating system specific properties shown above. See the <a class="externalLink" href="http://maven.apache.org/plugins/maven-enforcer-plugin/rules/requireOS.html">maven-enforcer-plugin</a> for more details about OS values.</li><li><b>property</b>: The <tt>profile</tt> will activate if Maven detects a property (a value which c
an be dereferenced within the POM by <tt>${name}</tt>) of the corresponding <tt>name=value</tt> pair.</li><li><b>file</b>: Finally, a given filename may activate the <tt>profile</tt> by the <tt>existence</tt> of a file, or if it is <tt>missing</tt>.</li></ul><p>The <tt>activation</tt> element is not the only way that a <tt>profile</tt> may be activated. The <tt>settings.xml</tt> file's <tt>activeProfile</tt> element may contain the profile's <tt>id</tt>. They may also be activated explicitly through the command line via a comma separated list after the <tt>-P</tt> flag (e.g. <tt>-P test</tt>).</p><p><i>To see which profile will activate in a certain build, use the</i> <tt>maven-help-plugin</tt>.</p><div><pre>mvn help:active-profiles</pre></div></div><div class="section"><h4>Properties<a name="Properties"></a></h4><p>Maven properties are value placeholder, like properties in Ant. Their values are accessible anywhere within a POM by using the notation <tt>${X}</tt>, where <tt>
X</tt> is the property. They come in five different styles, all accessible from the <tt>settings.xml</tt> file:</p><ol style="list-style-type: decimal"><li><tt>env.X</tt>: Prefixing a variable with "env." will return the shell's environment variable. For example, <tt>${env.PATH}</tt> contains the $path environment variable (<tt>%PATH%</tt> in Windows).</li><li><tt>project.x</tt>: A dot (.) notated path in the POM will contain the corresponding element's value. For example: <tt><project><version>1.0</version></project></tt> is accessible via <tt>${project.version}</tt>.</li><li><tt>settings.x</tt>: A dot (.) notated path in the <tt>settings.xml</tt> will contain the corresponding element's value. For example: <tt><settings><offline>false</offline></settings></tt> is accessible via <tt>${settings.offline}</tt>.</li><li>Java System Properties: All properties accessible via <tt>java.lang.System.getProperties()</tt> are av
ailable as POM properties, such as <tt>${java.home}</tt>.</li><li><tt>x</tt>: Set within a <properties /> element or an external files, the value may be used as <tt>${someVar}</tt>.</li></ol><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <profiles>
+ <profile>
+ ...
+ <properties>
+ <user.install>${user.home}/our-project</user.install>
+ </properties>
+ ...
+ </profile>
+ </profiles>
+ ...
+</settings></pre></div><p>The property <tt>${user.install}</tt> is accessible from a POM if this profile is active.</p></div><div class="section"><h4><a name="Repositories">Repositories</a></h4><p>Repositories are remote collections of projects from which Maven uses to populate the local repository of the build system. It is from this local repository that Maven calls it plugins and dependencies. Different remote repositories may contain different projects, and under the active profile they may be searched for a matching release or snapshot artifact.</p><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <profiles>
+ <profile>
+ ...
+ <repositories>
+ <repository>
+ <id>codehausSnapshots</id>
+ <name>Codehaus Snapshots</name>
+ <releases>
+ <enabled>false</enabled>
+ <updatePolicy>always</updatePolicy>
+ <checksumPolicy>warn</checksumPolicy>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ <updatePolicy>never</updatePolicy>
+ <checksumPolicy>fail</checksumPolicy>
+ </snapshots>
+ <url>http://snapshots.maven.codehaus.org/maven2</url>
+ <layout>default</layout>
+ </repository>
+ </repositories>
+ <pluginRepositories>
+ ...
+ </pluginRepositories>
+ ...
+ </profile>
+ </profiles>
+ ...
+</settings></pre></div><ul><li><b>releases</b>, <b>snapshots</b>: These are the policies for each type of artifact, Release or snapshot. With these two sets, a POM has the power to alter the policies for each type independent of the other within a single repository. For example, one may decide to enable only snapshot downloads, possibly for development purposes.</li><li><b>enabled</b>: <tt>true</tt> or <tt>false</tt> for whether this repository is enabled for the respective type (<tt>releases</tt> or <tt>snapshots</tt>).</li><li><b>updatePolicy</b>: This element specifies how often updates should attempt to occur. Maven will compare the local POM's timestamp (stored in a repository's maven-metadata file) to the remote. The choices are: <tt>always</tt>, <tt>daily</tt> (default), <tt>interval:X</tt> (where X is an integer in minutes) or <tt>never</tt>.</li><li><b>checksumPolicy</b>: When Maven deploys files to the repository, it also deploys corresponding checksum files.
Your options are to <tt>ignore</tt>, <tt>fail</tt>, or <tt>warn</tt> on missing or incorrect checksums.</li><li><b>layout</b>: In the above description of repositories, it was mentioned that they all follow a common layout. This is mostly correct. Maven 2 has a default layout for its repositories; however, Maven 1.x had a different layout. Use this element to specify which if it is <tt>default</tt> or <tt>legacy</tt>.</li></ul></div><div class="section"><h4><a name="Plugin_Repositories">Plugin Repositories</a></h4><p>Repositories are home to two major types of artifacts. The first are artifacts that are used as dependencies of other artifacts. These are the majority of plugins that reside within central. The other type of artifact is plugins. Maven plugins are themselves a special type of artifact. Because of this, plugin repositories may be separated from other repositories (although, I have yet to hear a convincing argument for doing so). In any case, the structure of the
<tt>pluginRepositories</tt> element block is similar to the <tt>repositories</tt> element. The <tt>pluginRepository</tt> elements each specify a remote location of where Maven can find new plugins.</p></div></div><div class="section"><h3><a name="Active_Profiles">Active Profiles</a></h3><div class="source"><pre><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+ <activeProfiles>
+ <activeProfile>env-test</activeProfile>
+ </activeProfiles>
+</settings></pre></div><p>The final piece of the <tt>settings.xml</tt> puzzle is the <tt>activeProfiles</tt> element. This contains a set of <tt>activeProfile</tt> elements, which each have a value of a <tt>profile</tt> <tt>id</tt>. Any <tt>profile</tt> <tt>id</tt> defined as an <tt>activeProfile</tt> will be active, reguardless of any environment settings. If no matching profile is found nothing will happen. For example, if <tt>env-test</tt> is an <tt>activeProfile</tt>, a profile in a <tt>pom.xml</tt> (or <tt>profile.xml</tt> with a corrosponding <tt>id</tt> will be active. If no such profile is found then execution will continue as normal.</p></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>