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 auto
Note: If you do not have the following license(s) installed on your system and you're attempting to install them for the first time, you must explicitly call them out by their name using the "-f" option. These licenses can only be used with DRAGEN 4.4+.
PipSeq
GvcfGenotyper
sudo dragen_lic -i auto -f PipSeq
sudo dragen_lic -i auto -f 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;
sudo dragen_lic -i <license file received>.bin
As an example, let's say you receive a zipfile containing the following license files; Genome, Compression, CNV, Somatic, Transcriptome, and JointGenotype.
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.
$ dragen_lic -b
SN: <serial number>
DRAGEN Version: <DRAGEN version>
Time: <time>
DRAGEN Core:
Status: Active
Used: 68.0 Gbases since 2023-Dec-05
Quota: 100250 Gbases
Expiry: 2024-Feb-13
Includes; Genome, JointGenotype, CNV, Somatic, Transcriptome License(s)
Compression:
Status: Active - !!! EXPIRING IN LESS THAN 30 DAYS !!!
Used: 0 Gbases since 2024-Jan-12
Quota: Unlimited
Expiry: 2024-Feb-13
TSO500Combined:
Status: Active
Used: 23518284 Gbases since around 2022-Jul-15
Quota: Unlimited
Expiry: 2050-Jan-01
TSO500_HRD:
Status: Active - !!! EXPIRING IN LESS THAN 30 DAYS !!!
Used: 0 Gbases since around 2024-Jan-07
Quota: Unlimited
Expiry: 2024-Feb-13
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.