FAQ

Are these instructions just for Confluence?

No, at the time of this writing (5/15/08), these instructions are applicable for Confluence, JIRA and Bamboo. We will soon support Fisheye, Crucible and Crowd also. Where the documentation refers to "Confluence", it's purely as an example.

Where is my $HOME Directory?

On Windows, you can usually find your home directory at c:\Document and Settings\USERNAME. On Unix systems, you can usually find it at /home/USERNAME/ and on Mac OS X, you'll find your home directory at /Users/USERNAME. There is a more complete discussion of home directories at Wikipedia.

How do I specify a particular version of Java?

Add these parameters to your plugin's POM file.

<project>
    <build>
        <plugins>
	    <plugin>
		<groupId>org.apache.maven.plugins</groupId>
		<artifactId>maven-enforcer-plugin</artifactId>
		<executions>
		    <execution>
			<id>enforce-java</id>
			<goals>
			  <goal>enforce</goal>
			</goals>
			<configuration>
			  <rules>
			    <requireJavaVersion>
				<version>[1.4,1.5)</version>
			    </requireJavaVersion>
			  </rules>
			</configuration>
		    </execution>
	          </executions>
            </plugin>
        <plugins>
    <build>
<project>

Troubleshooting

Maven complains that it can't find Java Mail, Java Activation or JTA.

Sun will not allow Maven to redistribute its binaries, you must install all Sun binaries manually by downloading them from Sun's website and running the mvn install command. You'll find instructions here and here.

• JavaMail
• JTA
• Java Activation

The maven install command looks like this:

mvn install:install-file -DgroupId=javax.XXXXX -DartifactId=XXXXX \
  -Dversion=X.X.X -Dpackaging=jar -Dfile=/path/to/XXXX-X_X_X.jar

Maven runs out of memory

You may need to allocate more memory to maven in order to complete it. You can do so be setting an environment variable called MAVEN_OPTS, like so export MAVEN_OPTS=-Xmx512m

The Confluence License has expired

If you set your plugin to build against Confluence 2.6.1 or later using the confluence.version parameter, the licenses will be valid. If you need to build against an older version, you replace the invalid license with a valid one manually.

I can't log in to the test Confluence instance using the admin account.

Set your plugin to build against Confluence 2.6.1 or later using the confluence.version parameter.

Maven complains it is "Unable to download the artifact from any repository."

We use Maven project's Archiva Maven Proxy to act as our Maven repository. Sometime, however, artifact downloads fail because of Archiva's instabilities. If you run into messages like this, sometimes a second attempt will succeed in dowbloading the artifact. If it doesn't work after a few times, then the artifact may be truly missing. You can search our Archiva to confirm this.

Maven warning "[WARN] POM for 'X' is invalid.... Reason: Not a v4.0.0 POM"

The warning "POM for 'X' is invalid.... Reason: Not a v4.0.0 POM" just means that this particular library hasn't been upgraded to have a Maven 2 POM yet. It will still work fine in your build, and you can safely ignore these errors. As we get all our dependencies moved over to Maven 2, and these errors will become less and less frequent.

Maven error "Parsing error.... Unrecognised tag: 'html'"

Occassionally, our Maven proxy will return a 404 file instead of the POM that it should. We're investigating this error (XPR-259) with the Archiva developers. In the mean time, should this happen to you, you should try remove the artifact and it's POM from your local repository to force a re-download. If that doesn't work, contact developer-relations@atlassian.com and we'll correct the problem at the source.