Generate a build specification for Electric Cloud

The steps involved in creating a build specification in the Electric Cloud environment are:

  1. Create an emake annotation file. This XML annotation file is a structured log of the distributed build, with some extra information (such as automatically tracked dependencies and time metrics).
  2. Convert the annotation file into a Klocwork build trace. A build trace is a file that contains the sequence of process calls that took place during your build (for example, the make command).
  3. Use the build trace to create a build specification or build specification template.

Notes:

  • You can use multiple build specifications as input to the Klocwork integration build analysis with kwecbuild, so if you have multiple annotation files, you can create a build specification for each one.
  • For more information on creating build specifications, including customizing the compiler mapping file (kwfilter.conf) and compiler filter files, see How kwinject works.

To create a build specification in the Electric Cloud environment

  1. Run emake with the following options to generate an annotation file:
    emake --emake-cm=<clusterManagerHost> --emake-annodetail=basic --emake-annofile=<annotation_file>
    
    where
    • <clusterManagerHost> is the host where the cluster manager is installed
    • <annotation_file> is the output build log
    You must use the same working directory for emake and kwecbuild.

    For example:

    emake --emake-cm=serverXYZ --emake-annodetail=basic --emake-annofile=emake.xml
     
  2. Run kwlogparser to convert the annotation file into a build trace:
    kwlogparser [options] <parser> <annotation_file>
    

    For example:

    kwlogparser -o emake.trace emake-annotation emake.xml
    

    This command converts the emake annotation log file named emake.xml into a build trace named emake.trace.

  3. Run kwinject to convert the build trace into a build specification or build specification template:
    kwinject --trace-in <file> [options]
    

    For example:

    kwinject --trace-in emake.trace -o emake.out
    

    This command converts the trace file we generated in step 2 into a build specification named emake.out.

When do I need to update my build specification?

You need to update or create a new build specification in the following situations:

  • if source files are added or removed
  • if build settings are changed

If you reuse an existing build specification or try to modify it manually in these situations, the analysis results will not be accurate.