Jump to: navigation, search

Difference between revisions of "Documentation/Troubleshooting"

(→‎Failed to Transform)
Line 15: Line 15:
 
If you get an error like: "Failed to transform bk_ops_guide.xml", you have forgotten to add xml:id tags to your section. (eg <section xml:id="a-unique-name">)
 
If you get an error like: "Failed to transform bk_ops_guide.xml", you have forgotten to add xml:id tags to your section. (eg <section xml:id="a-unique-name">)
  
−
2013-09-10 18:15:29.340 | [INFO] ------------------------------------------------------------------------
+
    2013-09-10 18:15:29.340 | [INFO] ------------------------------------------------------------------------
 
     2013-09-10 18:15:29.344 | [INFO] BUILD FAILURE
 
     2013-09-10 18:15:29.344 | [INFO] BUILD FAILURE
 
     2013-09-10 18:15:29.346 | [INFO] ------------------------------------------------------------------------
 
     2013-09-10 18:15:29.346 | [INFO] ------------------------------------------------------------------------
Line 151: Line 151:
 
     2013-09-10 18:15:30.737 | ... 29 more
 
     2013-09-10 18:15:30.737 | ... 29 more
 
     2013-09-10 18:15:30.747 | channel stopped
 
     2013-09-10 18:15:30.747 | channel stopped
−
 
  
 
==ClassNotFoundException==
 
==ClassNotFoundException==

Revision as of 20:46, 10 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'

Failed to Transform

