# 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](https://gatk.broadinstitute.org/hc/en-us/articles/360039984151-DRAGEN-GATK-Update-Let-s-get-more-specific). 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 . ### **Installing a new license:** | Summary Type | Command | | | | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Off-line installation |

sudo rm /var/lib/edico/\*.gbin

sudo /opt/edico/bin/dragen\_lic -i \/license\_Genome.bin

sudo /opt/edico/bin/dragen\_lic -i \/license\_Somatic.bin

sudo /opt/edico/bin/dragen\_lic -i \/license\_CNV.bin

sudo /opt/edico/bin/dragen\_lic -i \/license\_JointGenotype.bin

sudo /opt/edico/bin/dragen\_lic -i \/license\_Transcriptome.bin

sudo /opt/edico/bin/dragen\_lic -P \/\\_license.dat


For TSO500/TSO500 ctDNA:
sudo /opt/edico/bin/dragen\_lic -i \/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*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000003834%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* | | | | | | | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | *For any feedback or questions regarding this article (Illumina Knowledge Article #3834), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000003834%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* | | | sudo /opt/edico/bin/dragen\_lic -i auto | | - | --------------------------------------- | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://knowledge.illumina.com/software/on-premises-software/software-on-premises-software-troubleshooting-list/000003834.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.