Installation - VMs or CI run

Instructions for installing Diffblue Cover on a VM or during a CI run

Before you begin the installation, please obtain the link to download Cover (from your product update email, or contact Diffblue). Please note you need version 2022.03.02 or above, installed and activated with an appropriate license.

Installing on a VM

If you only have a few machines it is possible to manually install Cover on each machine. To do this:

1. Unzip the Cover jar files to a common and accessible directory inside each VM.

2. Activate Cover.

3. Reference these jar files when calling Cover in your CI scripts.

Installing during a CI run

For most CI systems, you will want to download Cover as part of your CI run.

This link should be added as a secret variable for your CI system, with a memorable name, such as “RELEASE_URL”, so that it can be referenced later. Depending on your CI system this will have a different name but common examples are:

• GitHub Actions = Secrets

• Codebuild = Parameter store

• Jenkins = Secret text in credentials

• GitLab CI = Protected variables

Then, add a step to your pipeline which downloads from this link and extract the contents. Below is an example in GitHub Actions:

- name: Get Cover
        run: |
          mkdir dcover
          cd dcover
          wget -c "${{ secrets.RELEASE_URL }}" -O dcover.zip -q
          unzip dcover.zip

From this point on you will be able to call Cover by referencing the executable extracted from this zip at the location you specified (dcover/dcover in the example above).

Similarly, add a secret variable for your CI system that holds the Cover license key, such as “LICENSE_KEY”. Activate Cover each time CI is run. For example

- name: Get Cover
        run: dcover/dcover activate "$LICENSE_KEY"