If you get an error like: "Failed to transform bk_ops_guide.xml", you have forgotten to add xml:id tags to your section. (eg <section xml:id="a-unique-name">) 

   2013-09-10 18:15:29.340 | [INFO] ------------------------------------------------------------------------
   2013-09-10 18:15:29.344 | [INFO] BUILD FAILURE
   2013-09-10 18:15:29.346 | [INFO] ------------------------------------------------------------------------
   2013-09-10 18:15:29.347 | [INFO] Total time: 49.242s
   2013-09-10 18:15:29.353 | [INFO] Finished at: Tue Sep 10 18:15:29 UTC 2013
   2013-09-10 18:15:29.584 | [INFO] Final Memory: 90M/793M
   2013-09-10 18:15:29.590 | [INFO] ------------------------------------------------------------------------
   2013-09-10 18:15:30.035 | [JENKINS] Archiving /home/jenkins/workspace/gate-openstack-manuals-operations-guide/doc/openstack-ops/pom.xml to /var/lib/jenkins/jobs/gate-openstack-manuals-operations-guide/modules/org.openstack.docs$openstack-ops-manual/builds/2013-09-10_18-14-34/archive/org.openstack.docs/openstack-ops-manual/1.0.0/openstack-ops-manual-1.0.0.pom
   2013-09-10 18:15:30.518 | Waiting for Jenkins to finish collecting data
   2013-09-10 18:15:30.522 | mavenExecutionResult exceptions not empty
   2013-09-10 18:15:30.523 | message : Failed to execute goal com.rackspace.cloud.api:clouddocs-maven-plugin:1.9.2:generate-webhelp (generate-webhelp) on project openstack-ops-manual: Failed to transform bk_ops_guide.xml.
   2013-09-10 18:15:30.524 | cause : Failed to transform bk_ops_guide.xml.
   2013-09-10 18:15:30.526 | Stack trace : 
   2013-09-10 18:15:30.528 | org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal com.rackspace.cloud.api:clouddocs-maven-plugin:1.9.2:generate-webhelp (generate-webhelp) on project openstack-ops-manual: Failed to transform bk_ops_guide.xml.
   2013-09-10 18:15:30.531 | 	at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:217)
   2013-09-10 18:15:30.532 | 	at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153)
   2013-09-10 18:15:30.534 | 	at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145)
   2013-09-10 18:15:30.535 | 	at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:84)
   2013-09-10 18:15:30.536 | 	at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:59)
   2013-09-10 18:15:30.541 | 	at org.apache.maven.lifecycle.internal.LifecycleStarter.singleThreadedBuild(LifecycleStarter.java:183)
   2013-09-10 18:15:30.542 | 	at org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:161)
   2013-09-10 18:15:30.543 | 	at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:320)
   2013-09-10 18:15:30.544 | 	at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:156)
   2013-09-10 18:15:30.548 | 	at org.jvnet.hudson.maven3.launcher.Maven3Launcher.main(Maven3Launcher.java:79)
   2013-09-10 18:15:30.550 | 	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
   2013-09-10 18:15:30.551 | 	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
   2013-09-10 18:15:30.555 | 	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
   2013-09-10 18:15:30.557 | 	at java.lang.reflect.Method.invoke(Method.java:606)
   2013-09-10 18:15:30.561 | 	at org.codehaus.plexus.classworlds.launcher.Launcher.launchStandard(Launcher.java:329)
   2013-09-10 18:15:30.562 | 	at org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java:239)
   2013-09-10 18:15:30.563 | 	at org.jvnet.hudson.maven3.agent.Maven3Main.launch(Maven3Main.java:174)
   2013-09-10 18:15:30.568 | 	at hudson.maven.Maven3Builder.call(Maven3Builder.java:100)
   2013-09-10 18:15:30.569 | 	at hudson.maven.Maven3Builder.call(Maven3Builder.java:66)
   2013-09-10 18:15:30.573 | 	at hudson.remoting.UserRequest.perform(UserRequest.java:118)
   2013-09-10 18:15:30.574 | 	at hudson.remoting.UserRequest.perform(UserRequest.java:48)
   2013-09-10 18:15:30.576 | 	at hudson.remoting.Request$2.run(Request.java:326)
   2013-09-10 18:15:30.580 | 	at hudson.remoting.InterceptingExecutorService$1.call(InterceptingExecutorService.java:72)
   2013-09-10 18:15:30.581 | 	at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334)
   2013-09-10 18:15:30.586 | 	at java.util.concurrent.FutureTask.run(FutureTask.java:166)
   2013-09-10 18:15:30.587 | 	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
   2013-09-10 18:15:30.589 | 	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
   2013-09-10 18:15:30.592 | 	at java.lang.Thread.run(Thread.java:724)
   2013-09-10 18:15:30.594 | Caused by: org.apache.maven.plugin.MojoExecutionException: Failed to transform bk_ops_guide.xml.
   2013-09-10 18:15:30.598 | 	at com.agilejava.docbkx.maven.AbstractTransformerMojo.execute(AbstractTransformerMojo.java:179)
   2013-09-10 18:15:30.599 | 	at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:101)
   2013-09-10 18:15:30.601 | 	at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:209)
   2013-09-10 18:15:30.605 | 	... 27 more
   2013-09-10 18:15:30.607 | Caused by: com.icl.saxon.style.TerminationException: Processing terminated by xsl:message at line 228
   2013-09-10 18:15:30.610 | 	at com.icl.saxon.style.XSLMessage.process(XSLMessage.java:90)
   2013-09-10 18:15:30.612 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.613 | 	at com.icl.saxon.style.XSLIf.process(XSLIf.java:78)
   2013-09-10 18:15:30.617 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.618 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.620 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.625 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.626 | 	at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement.java:289)
   2013-09-10 18:15:30.630 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.631 | 	at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement.java:289)
   2013-09-10 18:15:30.632 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.633 | 	at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement.java:289)
   2013-09-10 18:15:30.634 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.636 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.637 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.638 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.640 | 	at com.icl.saxon.style.XSLGeneralVariable.getSelectValue(XSLGeneralVariable.java:238)
   2013-09-10 18:15:30.641 | 	at com.icl.saxon.style.XSLWithParam.getParamValue(XSLWithParam.java:48)
   2013-09-10 18:15:30.642 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:164)
   2013-09-10 18:15:30.644 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.645 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.646 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.648 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.649 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.650 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.652 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.653 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.654 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.656 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.657 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.658 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.660 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.661 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.662 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.663 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.664 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.666 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.667 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.668 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.670 | 	at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:198)
   2013-09-10 18:15:30.671 | 	at com.icl.saxon.Controller.applyTemplates(Controller.java:255)
   2013-09-10 18:15:30.672 | 	at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:135)
   2013-09-10 18:15:30.674 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.675 | 	at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement.java:289)
   2013-09-10 18:15:30.676 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.678 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.679 | 	at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:198)
   2013-09-10 18:15:30.681 | 	at com.icl.saxon.Controller.applyImports(Controller.java:298)
   2013-09-10 18:15:30.682 | 	at com.icl.saxon.style.XSLApplyImports.process(XSLApplyImports.java:71)
   2013-09-10 18:15:30.683 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.685 | 	at com.icl.saxon.style.XSLGeneralVariable.getSelectValue(XSLGeneralVariable.java:238)
   2013-09-10 18:15:30.686 | 	at com.icl.saxon.style.XSLParam.process(XSLParam.java:76)
   2013-09-10 18:15:30.688 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.689 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.691 | 	at com.icl.saxon.style.XSLCallTemplate.process(XSLCallTemplate.java:187)
   2013-09-10 18:15:30.692 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.693 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.695 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.696 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.698 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.699 | 	at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:198)
   2013-09-10 18:15:30.700 | 	at com.icl.saxon.Controller.applyTemplates(Controller.java:255)
   2013-09-10 18:15:30.702 | 	at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:135)
   2013-09-10 18:15:30.703 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.704 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.706 | 	at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:198)
   2013-09-10 18:15:30.707 | 	at com.icl.saxon.Controller.applyTemplates(Controller.java:255)
   2013-09-10 18:15:30.708 | 	at com.icl.saxon.Controller.defaultAction(Controller.java:271)
   2013-09-10 18:15:30.710 | 	at com.icl.saxon.Controller.applyTemplates(Controller.java:236)
   2013-09-10 18:15:30.711 | 	at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:135)
   2013-09-10 18:15:30.713 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.714 | 	at com.icl.saxon.style.XSLIf.process(XSLIf.java:78)
   2013-09-10 18:15:30.715 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.717 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.718 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.720 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.721 | 	at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
   2013-09-10 18:15:30.723 | 	at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
   2013-09-10 18:15:30.724 | 	at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:634)
   2013-09-10 18:15:30.725 | 	at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:225)
   2013-09-10 18:15:30.727 | 	at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:198)
   2013-09-10 18:15:30.729 | 	at com.icl.saxon.Controller.applyTemplates(Controller.java:246)
   2013-09-10 18:15:30.730 | 	at com.icl.saxon.Controller.run(Controller.java:178)
   2013-09-10 18:15:30.732 | 	at com.icl.saxon.Controller.transformDocument(Controller.java:1086)
   2013-09-10 18:15:30.734 | 	at com.icl.saxon.Controller.transform(Controller.java:953)
   2013-09-10 18:15:30.735 | 	at com.agilejava.docbkx.maven.AbstractTransformerMojo.execute(AbstractTransformerMojo.java:163)
   2013-09-10 18:15:30.737 | 	... 29 more
   2013-09-10 18:15:30.747 | channel stopped

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>
Retrieved from "https://wiki.openstack.org/w/index.php?title=Documentation/Troubleshooting&oldid=29892"