{"id":268,"date":"2026-10-13T05:51:23","date_gmt":"2026-10-13T05:51:23","guid":{"rendered":"http:\/\/www.scmgalaxy.com\/tutorials\/2010\/07\/07\/clover-and-maven-working-with-distributed-applications\/"},"modified":"2026-10-13T05:51:23","modified_gmt":"2026-10-13T05:51:23","slug":"clover-and-maven-working-with-distributed-applications","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/clover-and-maven-working-with-distributed-applications\/","title":{"rendered":"Maven Clover for Distributed Java Applications: Instrument, Collect, and Aggregate Coverage"},"content":{"rendered":"\n

Originally published on 2010-07-07; fully revised and updated.<\/em><\/p>\n\n\n\n

This guide explains how to use Maven Clover<\/strong> in a distributed test setup<\/strong>, where instrumented code runs on multiple servers instead of only on the build machine. It is useful for Java teams running integration or system tests remotely and needing a single, consolidated code coverage report.<\/p>\n\n\n\n

This revision preserves the original workflow and legacy clover2<\/code> Maven goals from the source post: configure Clover, build with instrumentation, deploy to test nodes, run tests, and generate coverage reports.<\/p>\n\n\n\n

\"clover-and-maven-working-with-distributed-applications\"<\/figure>\n\n\n\n

Why distributed coverage needs extra steps<\/h2>\n\n\n\n

In a local-only build, instrumentation, execution, and report generation all happen on one machine. In distributed testing, Clover data is split across remote servers, so you must move the right files at the right time.<\/p>\n\n\n\n

  • Build machine creates Clover-instrumented artifacts and a Clover registry database file.<\/li>
  • Test servers execute instrumented code and write runtime coverage recording files.<\/li>
  • Coverage recording files must be copied back before generating the final report.<\/li><\/ul>\n\n\n\n

    End-to-end Clover workflow for distributed applications<\/h2>\n\n\n\n
    \nflowchart TD\n    A[Configure Clover in Maven] --> B[Build instrumented artifacts]\n    B --> C[Deploy artifacts to test servers]\n    C --> D[Copy Clover registry DB to each test node]\n    D --> E[Run remote tests]\n    E --> F[Collect coverage recording files]\n    F --> G[Copy recordings to build machine]\n    G --> H[Generate aggregate Clover report]\n<\/pre>\n\n\n\n
    1) Configure Clover in Maven<\/h2>\n\n\n\n
    Add the Clover plugin to your pom.xml<\/code>. For multi-module projects, define it in the parent POM so all modules inherit a consistent setup.<\/p>\n\n\n
    <project<\/span>><\/span>\n  <build<\/span>><\/span>\n    <plugins<\/span>><\/span>\n      <plugin<\/span>><\/span>\n        <groupId<\/span>><\/span>com.atlassian.maven.plugins<\/groupId<\/span>><\/span>\n        <artifactId<\/span>><\/span>maven-clover2-plugin<\/artifactId<\/span>><\/span>\n      <\/plugin<\/span>><\/span>\n    <\/plugins<\/span>><\/span>\n  <\/build<\/span>><\/span>\n<\/project<\/span>><\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
    The original workflow uses command-line goals for setup, aggregation, and report generation, so many teams keep plugin configuration minimal and drive execution from CI jobs.<\/p>\n\n\n\n
    2) Build all components with Clover enabled<\/h2>\n\n\n\n
    Run the build with Clover instrumentation enabled:<\/p>\n\n\n
    mvn<\/span> -U<\/span> clover2<\/span>:setup<\/span> package<\/span> clover2<\/span>:aggregate<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    Expected logs should show Clover loading, creating a database, and instrumenting source files.<\/p>\n\n\n
    [INFO] Loaded from<\/span>: ...\/clover-2.6<\/span>.3<\/span>.jar\n[INFO] Clover: Commercial License registered to ...\n[INFO] Creating new<\/span> database at '...\/target\/clover\/clover.db'<\/span>.\n[INFO] Processing files at 1.5<\/span> source level.\n[INFO] Clover all over. Instrumented ... files (... package).<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
    3) Deploy instrumented build and Clover registry to test servers<\/h2>\n\n\n\n
    Deploy the instrumented build as you normally deploy test artifacts. In addition, copy the Clover registry database (created during build, often referenced by Clover initstring<\/code>) to each test server where instrumented code will run.<\/p>\n\n\n\n
    • Deploy instrumented binaries to all test nodes.<\/li>
    • Copy the Clover registry DB to the path expected at runtime.<\/li>
    • Ensure the runtime user can read and write in that folder.<\/li><\/ul>\n\n\n\n
      The source article also documents Java policy permissions used in older secured JVM setups:<\/p>\n\n\n
      grant codeBase \"file:\/path\/to\/clover.jar\"<\/span> {\n  permission java.util.PropertyPermission \"*\"<\/span>, \"read\"<\/span>;\n  permission java.io.FilePermission \"<>\"<\/span>, \"read, write\"<\/span>;\n  permission java.lang.RuntimePermission \"shutdownHooks\"<\/span>;\n};<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Legacy server paths mentioned in the original process:<\/p>\n\n\n
      %JAVA_HOME%\/jre\/<\/span>lib\/security\n%JAVA_HOME%\/jre\/<\/span>lib\/ext<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      4) Run tests remotely and collect coverage recordings<\/h2>\n\n\n\n
      Run automated or manual tests as usual. While instrumented code executes, Clover writes coverage recording files near the registry DB. The original naming pattern is described as:<\/p>\n\n\n
      xxx<\/span>.dbHHHHHHH_TTTTTTTTTT<\/span>\nclover<\/span>.dbHHHHHHH_TTTTTTTTTT<\/span>.1<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      After test execution, copy all recording files from each remote node back to the build machine (to the expected initstring location) before report generation.<\/p>\n\n\n
      # Example collection commands (adapt hostnames and paths)<\/span>\nscp test-node-1<\/span>:\/opt\/app\/clover\/*.db* \/ci\/workspace\/coverage\/\nscp test-node-2:\/opt\/app\/clover\/*.db* \/ci\/workspace\/coverage\/\nscp test-node-3:\/opt\/app\/clover\/*.db* \/ci\/workspace\/coverage\/<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      5) Generate and review the Clover report<\/h2>\n\n\n\n
      Once coverage recording files are centralized on the build machine, generate the report:<\/p>\n\n\n
      mvn<\/span> clover2<\/span>:clover<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Review the generated coverage output and verify that all remote test runs contributed data. Missing node files typically lead to lower-than-expected coverage.<\/p>\n\n\n\n
      Maven goals used in this workflow<\/h2>\n\n\n\n
      Goal or phase<\/th>Purpose in pipeline<\/th>When to run<\/th><\/tr><\/thead>
      clover2:setup<\/td>Prepare Clover instrumentation and registry data<\/td>Before compile\/package<\/td><\/tr>
      package<\/td>Build instrumented artifacts<\/td>Build stage<\/td><\/tr>
      clover2:aggregate<\/td>Aggregate Clover results across modules<\/td>After module builds<\/td><\/tr>
      clover2:clover<\/td>Generate final coverage report<\/td>After collecting remote recordings<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Best practices and common pitfalls<\/h2>\n\n\n\n
      • Keep Clover configuration centralized in the parent POM for multi-module builds.<\/li>
      • Use the same expected registry location between build and runtime environments.<\/li>
      • Validate write permissions on the folder that stores Clover DB and recording files.<\/li>
      • Collect recordings from every<\/strong> test node before generating reports.<\/li>
      • Treat the policy and jre\/lib\/ext<\/code> guidance as legacy and verify against your current JDK\/security model.<\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"
        Learn a practical Clover + Maven workflow for distributed test environments. This walkthrough covers instrumentation, remote execution, coverage file collection, and final report generation.<\/p>\n","protected":false},"author":1,"featured_media":4444,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[29],"tags":[91,1045,4309,610,254,3357,4307,1122,4310,919,161,4308,593,1668,104],"class_list":["post-268","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-maven","tag-build","tag-clover","tag-clover-and-maven-working-with-distributed-applications","tag-code-coverage","tag-configure","tag-deploy","tag-distributed-applications","tag-guide","tag-how-clover-and-maven-works-with-distributed-applications","tag-instructions","tag-maven","tag-maven-clover-plugin","tag-process","tag-run","tag-tutorials"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/268","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=268"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/268\/revisions"}],"predecessor-version":[{"id":79096,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/268\/revisions\/79096"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media\/4444"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=268"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=268"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}