Difference between revisions of "Documentation/Troubleshooting"

Revision as of 21:48, 9 September 2013

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>

@@ Line 1: / Line 1: @@
 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'