> For the complete documentation index, see [llms.txt](https://help.connected.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.connected.illumina.com/dragen/dragen-v4.6/reference/licensing/onprem_licensing.md). # DRAGEN Server Licensing DRAGEN Servers use Legacy Gigabase Pricing: a prepaid quota of gigabases. This quota is separate from BioInsight Credits used in BioInsight Platform Core. Contact [Illumina Sales](https://www.illumina.com/company/contact-us.html#/sales) for pricing. On-Premises DRAGEN supports both Connected and Dark Site Licensing. {% hint style="info" %} A DRAGEN Server can alternatively be used in Software Mode, running DRAGEN on the server's CPUs and authenticating with an Illumina BioInsight Platform API key instead of installed licenses. In that case the licensing on this page does not apply, and DRAGEN 4.6 runs use DRAGEN Pricing. See [BioInsight Platform Licensing](/dragen/dragen-v4.6/reference/licensing/api_key_licensing.md). {% endhint %} ## 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. {% hint style="warning" %} **DRAGEN 4.2 and earlier**: `dragen_lic` is located at `/opt/edico/bin/dragen_lic` instead. {% endhint %} ### 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 ``` {% hint style="warning" %} **DRAGEN 4.4.4 only**: If PipSeq is not already installed, `sudo dragen_lic -i auto` will **not** retrieve it. You must explicitly request it by name using the `-f` option, as shown below. This limitation is specific to **DRAGEN 4.4.4**. On **DRAGEN v4.4.6 and later**, the standard `sudo dragen_lic -i auto` command is sufficient to install PipSeq. {% endhint %} ``` sudo dragen_lic -i auto -f PipSeq ``` ### 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 .bin ``` As an example, let's say you receive a zipfile containing the following license files; Genome, Compression, CNV, Somatic, Transcriptome, and JointGenotype. ``` sudo dragen_lic -i license_genome.bin sudo dragen_lic -i license_compression.bin sudo dragen_lic -i license_cnv.bin sudo dragen_lic -i license_somatic.bin sudo dragen_lic -i license_transcriptome.bin sudo dragen_lic -i license_jointgenotype.bin ``` ## Retrieving License Information and Usage There are three options for retrieving information and usage regarding your installed licenses. Examples for each one are below. {% hint style="warning" %} **Version requirement**: Basic Output (`-b`) and JSON Output (`-j`) require **DRAGEN 4.3 or higher**. On earlier versions, Detailed Output (no flag) is the only method available. {% endhint %} * 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. * 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. * **DRAGEN 4.3**: a single license object per license type. **DRAGEN 4.4 and higher**: a list of license objects per license type. * Detailed Output (i.e., no additional arguments). This is the default method for retrieving license information. In general it is recommended to instead use one of the above two options if possible. {% hint style="info" %} `dragen_lic` reports installed prepaid licenses and their quota. {% endhint %} ``` $ dragen_lic -b SN: DRAGEN Version: Time: