https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LUDOC-6 Lustre Documentation <p>The manual needs a test and build job. Test and build includes five steps:</p> <p>(TEST)</p> <p>1. Verify with xmllint the ./index.xml of doc/manual:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">xmllint --noout --xinclude --noent --relaxng /usr/share/xml/docbook/schema/rng/5.0/docbookxi.rng ./index.xml </pre> </div></div> <p>(TEST)</p> <p>2. (Optional) Verify with jing the ./index.xml of doc/manual:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">java -cp /home/richard/whamcloud/pubwiki/tools/jing-20081028/bin/ -Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeParserConfiguration -jar /home/richard/whamcloud/pubwiki/tools/jing-20081028/bin/jing.jar /usr/share/xml/docbook/schema/rng/5.0/docbookxi.rng ./index.xml </pre> </div></div> <p>(BUILD)</p> <p>3. Build a pdf of the manual:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">xsltproc --stringparam fop1.extensions 1 --stringparam section.label.includes.component.label 1 --stringparam section.autolabel 1 --stringparam chapter.autolabel 1 --stringparam appendix.autolabel 1 --xinclude -o /tmp/manual.fo /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl ./index.xml &amp;&amp; fop /tmp/manual.fo /tmp/manual.pdf </pre> </div></div> <p>(BUILD)<br/> 4. Build a HTML of the manual:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">xsltproc --stringparam fop1.extensions 1 --stringparam section.label.includes.component.label 1 --stringparam section.autolabel 1 --stringparam chapter.autolabel 1 --stringparam appendix.autolabel 1 --xinclude -o /tmp/manual.html /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl ./index.xml </pre> </div></div> <p>(AUTOMATION)</p> <p>5. Mark Gerrit +1 Hudson!</p> Build environment LUDOC-6

Build task needed.

