PageRenderTime 32ms CodeModel.GetById 28ms RepoModel.GetById 0ms app.codeStats 0ms

/cruisecontrol/webapps/documentation/reporting/jsp/custom.html

http://rubystudy.googlecode.com/
HTML | 179 lines | 158 code | 21 blank | 0 comment | 0 complexity | 7b97e533e11216b2abd4eff038d9d018 MD5 | raw file
Possible License(s): LGPL-2.0, AGPL-3.0, Apache-2.0, CPL-1.0, LGPL-2.1, MPL-2.0-no-copyleft-exception 
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

    2. 

  2. <html>

    3. 

  3. <head>

    4. 

  4.    <title>CruiseControl Build Results JSP Installation Guide</title>

    5. 

  5.    <style type="text/css" media="all">

    6. 

  6.        @import "../../cruisecontrol.css";

    7. 

  7.    </style>

    8. 

  8.    <link href="../../print.css" type="text/css" rel="stylesheet" media="print"/>

    9. 

  9. </head>

    10. 

  10. <body>

    11. 

  11. <div class="header">

    12. 

  12.     <div class="hostedby">

    13. 

  13.         Hosted By:<br/>

    14. 

  14.         <a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=23523&amp;type=1" width="88" height="31" alt="SourceForge"/></a>

    15. 

  15.     </div>

    16. 

  16.     <div class="logo"><img alt="CruiseControl" src="../../banner.png"/></div>

    17. 

  17. </div>

    18. 

  18. <div class="container">&nbsp;

    19. 

  19.     <div id="menu">

    20. 

  20.         <ul id="menulist">

    21. 

  21.             <li class="top"><a href="../../index.html">home</a></li>

    22. 

  22.             <li><a href="../../download.html">download</a></li>

    23. 

  23.             <li><a class="expandmenu" href="../../gettingstarted.html">getting started</a></li>

    24. 

  24.             <li><h2>documentation</h2></li>

    25. 

  25.             <li><a class="expandedmenu" href="../../overview.html">overview</a>

    26. 

  26.                  <ul>

    27. 

  27.                     <li><a class="expandmenu" href="../../main/index.html">build loop</a></li>

    28. 

  28.                     <li><a class="expandedmenu" href="index.html">results jsp</a>

    29. 

  29.                         <ul>

    30. 

  30.                             <li><a href="install.html">install</a></li>

    31. 

  31.                             <li><p id="menuselected">customization</p></li>

    32. 

  32.                         </ul>

    33. 

  33. 		    </li>

    34. 

  34.                     <li><a class="expandmenu" href="../../dashboard.html">dashboard</a></li>

    35. 

  35.                     <li><a class="expandmenu" href="../../distributed/index.html">distributed</a></li>

    36. 

  36.                 </ul>

    37. 

  37. 	    </li>

    38. 

  38.             <li><a href="../../main/configxml.html">config.xml</a></li>

    39. 

  39.             <li><a href="../../faq.html">faq</a></li>

    40. 

  40.             <li><a class="external" href="http://confluence.public.thoughtworks.org/display/CC/Home">wiki</a></li>

    41. 

  41.             <li><h2>contributing</h2></li>

    42. 

  42.             <li><a class="expandmenu" href="../../developers.html">developers</a></li>

    43. 

  43.             <li><a href="../../contact.html">mailing lists</a></li>

    44. 

  44.             <li><a href="../../svn.html">source repository</a></li>

    45. 

  45.             <li><a href="../../license.html">license</a></li>

    46. 

  46.             <li><p id="menubottom">Release: 2.8.2</p></li>

    47. 

  47.         </ul>

    48. 

  48.     </div>

    49. 

  49.     <div class="content">

    50. 

  50.         <h1><span class="printonly">CruiseControl</span> Build Results JSP Customization</h1>

    51. 

  51. 

    52. 

  52.         <h2>Build parameters</h2>

    53. 

  53.         <p>Three configuration settings are specified when building the reporting applications. See the

    54. 

  54.         <a href="install.html#Building">Building</a> section of the Installation Guide</p>

    55. 

  55. 

    56. 

  56.         <h2>System properties</h2>

    57. 

  57.         <p>The binary release uses System properties to pass the value of commandline arguments from the main

    58. 

  58.         CruiseControl process to the Reporting application.</p>

    59. 

  59. 

    60. 

  60.         <dl>

    61. 

  61.             <dt>ccname</dt>

    62. 

  62.             <dd>Name for this CruiseControl instance</dd>

    63. 

  63.             <dd class="default-value">The binaryrelease sets this to the <code>-ccname</code> value given as a

    64. 

  64.             commandline argument</dd>

    65. 

  65. 

    66. 

  66.             <dt>cruisecontrol.jmxport</dt>

    67. 

  67.             <dd>port where the CruiseControl JMX agent's HTTP adaptor is listening.</dd>

    68. 

  68.             <dd class="default-value">Default value is 8000. The binaryrelease sets this to the <code>-jmxport</code> value given as a

    69. 

  69.             commandline argument (by default 8000)</dd>

    70. 

  70. 

    71. 

  71.             <dt>cruisecontrol.jmxhost</dt>

    72. 

  72.             <dd>host where the CruiseControl JMX agent's HTTP adaptor is listening</dd>

    73. 

  73.             <dd class="default-value">If not specified CruiseControl will trying to guess the host name running the reporting application</dd>

    74. 

  74. 

    75. 

  75.             <dt>cruisecontrol.rmiport</dt>

    76. 

  76.             <dd>port where CruiseControl JMX agent's RMI adaptor is listening. If specified enables the experimental

    77. 

  77.             configuration editor.</dd>

    78. 

  78.             <dd class="default-value">The binaryrelease sets this to the <code>-rmiport</code> value given as a

    79. 

  79.             commandline argument</dd>

    80. 

  80.         </dl>

    81. 

  81. 

    82. 

  82.         <h2>Deployment descriptor (web.xml)</h2>

    83. 

  83. 

    84. 

  84.         <p>The JSP reporting application uses context parameters and servlet init parameters configuration and

    85. 

  85.         customization. These parameters can be edited in the web.xml file directly. Some Web Containers like

    86. 

  86.         <a class="external" href="http://tomcat.apache.org/tomcat-5.5-doc/config/context.html#Context%20Parameters">

    87. 

  87.         Tomcat</a> allow the default values to be override without changing the <code>web.xml</code> or the

    88. 

  88.         <code>war</code> file.

    89. 

  89.         </p>

    90. 

  90. 

    91. 

  91.         <h3>Context parameters</h3>

    92. 

  92.         <dl>

    93. 

  93.             <dt>cacheRoot</dt>

    94. 

  94.             <dd>Full path to a directory where caches of XSL transformations are written. The web context must have

    95. 

  95.                 permission to write to this directory. If not specified, caches will be written in a subdir called

    96. 

  96.                 _cache of the <code>logDir</code></dd>

    97. 

  97.             <dd class="default-value">The binaryrelease does not specify this parameter</dd>

    98. 

  98. 

    99. 

  99.             <dt>logDir</dt>

    100. 

  100.             <dd>This should be the full path to your CruiseControl log directory. If you are in single project mode,

    101. 

  101.                 this will contain only the logs for your project. If you are in multi-project mode, it is expected that

    102. 

  102.                 you will have multiple sub-directories inside this log directory, one for each project.</dd>

    103. 

  103.             <dd class="default-value">The default default value is the build parameter <code>user.log.dir</code>. The

    104. 

  104.                 binary release sets this to <code>logs</code></dd>

    105. 

  105. 

    106. 

  106.             <dt>singleProject</dt>

    107. 

  107.             <dd>Indicates if the CruiseControl instance is to report on only one project. If it is, then you should set

    108. 

  108.                 this to true.</dd>

    109. 

  109.             <dd class="default-value">The default value is <code>false</code></dd>

    110. 

  110.             

    111. 

  111.             <dt>currentBuildStatusFile</dt>

    112. 

  112.             <dd>This should be the name to your current build status file as generated by the currentbuildstatuslistener,

    113. 

  113.                 which is located to the projects log directory.</dd>

    114. 

  114.             <dd class="default-value">The default default value is the build parameter <code>user.build.status.file</code>.

    115. 

  115.                 The binary release sets this to <code>status.txt</code></dd>

    116. 

  116. 

    117. 

  117.             <dt>fileServlet.welcomeFiles</dt>

    118. 

  118.             <dd>The list of space separated index files that should be automatically displayed

    119. 

  119.                 when browsing a directory displayed by the file servlet. The order matters.

    120. 

  120.                 Let empty or comment out to disable indexes.</dd>

    121. 

  121.             <dd class="default-value">The default values are: <code>index.htm index.html</code></dd>

    122. 

  122. 

    123. 

  123.             <dt>cruisecontrol.jmxhost</dt>

    124. 

  124.             <dd>The host for the JMX HttpAdaptor to which CruiseControl will connect for forcing builds and

    125. 

  125.                 viewing the control panel. The parameter may be overridden using the system property with

    126. 

  126.                 the same name.</dd>

    127. 

  127.             <dd class="default-value">The default value is: <code>localhost</code></dd>

    128. 

  128. 

    129. 

  129.             <dt>cruisecontrol.jmxport</dt>

    130. 

  130.             <dd>The port for the JMX HttpAdaptor to which CruiseControl will connect for forcing builds and

    131. 

  131.                 viewing the control panel. The parameter may be overridden using the system property with

    132. 

  132.                 the same name.</dd>

    133. 

  133.             <dd class="default-value">The default value is: <code>8000</code></dd>

    134. 

  134. 

    135. 

  135.             <dt>xslt.*</dt>

    136. 

  136.             <dd>any context parameter that starts with <code>xslt.</code> will be pass to the XSL stylesheets as a XSLT

    137. 

  137.                 parameter without the <code>xslt.</code> prefix. See <a href="#XSLT_parameters">XSLT parameters</a></dd>

    138. 

  138.         </dl>

    139. 

  139. 

    140. 

  140.         <h3>Servlet init-param</h3>

    141. 

  141.         <p>Beside the context parameters the <code>ArtifactServlet</code> takes an init parameter</p>

    142. 

  142.         <dl>

    143. 

  143.             <dt>rootDir</dt>

    144. 

  144.             <dd>The absolute path to the directory where additional build artifacts are stored. If this is not specified

    145. 

  145.                 the <code>logDir</code> context parameter will be used</dd>

    146. 

  146.             <dd class="default-value">The default default value is the build parameter

    147. 

  147.                 <code>cruise.build.artifacts.dir</code>. The binary release sets this to <code>artifacts</code></dd>

    148. 

  148.         </dl>

    149. 

  149. 

    150. 

  150.         <h2 id="XSLT_parameters">XSLT parameters</h2>

    151. 

  151.         <p>Some of the XSL stylesheets can be configured using XSLT parameters. These parameters are configured as

    152. 

  152.         context parameters with a <code>xslt.</code> prefix, that is XSLT Parameter <code>viewcvs.url</code> is

    153. 

  153.         configured a context parameter <code>xslt.viewcvs.url</code></p>

    154. 

  154.         <dl>

    155. 

  155.           <dt>pmd.warning.threshold</dt>

    156. 

  156.           <dd>PMD violations with a priority below this threshold are considered warnings and are only reported by the

    157. 

  157.               total count on the build results page.

    158. 

  158.           </dd>

    159. 

  159.           <dd class="default-value">This is not specified by default</dd>

    160. 

  160. 

    161. 

  161.           <dt>viewcvs.url</dt>

    162. 

  162.           <dd>The URL of the ViewCVS website used by cvstagdiff.xsl, checkstyle-details.xsl and pmd-details.xsl</dd>

    163. 

  163.           <dd class="default-value">This is not specified by default</dd>

    164. 

  164. 

    165. 

  165.           <dt>cvstagdiff.success.show</dt>

    166. 

  166.           <dd>Controls whether the ViewCVS differences report should be shown when the build was successful. The default

    167. 

  167.               is to only show the modifications report for broken builds</dd>

    168. 

  168.           <dd class="default-value">true</dd>

    169. 

  169. 

    170. 

  170.           <dt>checkstyle.hide.warnings</dt>

    171. 

  171.           <dd>Controls whether only CheckStyle errors or all CheckStyle errors and warnings should be listed on the

    172. 

  172.               build results page. Set to 'true' for hiding the warnings. The default is to list all errors and warnings.

    173. 

  173.           </dd>

    174. 

  174.           <dd class="default-value">This is not specified by default</dd>

    175. 

  175.         </dl>

    176. 

  176.     </div>

    177. 

  177. </div>

    178. 

  178. </body>

    179. 

  179. </html>

    180. 

  180.