Install and update Cover Reports
Last updated
Was this helpful?
Last updated
Was this helpful?
Specific Cover Reports prerequisites are listed below - see Specs & Reqs for full details.
Server hosting Cover Reports - Cover Reports Administrator:
4GB RAM (8GB recommended), 2GB* minimum available disk space, 4 CPU cores.
2GB Java heap allocation, 4GB recommended.
Docker Install - Docker Engine 20.10.17, Docker Compose v2.10.2, and if you're using Docker Hub you'll also need an internet connection.
Zip Install & Windows Installer - Java JDK 17+ (and available in your PATH system environment variable). For production use, you'll also need to provide a vanilla PostgreSQL 14 database (see ).
Windows Install - Windows Server 2019 and above, Windows 10 and above.
All - Network connectivity between the server(s) and client workstations. Note that if the Cover Reports server and database server are on different hosts, good network connectivity between them will ensure good performance.
* Note that the database server will store the data uploaded to Cover Reports. Sufficient storage should be ensured for projected usage.
Client workstation - Cover Reports Contributor:
Diffblue Cover CLI. The version of the CLI should correspond with the version of Reports to ensure the optimum experience.
JaCoCo 0.8.3+
Network connectivity between the user's workstation and the Cover Reports server.
Client workstation - Cover Reports User:
The latest version of Chrome, Edge, Safari, or Firefox with a screen resolution of 1920 x 1080 or higher.
Network connectivity between the user's workstation and the Cover Reports server.
From the directory containing the Cover Reports .tar.gz file, load the Docker bundle:
From the $COVER_REPORTS_HOME directory, start Cover Reports:
Finally, open a browser on a client PC that has access to the Cover Reports server and navigate to the Cover Reports Home Page (<HOSTURL>:8080). To change the default port see Configuration options.
As an alternative, Cover Reports can be installed using the zip archive. This provides for running Cover Reports as a Windows Service, Linux Service, Windows .bat, or macOS/Linux .sh, and removes the need to use Docker. This also provides various database configuration options to provide further flexibility.
To install Cover Reports from the Zip archive:
Using the link provided by Diffblue, download the Cover Reports .zip file - for example, diffblue-cover-reports-2023.10.02.zip
In your shell, navigate to your preferred install directory (we'll now refer to this as $COVER_REPORTS_HOME). This will be the home directory of Cover Reports.
Extract the contents of diffblue-cover-reports-2023.10.02.zip into the $COVER_REPORTS_HOME directory.
Install and start the service or run the script as needed.
To install Cover Reports as a service on a Windows host, open a terminal, navigate to the windows-service folder in your Cover Reports install, and run cover-reports.exe install
Once the service has been installed, you can start and stop the Cover Reports service using the Windows Service Manager.
Once installation is complete, review and set up your configuration options - see Configuration options for details.
Cover Reports can be installed on Windows using the combined Cover CLI & Cover Reports installer.
Using the link provided by Diffblue, download the combined Cover CLI & Cover Reports - for example, diffblue-cover-installer-2023.10.02.exe
Run the installer and follow the on screen prompts - note that to install Cover Reports, make sure that the Cover Reports option is selected during the install.
Install and start the service or run the script as needed.
To install Cover Reports as a service on a Windows host, open a terminal, navigate to the windows-service folder in your Cover Reports install, and run cover-reports.exe install
Once the service has been installed, you can start and stop the Cover Reports service using the Windows Service Manager.
Once installation is complete, review and set up your configuration options - see Configuration options for details.
Cover Reports update/upgrade details are provided below. Note that before you update Cover Reports, Diffblue recommends that you perform a database backup first - see Database backup.
Cover Reports does not support downgrades. It is not possible to deploy an older version of Reports once it has been upgraded - even in case of failure.
On your Cover Reports server:
Stop Cover Reports by running: docker compose down
In your shell, navigate to the $COVER_REPORTS_HOME directory where the existing installation is located and make a copy (backup) of the directory.
Rename the docker-compose.yml file in the $COVER_REPORTS_HOME directory - e.g. docker-compose-2023.08.13.yml
Using the link provided by Diffblue, download Cover Reports:
- For Cover Reports Docker Compose, download the docker-compose.yml file to the $COVER_REPORTS_HOME directory.
- For Cover Reports .tar.gz, download the latest Cover Reports bundle (e.g. diffblue-cover-reports-2023.08.01.tar.gz) and load the Docker bundle:
docker load -i /path/diffblue-cover-reports-<version>.tar.gz
Start the new version of Cover Reports using the command: docker compose up -d
The upgrade process is designed to occur automatically during deployment of a new version. In case an error occurs during an upgrade:
Stop the Reports application
If Reports must be available for use while this problem is investigated:
Restore the database backup created immediately prior to the failed upgrade
Restart the previously installed version of Reports
Using the link provided by Diffblue, download the Cover Reports .tar.gz file (e.g. diffblue-cover-reports-2023.07.02.tar.gz) to the server you plan to use to host Cover Reports. Contact if you don't have the download link.
In your shell, navigate to your preferred install directory (we'll now refer to this as $COVER_REPORTS_HOME). Using the link provided by Diffblue, download the Cover Reports Docker Compose file docker-compose.yml to $COVER_REPORTS_HOME. Contact if you don't have the download link.
To access the repository please and provide with your username. Diffblue Support will grant access according to your subscription terms.
In your shell (from the server you plan to use to host Cover Reports), log in to Docker Hub using the docker login command with either your username and password or username and , for example:
In your shell, navigate to your preferred install directory (we'll now refer to this as $COVER_REPORTS_HOME). Using the link provided by Diffblue, download the Cover Reports Docker Compose file docker-compose.yml to $COVER_REPORTS_HOME. Contact if you don't have the download link.
Contact and provide the log files from the report-web application
