Links

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:
  • 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.
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. 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. 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. 1.
    Using the link provided by Diffblue, download the new Diffblue Cover CLI file - either the .exe installer or .zip archive, as needed.
  2. 2.
    If you use the installer, run the .exe installer and follow the on-screen prompts.
  3. 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 the PATH or DCOVER environment variable configured during your original install, if needed.
  4. 4.
    When your done, restart your PC. Once complete, run dcover version to check the install and PATH configuration - if all is OK, Cover will display the current version.
Linux/macOS:
  1. 1.
    Using the link provided by Diffblue, download the Diffblue Cover CLI .zip file.
  2. 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 ~/bin
    cd ~/bin
    unzip ~/diffblue-cover*.zip
    export PATH=$PATH:~/bin
    Reminder: Make sure that the PATH environment variable is set permanently according to your operating system instructions.
  3. 3.
    Once complete, run dcover version to check the install and PATH 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. 1.
    Stop Cover Reports by running: docker compose down
  2. 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. 3.
    Rename the docker-compose.yml file in the $COVER_REPORTS_HOME directory - e.g. docker-compose-2023.08.13.yml
  4. 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. 5.
    Start the new version of Cover Reports using the command: docker compose up -d