Jump to: navigation, search

Documentation/Troubleshooting

< Documentation
Revision as of 21:48, 9 September 2013 by Fifieldt (talk | contribs)

This article contains assistance on troubleshooting build errors with documentation

Out of Memory Error

You might need to allocate more memory to the Java heap space for the Maven plugin to build larger guides. You can use this environment variable:

   export MAVEN_OPTS='-Xms256m -XX:MaxPermSize=1024m -Xmx1024m'

If you want to double the allocation, use:

   export MAVEN_OPTS='-Xms1024m -XX:MaxPermSize=2048m -Xmx2048m'


ClassNotFoundException

You may need a modified settings.xml and if you already have M2_HOME set, you might see an error about "java.lang.ClassNotFoundException: org.codehaus.plexus.classworlds.launcher.Launcher" - just run unset M2_HOME. Here is a copy of a working settings.xml file:


<settings>
    <activeProfiles>
        <activeProfile>Rackspace Cloud Research</activeProfile>
    </activeProfiles>
    <profiles>
        <profile>
            <id>Rackspace Cloud Research</id>
            <repositories>
                <repository>
                    <id>repos.rackspace.cloud.snapshots</id>
                    <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <id>repos.rackspace.cloud.snapshots</id>
                    <url>http://maven.research.rackspacecloud.com/content/groups/public/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>
</settings>