Task Blocker Closed Fixed Michael MacDonald Richard Henwood Mon, 13 Jun 2011 10:27:40 +0000 Mon, 27 Jun 2011 11:32:24 +0000 Mon, 27 Jun 2011 11:32:24 +0000 0 0 <p>I've created the git repo as doc/manual and set up permissions such that Richard can push to it.</p> <p>I've also set up two Jenkins jobs:<br/> <a href="https://newbuild.whamcloud.com/job/lustre-manual/" class="external-link" target="_blank" rel="nofollow noopener">https://newbuild.whamcloud.com/job/lustre-manual/</a><br/> <a href="https://newbuild.whamcloud.com/job/lustre-manual-reviews/" class="external-link" target="_blank" rel="nofollow noopener">https://newbuild.whamcloud.com/job/lustre-manual-reviews/</a></p> <p>These are configured similarly to the regular lustre jobs &#8211; lustre-manual periodically (once an hour) polls the master branch of the doc/manual repo and builds any changes it sees, whereas lustre-manual-reviews is triggered by individual Gerrit reviews.</p> <p>Currently, there seems to be a problem in generating PDFs with fop. As I'm unfamiliar with these tools, I'll hand this task back to Richard for resolution. If there are packages which need to be installed, please update this issue and I'll take care of them.</p> <p>Mike and I have made some progress on this issue: there is a RHEL6 package 'docbook5-style-xsl' that reduces the warnings to zero during the xsltproc transform. Fop still fails.</p> <p>It seems that there is a problem with the version of fop that is included with RHEL6 with the docbook we've generated. The version 1.0 from here:</p> <p> <a href="http://apache.deathculture.net/xmlgraphics/fop/binaries/" class="external-link" target="_blank" rel="nofollow noopener">http://apache.deathculture.net/xmlgraphics/fop/binaries/</a></p> <p>generates a PDF. </p> <p>Mike: is possible to add a 1.0 fop requirement?</p> <p>Can we add a dependence on fop 1.0?</p> <p>Did you build/run fop-1.0 on RHEL6? I managed to package it, but it fails with the following:</p> <p>Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/xmlgraphics/util/uri/CommonURIResolver</p> <p>This is apparently due to a missing xmlgraphics-commons-1.4.jar. I located one and downloaded it, and as an experiment made it available to fop via CLASSPATH. I managed to get a bit further, but ran into this:</p> <p>SEVERE: Couldn't find hyphenation pattern en</p> <p>This is apparently due to a missing fop-hyph.jar, which I also downloaded and made available via CLASSPATH. Now it fails with the following: </p> <p>Exception in thread "main" java.lang.NoSuchMethodError: org.apache.xmlgraphics.java2d.GraphicContext.&lt;init&gt;(Lorg/apache/xmlgraphics/java2d/GraphicContext;</p> <p>I think, given that I have been poking at this for most of a day when I'm supposed to be working on Hydra, that I'm going to have to push back on this request. Please find a way to generate the manual which works with the packages provided by RHEL6, or else package up the necessary tool stack and push it to the toolkit repo.</p> <p>Mike, Thanks for your time on this.</p> <p>As you instruct, I've been looking at creating a fop workflow on a vanilla RHEL6 machine. I have had a look at the fop package you've built and I believe that the dependency on xmlgraphics-commons needs to be:</p> <p>Requires: xmlgraphics-commons &gt;= 1.4</p> <p>I've created a change for this: <a href="http://review.whamcloud.com/#change,998" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#change,998</a></p> <p>There are RPMs of xmlgraphics-commons &gt;= 1.4 available (i.e. on <a href="http://rpm.pbone.net/index.php3/stat/4/idpl/15778038/dir/rawhide/com/xmlgraphics-commons-1.4-3.noarch.rpm.html" class="external-link" target="_blank" rel="nofollow noopener">pbone.net</a>), but they not as part of the RHEL6 distro. In addition the RPM I looked at has a dependency on 'apache'-commons-io and 'apache'-commons-logging. I believe the equivalent packages in RHEL6 are 'jakarta'-commons-io and 'jakarta'-commons-logging. By forcing the rpm install of xmlgraphics-commons.1.4.rpm, and then installing your fop.1.0.rpm. I can generate a pdf manual.</p> <p>I've taken the xmlgraphics-commons source, created a .spec that corrects the dependency from apache to jakarta. This change is: <a href="#change,999" target="_blank" rel="noopener">://review.whamcloud.com/#change,999</a></p> <h3><a name="Stepstobuildpdfmanual."></a>Steps to build pdf manual.</h3> <ol> <li>Install java <tt>yum install java</tt></li> <li>create a fop version of the manual <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"># xsltproc --stringparam fop1.extensions 1 --stringparam section.label.includes.component.label 1 --stringparam section.autolabel 1 --stringparam chapter.autolabel 1 --stringparam appendix.autolabel 1 --xinclude -o /tmp/manual.fo /usr/share/sgml/docbook/xsl-ns-stylesheets-1.75.2/fo/docbook.xsl ./index.xml Making portrait pages on USletter paper (8.5inx11in) </pre> </div></div></li> <li>Observe no errors are returned.</li> <li>install jakarta-commons-io and jakarta-commons-logging</li> <li>install xmlgraphics-commons from <a href="http://newbuild.whamcloud.com/job/toolkit/" class="external-link" target="_blank" rel="nofollow noopener">build.whamcloud.com/toolkit</a></li> <li>Install fop from <a href="http://newbuild.whamcloud.com/job/toolkit/" class="external-link" target="_blank" rel="nofollow noopener">build.whamcloud.com/toolkit</a></li> <li>Convert the fop file to a pdf using fop: <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"># fop /tmp/manual.fo /tmp/manual.pdf </pre> </div></div></li> </ol> <p>NOTE the fop job creates a bunch of warnings. I think these are acceptable at this stage but should be tidied up in future.</p> <p>NOTE: xmlgraphic-commons introduces additional dependencies during build:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">ant-junit junit jakarta-commons-io jakarta-commons-logging </pre> </div></div> <p>Manual now builds, Hudson hooked into Gerrit: Thanks Mike!</p> Development Project Rank 1|hzvl93: Rank (Obsolete) 7204