Update Cover

Diffblue releases product updates about every two weeks to continuously provide you with product enhancements and new features. Note that:

• If needed, check the details for the latest updates, and even the older ones - see What's new.

• When you update, you'll always be updated to the latest version.

• If you're using Cover Plugin and Cover CLI, we recommend that you update both products to the latest version.

Update Cover Plugin or Cover CLI

Cover Plugin

Updating Cover Plugin may take a few minutes to complete and will require an IDE restart - you won't be able to create any tests for your projects while the update is progressing.

1. In IntelliJ, go to File > Settings > Plugins (Windows/Linux) or IntelliJ IDEA > Preferences > Plugins (macOS), highlight the Diffblue Plugin and click Update in the details panel.

2. When you're ready, click Restart IDE to complete the update. Enjoy your shiny, new plugin.

Cover CLI

Updating Cover CLI may take a few minutes to complete and you won't be able to create any tests for your projects while the update is progressing.

Windows:

1. Using the link provided by Diffblue, download the new Diffblue Cover CLI file - either the .exe installer or .zip archive, as needed.

2. If you use the installer, run the .exe installer and follow the on-screen prompts.

3. If you use the archive file, extract the .zip file to your existing Cover CLI folder.

4. When your done, restart your PC.

Linux/macOS:

1. Using the link provided by Diffblue, download the Diffblue Cover CLI .zip file.

2. Unzip the Cover CLI zip file to an appropriate installation location (for example, ~/bin) and update this location in the PATH environment variable using the following example commands:\

   mkdir ~/bin
   cd ~/bin
   unzip ~/diffblue-cover*.zip
   cd
   export PATH=$PATH:~/bin

   Reminder: Make sure that the PATH environment variable is set permanently according to your operating system instructions.

Update Cover Reports

Updating Cover Reports may take some time to complete. During this time you won't be able to upload new reports bundles and the Reports URL won't be accessible.

Docker

On your Cover Reports server:

1. Stop Cover Reports by running: docker compose down

2. In your shell, navigate to the $COVER_REPORTS_HOME directory where the existing installation is located and make a copy (backup) of the directory.

3. Rename the docker-compose.yml file in the $COVER_REPORTS_HOME directory - e.g. docker-compose-2023.08.13.yml

4. 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

5. Start the new version of Cover Reports using the command: docker compose up -d

ZIP Install

1. Make a copy of your custom files as needed - application.properties, cover-reports.xml, cover-reports.service

2. Using the link provided by Diffblue, download the latest Cover Reports .zip bundle to your Cover Reports install directory.

3. Stop Cover Reports (if currently running).

4. In your shell, navigate to the Cover Reports install directory and extract the contents of the downloaded zip file.

5. Add your custom files back to the updated installation.

6. Restart Cover Reports.

EXE Install

Windows:

1. Using the link provided by Diffblue, download the combined Cover CLI & Cover Reports - for example, diffblue-cover-installer-2023.10.02.exe

2. Using the Windows Service Manager, stop the Cover Reports service.

3. 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.

4. Restart the Cover Reports service.