Links

Online license activation

How to activate your Diffblue Cover license online

Requirements

Diffblue Cover requires a remote license check with the Diffblue licensing server each time it is used. Offline license activation is available with the Enterprise Edition offline option only.
To perform the license check Diffblue Cover needs an active internet connection to the following servers:
  • https://licensing.diffblue.com/
  • https://api.licensespring.com/
The license check uses this connection to identify individual devices. Further details regarding the exact data exchanged are available in the Privacy Notice.

Activate a license

Follow these steps to activate a license. Note that:
  • Cover Plugin Community Edition is free to use and doesn't require a license - see Editions.
  • These steps cover online license activation only.
  • Offline licensing for Cover CLI is available for Diffblue Cover Enterprise Edition only - see Editions and Offline license activation.
Cover Plugin
Cover CLI
Once you install Cover Plugin for IntelliJ, you'll be prompted for your license key to activate the plugin (or go to Diffblue > Activate License in IntelliJ at any time).
Diffblue Cover requires a remote license check with the Diffblue licensing server each time it's used. For help troubleshooting license keys, network connections, and proxy server settings, see Online license activation. Note that applying a license provides access to the Teams and Enterprise Editions of Diffblue Cover - the free Community Edition does not require a license.
To check your current license details, go to Diffblue > View License Information in IntelliJ.
Diffblue Cover requires a remote license check with the Diffblue licensing server each time it's used. For help troubleshooting license keys, network connections, and proxy server settings, as well as details of offline licensing (Enterprise Edition only), see Licensing.
  • To activate your license, from a Windows PowerShell (Windows) or Terminal (macOS/Linux) enter the command dcover activate XXXX-XXXX-XXXX-XXXX - replace XXXX-XXXX-XXXX-XXXX with the license key provided in your welcome email or provided by your organization.
  • Entering multiple different license keys will overwrite the existing key.
  • You can check your license status by running the command dcover license

Configuring a proxy server

Cover Plugin
Cover CLI
Please ensure you have the Proxy Server details configured in the IntelliJ settings page and then restart IntelliJ:
  • Windows and Linux: File > Settings > Appearance and Behavior > System Settings > HTTP Proxy
  • macOS: IntelliJ IDEA > Preferences > Appearance and Behavior > System Settings > HTTP Proxy
Please see the HTTPS certificate errors information below.
Diffblue Cover CLI utilizes the system Java proxy configurations; these can be set via the environment variable JVM_ARGS which details the proxy server FQDN and port, for example:
JVM_ARGS="-Dhttps.proxyHost=proxy.domain.com -Dhttps.proxyPort=8080"
As shown in this example:
Reminder: Ensure that the environment variable JVM_ARGS is set permanently according to your operating system instructions.

Troubleshooting license server connections

  1. 1.
    Check you have an active internet connection at all times when using Diffblue Cover.
  2. 2.
    Ensure you can access https://licensing.diffblue.com/ via a web browser; you will automatically receive a confirmation message when this is successful.
  3. 3.
    Ensure you can access https://api.licensespring.com/ via a web browser, you should see the message "Welcome to the LicenseSpring API".
  4. 4.
    Ensure that any Proxy Server settings are correctly set up (see the bottom of this page).
  5. 5.
    Please speak to your network manager about allowing access to the URLs above, and checking that port 443 is open.
  6. 6.
    For Cover Plugin, restart IntelliJ.
  7. 7.
    Try temporarily disabling anti-virus, malware detector or any firewall software.
  8. 8.
    A detailed logfile is available which shows further diagnostic information about the license check process - please review the logs (Cover Plugin Log Files, Cover CLI Log Files).
For further help troubleshooting licensing network connection issues, please contact Diffblue Support.

Troubleshooting HTTPS certificate errors

If you have a proxy server that rewrites HTTPS connections and packages them with its own certificate, you may get an L018 output code. The simplest way to fix this is to disable certificate checks. You can do this by setting either the Java system property dcover.disable.ssl.license.cert.check or the environment variable DIFFBLUE_DISABLE_SSL_LICENSE_CERT_CHECK to true. In IntelliJ you can add system properties using Help -> Edit custom properties.... This will open a file to which you should add a line such as:
dcover.disable.ssl.license.cert.check=true
When using Cover CLI the following environment variable can be configured:
DIFFBLUE_DISABLE_SSL_LICENSE_CERT_CHECK=true
Reminder: Ensure that the environment variable DIFFBLUE_DISABLE_SSL_LICENSE_CERT_CHECK is set permanently according to your operating system instructions.