FAQ and Troubleshooting

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?

By default, Maven uses the JDK that you run it with to compile your sources. If you would like to enforce a particular JDK version or version range, 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>

Plugins are pre-configured to use Java 1.4 as the source level when compiling. If you would like to use language features introduced in Java 5, such as generics, auto-boxing, and annotations, you'll need to set the jdkLevel property:

<project>
  ...
  <properties>
    ...
    <jdkLevel>1.5</jdkLevel>
  </properties>
  ...
</project>

This property is also used by the Maven IDEA plugin to set the source level for the project generated when you run mvn idea:idea.

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.

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 atlassian.product.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 atlassian.product.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 downloading 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'"

Occasionally, 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.

How can I change the log4j settings.

You can edit the file .../WEB-INF/classes/log4j.properties.

Errors when creating an archetype

When creating a new archetype, you might see errors that look like "[ERROR] ResourceManager : unable to find resource 'VM_global_library.vm' in any resource loader." These errors are harmless, and you can safely ignore them. We hope to eliminate them eventually, and the issue about them is filed internally as XPR-229.

Can I get the repository available locally?

sourced from: http://www.howtoforge.com/davfs_ubuntu
Its possible to mount the various DAVS repository locations in a Linux file-system with the following commands (debian distro's like Ubuntu):

sudo apt-get install davfs2
answer yes when prompted after executing sudo dpkg-reconfigure davfs2

edit /etc/fstab and add a line like:

https://maven.atlassian.com/contrib /media/dav/atlassian-contrib davfs rw,user,noauto 0 0
https://maven.atlassian.com/public /media/dav/atlassian-public davfs rw,user,noauto 0 0
https://maven.atlassian.com/contrib-snapshot /media/dav/atlassian-contrib-snapshot davfs rw,user,noauto 0 0

prepare the mount location with sudo mkdir /media/dav
mount the filessystem you want, eg mount /media/dav/contrib

UserId's / Passwords? Yes, it will prompt, adding your DEVNET credentials will allow full access, careful when rm'ing