This page last changed on Sep 25, 2007 by mryall.

This document covers the configuration of Maven repositories for Atlassian projects built using Maven 2. This includes:

  • Confluence 2.3 or later
  • Confluence dependencies such as atlassian-user, seraph, atlassian-renderer
  • many recent Confluence plugins
  • any other Atlassian project with a pom.xml file in the top folder.

Creating a personal Maven configuration file

Create a file in the following location which will include your personal settings for Maven 2:

~/.m2/settings.xml

For Windows users, this means C:\Documents and Settings\<username>\.m2\settings.xml.

The following file contains the required repositories for building Atlassian's software and contributed plugins. If you already have a settings.xml file, you need to update your pluginGroups settings and add the repositories below to an active profile.

<settings>
  <pluginGroups>
    <pluginGroup>com.atlassian.maven.plugins</pluginGroup>
    <pluginGroup>org.apache.maven.plugins</pluginGroup>
  </pluginGroups>
  <profiles>
    <profile>
      <id>default-profile</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
        <repository>
          <id>atlassian-m2-repository</id>
          <name>Atlassian Maven 2 Repository</name>
          <url>http://repository.atlassian.com/maven2</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
        <repository>
          <id>atlassian-m2-contrib</id>
          <name>Atlassian Maven 2 Contributor Repository</name>
          <url>http://svn.atlassian.com/svn/public/contrib/repository/maven2</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
        <repository>
          <id>atlassian-m1</id>
          <url>http://repository.atlassian.com</url>
          <layout>legacy</layout>
        </repository>
      </repositories>
    </profile>
  </profiles>
</settings>

Installing non-distributable libraries

Building some projects will require the Java Transaction API (JTA), which cannot be distributed by Atlassian. You need to download this from the Sun website, and install it with:

mvn install:install-file \
  -Dfile=./jta-1_0_1B-classes.zip \
  -DgroupId=javax.transaction \
  -DartifactId=jta -Dversion=1.0.1B \
  -Dpackaging=jar

What next?

Continue with the Initial development environment setup.

Document generated by Confluence on Oct 10, 2007 18:49