Update Cover
How to update Cover Plugin and Cover CLI to the latest version
Diffblue releases product updates about every two weeks to continuously provide you with product enhancements and new features. Note that:
- 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.
Cover Plugin
Cover CLI
Cover Reports
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) orIntelliJ IDEA > Preferences > Plugins
(macOS), highlight the Diffblue Plugin and clickUpdate
in the details panel. - 2.When you're ready, click
Restart IDE
to complete the update.
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. Note that if you'd like to retain the previous release files, move these to a different folder first or create a new folder for the new version. Make sure to update thePATH
orDCOVER
environment variable configured during your original install, if needed. - 4.When your done, restart your PC. Once complete, run
dcover version
to check the install andPATH
configuration - if all is OK, Cover will display the current version.
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 using the following example commands. Note that if you'd like to retain the previous release files, move these to a different folder first or create a new folder for the new version. Make sure to update the
PATH
environment variable configured during your original install, if needed.\mkdir ~/bincd ~/binunzip ~/diffblue-cover*.zipexport PATH=$PATH:~/binReminder: Make sure that thePATH
environment variable is set permanently according to your operating system instructions. - 3.Once complete, run
dcover version
to check the install andPATH
configuration - if all is OK, Cover will display the current version.
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.
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
Last modified 14d ago