DRAGEN Server Licensing
DRAGEN Server (on-premises) Licensing
On-Premises DRAGEN supports both Connected and Dark Site Licensing.
Installing Licenses
Connected DRAGEN servers automatically retrieve the latest licenses assigned to it once per day, meaning typically no user action is needed to install licenses.
For those who need to manually install licenses - the dragen_lic tool which comes packaged with DRAGEN can be utilized. Note, installing licenses with the dragen_lic tool requires root privilege.
Manually install license using Illumina License Server --> Using the dragen_lic tool, you can force DRAGEN to retrieve the latest licenses available to you from Illumina. See the example below.
Manually install license using a file --> Using the dragen_lic tool, you can install a license binary file (ending with the .bin extension). Note, there can be upwards of 7+ Licenses assigned to your server, and each individual license file would have to be installed using this command. This is not the preferred method of installing a license and should be reserved for Dark Site systems only. See the example below.
dragen_lic tool location
The dragen_lic tool can be found at /usr/bin/dragen_lic.
Note: In older versions of DRAGEN (typically DRAGEN 4.2 and earlier), the tool can be found at /opt/edico/bin/dragen_lic
Manually install license using Illumina License Server (Connected);
The following command will automatically attempt to download all available licenses assigned to you via the Illumina License Server.
sudo dragen_lic -i autoNote: If you do not have the following license(s) installed on your system and you're attempting to install them for the first time specifically on DRAGEN version 4.4.4, you must explicitly call them out by their name using the "-f" option. For DRAGEN v4.4.6+, the standard sudo dragen_lic -i auto command mentioned above is sufficient for these licenses.
PipSeq
GvcfGenotyper
Manually install license using a file (Offline)
For each license file you receive and want to manually install, you would need to run the following command;
As an example, let's say you receive a zipfile containing the following license files; Genome, Compression, CNV, Somatic, Transcriptome, and JointGenotype.
Retrieving License Information
There are three options for retrieving information regarding your installed licenses. Examples for each one are below.
Basic Output (i.e. using the -b flag). This is the recommended method to view license information by a human user as the output is simplified to be more readable.
Note: This option is only present in DRAGEN 4.3 and higher.
JSON Output (i.e. using the -j flag). This is the recommended method to view license information by a machine user as the output is already in a machine readable format.
Note: This option is only present in DRAGEN 4.3 and higher.
Note: In DRAGEN 4.3 there was a single license object per license type, with DRAGEN 4.4+ there is a list of license objects per license type.
Detailed Output (i.e. no additional arguments). This is the default method for retreiving license information, and prior to DRAGEN v4.3 this was the only method available. In general it is recommended to instead use one of the above two options if possible.
Basic mode (-b) will not show a license if it has been expired by more then 90 days.
Basic mode (-b) and JSON mode (-j) collapse the "DRAGEN Core" licenses (Genome, Somatic, CNV, JointGenotype, and Transcriptome) into a single entry, as this is effectively how these licenses are bundled and sold.
Connected DRAGEN - License Server Domain
A connected server should be capable of reaching the Illumina DRAGEN License server via HTTPS, license.dragen.illumina.com.
Note: DRAGEN versions 4.3 and lower utilize a different domain over HTTP (using an encrypted payload), lus.edicogenome.com.
To verify connectivity to the license server, you can query the healthcheck endpoint which will return a 200 status code and a small JSON body if successful.
Notes:
If you are using DRAGEN with a proxy, please make sure the following entities are using the proxy.
Root User who will be installing DRAGEN licenses.
dragen_licd systemd service for maintaining licenses.
Usage Reporting
Usage reporting is a key component of the DRAGEN Licensing infrastructure. Usage data entails the following information for each individual run
run date
run duration
licensing quota consumed (number of bases) in that run
run status
software version used for the run.
Notes
If performing a destructive system operation like an OS upgrade, please be sure to follow the OS Upgrade instructions DRAGEN Platform upgrade instructions.
Last updated
Was this helpful?