Running Regression Test Reports

Introduction

This page describes how to generate the Regression Test Reports. It is of interest primarily to people authorized by the release managers to run the reports.

Prerequisites

• A public ssh key.
• Linux. In theory it should be possible to run the run the reports on most modern operating system, including OS X and Windows (under bash), but all testing and current use has been on Linux. Works fine in a Linux VirtualBox virtual machine running on a Windows host.
• Git installed.
• A C++ compiler installed.
• The '7za' program from 7-zip.
• Python.

Initial setup

Send your public ssh key to Rene Rivera.

Run once only:

cd ~                   # or some other directory of your choice
mkdir boost-reports    # or some other name of your choice
    

Run reports

This step performs the following actions:

• Updates its internal procedures from the git public repository.
• Downloads current result zip files from an ftp server.
• Generates the HTML reports. (Now using a C++ program that is much faster than the old XSLT process.)
• Uploads a zip file containing the reports to a web server.

To run:

cd ~/boost/boost-reports # i.e. the directory created above
curl -o build_results_all.sh https://raw.githubusercontent.com/boostorg/regression/develop/reports/src/build_results_all.sh
chmod +x build_results_all.sh
./build_results_all.sh
    

In place of "curl" you could use "wget" or any other web command client.

The build_results_all.sh script generates log files for the report generation (develop.log and master.log). They are handy for debugging problems.

To Do

Acknowledgements

Thanks to Tom Kent, Steven Watanabe, and Rene Rivera for illuminating various dark corners of how reporting works.

Copyright Beman Dawes 2014. Copyright Rene Rivera 2014-2015.

Distributed under the Boost Software License, Version 1.0.