DRAGEN license information and installation
**To use the DRAGEN Server, the licenses must be installed in order to launch the specific pipelines. If a user has depleted the full quota or is beyond the expiration date, the specific DRAGEN Analysis pipeline cannot be used.**Note: this is only applicable for standalone DRAGEN servers and not for the NextSeq 10002000. Install DRAGEN licenses on the NextSeq 1000/2000 via the Control Software.Display the status of the licenses by running:
/opt/edico/bin/dragen_lic
Example Output, generated with DRAGEN 3.9.5: Note: Formatting has been added for ease of view and is not present in the actual output.
LICENSE_MSG| ---- Board #0 (AC05142591656) ---- LICENSE_MSG| License Genome : used 0.0/100000 Gbases since 2022-Jun-27 (0 bases, 0.0%) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License JointGenotype: used 0.0 Grecords since 2022-Jun-27 (0 records, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License Transcriptome : used 0.0 Gbases since 2022-Jun-27 (0 bases, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License GATK-accelerated: used 0.0 Gbases since 2022-Jun-27 (0 bases, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License Somatic : used 0.0/12500 Gbases since 2022-Jun-27 (0 bases, 0.0%) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License CNV : used 0.0 Grecords since 2022-Jun-27 (0 records, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License TSO500 : used 0.0 Gbases since 2022-Jun-27 (0 bases, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License TSO500Solid : used 0.0 Gbases since 2022-Jun-27 (0 bases, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month LICENSE_MSG| License Compression: used 65.6 Gbases since 2022-Jun-27 (65575249644 bases, unlimited) LICENSE_MSG| issued=2022-Feb-03, start=2021-Jun-30, expiry=2025-Oct-01, period=1 month
LICENSE_MSG| -- License dongle LICENSE_MSG| STATUS : OK LICENSE_MSG| DONGLE SN: 99070297221513FE LICENSE_MSG| RELEASE : 2016.07p5-19358 LICENSE_MSG| CHIPID : \*013A874825412445 LICENSE_MSG| DNA: active, accelerators=DNA LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| RNA: active, accelerators=RNA LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| GZIP: active, accelerators=GZIP LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| GUNZ: active, accelerators=GUNZ LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| HMM: active, accelerators=HMM LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| SMW: active, accelerators=SMW LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| RANS: active, accelerators=RANS LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| GRAPH: active, accelerators=GRAPH LICENSE_MSG| issue=2022-Jan-31, start=2021-Jun-30, expiry=2025-Oct-01 LICENSE_MSG| DeepRTA: active, accelerators=DeepRTA LICENSE_MSG| issue=2021-Nov-01, start=2021-Jun-30, expiry=2025-Oct-01
When a DRAGEN License is purchased, it applies to the Genome Pipeline. Starting with v3.5.7 all usage is tracked within the genome license, rather than individual quota licenses. For example, Somatic analysis with v3.5.7+ is counted against Genome, and not Somatic. Pipeline specific licenses (eg, Somatic, Transcriptome, or CNV) still must be enabled in order to use them. CNV and JointGenotype licenses are unlimited; running these analyses standalone does not count towards license consumption. GATK-accelerated is no longer provided; see the DRAGEN-Broad Announcement.
DRAGEN counts the number of bases in a sample file in either FASTQ or BAM format. If the quota is exceeded, the license will expire, and the user will not be able to perform further analysis. If the license quota is exceeded during an analysis, that analysis will still be complete, but the user will not be able to perform the next analysis.
For example, if the user has 50 Gbase license remaining and starts analysis with 90 Gbase input, the analysis will be complete, but the user will not be able to perform the next analysis.
Canceled/Aborted analyses (that did not completed) are not included in the data quota calculation.
To see if an analysis was successful, view the [FPGA Number]_[PID]_usage.txt file in the output folder with the number of bases used.
DRAGEN TSO500 and DRAGEN TSO500 ctDNA are separate pipelines compatible with DRAGEN v3 and v4 servers. They are not provided with a standard DRAGEN license purchase (eg, Genome). Conversely, the other pipelines are not provided when a user purchases a TSO500/ TSO500 ctDNA license.
DRAGEN ORA Compression/Decompression requires its own license. Note that this feature is only available in DRAGEN v3.8 and later versions.
Following the license data is the license information that is stored on the dongle or USB key attached to the server. These lines show the status of all the accelerators that are enabled and they are specific to the different pipelines. The accelerators also have an expiry date which is similar to the license for each pipeline and the genome license example.
To obtain a new license, contact Illumina Customer Care at customercare@illumina.com.
Installing a new license:
Summary Type | Command | |||
Off-line installation | sudo rm /var/lib/edico/*.gbin sudo /opt/edico/bin/dragen_lic -i <path to>/license_Genome.bin sudo /opt/edico/bin/dragen_lic -i <path to>/license_Somatic.bin sudo /opt/edico/bin/dragen_lic -i <path to>/license_CNV.bin sudo /opt/edico/bin/dragen_lic -i <path to>/license_JointGenotype.bin sudo /opt/edico/bin/dragen_lic -i <path to>/license_Transcriptome.bin sudo /opt/edico/bin/dragen_lic -P <path to>/<SN>_license.dat For TSO500/TSO500 ctDNA: sudo /opt/edico/bin/dragen_lic -i <path to>/tso500solid.gbin | |||
Manual Online Install |
| Automatic Online Update | If the DRAGEN server is connected to the internet, the servers will sync with the Edico license server at 6:00 PM (local server time) and no additional action is required. | Once the licenses have been updated on the server, verify that the licenses were installed correctly using one of the following.
| |||
sudo /opt/edico/bin/dragen_lic -i auto | ||||
For any feedback or questions regarding this article (Illumina Knowledge Article #3834), contact Illumina Technical Support techsupport@illumina.com. |
Last updated