When installing DRAGEN TruSight Oncology 500 and DRAGEN TruSight Oncology 500 ctDNA software on the same DRAGEN server, install the software with the highest corresponding DRAGEN Software version last, as versions below v2.6.0 will overwrite with its corresponding DRAGEN Software version.
If a prior version of DRAGEN TruSight Oncology 500 ctDNA Analysis Software (eg. v2.5.0) is installed after v2.6.0, re-execute the installation script for v2.6.0 to install the compatible version of DRAGEN Software without impacting other installations.
As a root user, perform the following steps to install DRAGEN TruSight Oncology 500 ctDNA v2.6.0 Analysis Software:
Contact Illumina Customer Care at customercare@illumina.com to obtain the DRAGEN TruSight Oncology 500 Analysis Software installer package.
Download the installation package provided in the email from Illumina. The link expires after 7 days.
It is recommended to use a command line tool like wget or curl to download the file rather than pasting the link into the web browser bar. For example:
curl -o {filename} "{link}"
wget -O {filename} "{link}"
Where the file name is the installation script file name, and the link is provided by Illumina Customer Care.
Make sure no other analysis is being performed. Installing the software while performing other analyses prevent the installer process from proceeding
Copy the install script to the /staging directory to store the script in the directory.
Installation Script: install_DRAGEN_TSO500_ctDNA-2.6.0.run
MD5sum values v2.6.0: sha256:1ce33d63c1a499768af7e238d41f81c29dea3e5fe5cc2b08abf12b8afec5bd89 v2.6.1: sha256:bbd07dc63a9da517414460218dd9c12fde88a7378178c214ed2b8beba0f9483f
Use the following command to update the run script permission:
chmod +x /staging/install_DRAGEN_TSO500_CTDNA-2.6.0.run
Use the following command to run the installation script, which runs for approximately 20 minutes:
For Docker, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500_CTDNA-2.6.0.run . The script installs compatible DRAGEN software and removes any previously installed versions.
For Apptainer, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500_CTDNA-2.6.0.run -- --noDockerInstall This will not install Apptainer, but will install the analysis software in the Singularity Image File (SIF) format and modify the software to launch analyses using Apptainer.
During the installation process, you might be instructed to reboot or power cycle the system to complete the installation of the DRAGEN software. A power cycle of the system requires the server be shut down and restarted.
Log out of the server and then log back in.
Install your DRAGEN server licenses if needed:
To run DRAGEN TruSight Oncology 500 ctDNA v2.6.0 Analysis Software, you need TSOCombined license. This license is pre-installed on DRAGEN servers purchased after August 2022. To check if the license is already installed, run /opt/edico/bin/dragen_liccommand.
For servers connected to the Internet, install your software licenses as follows:
First, test and confirm that the server is connected to the Internet. Example: ping www.illumina.com
To install the license, enter: /opt/edico/bin/dragen_lic -i auto
For servers not connected to the internet, contact Illumina Customer Care at customercare@illumina.com for license information.
After installing DRAGEN server licenses, generate a list of installed DRAGEN server licenses by running the following command: /opt/edico/bin/dragen_lic
If license installation is successful, the list should include TSOCombined.
If the expected licenses are not installed, contact Illumina Customer Care.
After installation is complete, make sure the system functions properly by running the following command: /usr/local/bin/check_DRAGEN_TSO500_CTDNA-2.6.0.sh
The script checks that:
All required services are running
Proper Docker image is installed
DRAGEN TruSight Oncology 500 ctDNA Analysis Software can successfully process a test data set
The system check script runs for approximately 25 minutes. If the script prints a failure message, contact Illumina Technical Support and provide the /staging/check_DRAGEN_TSO500_CTDNA_<timestamp>.tgz output file.
If using MacOS to connect to a server, an error can occur if the local settings are not in English. To resolve the error, disable the ability to set environment variables automatically in Terminal settings.
The DRAGEN TruSight Oncology 500 Analysis Software installation includes an uninstall script called uninstall_DRAGEN_TSO500_CTDNA-2.6.0.sh, which is located in /usr/local/bin.
Executing the uninstall script removes the following assets:
All DRAGEN TruSight Oncology 500 ctDNA Analysis Software related scripts located in /usr/local/bin
Resources found in /staging/illumina/DRAGEN_TSO500_CTDNA
The dragen_tso500_ctdna Docker image
To uninstall the DRAGEN TruSight Oncology 500 ctDNA Analysis Software, run the following command as a root user:
uninstall_DRAGEN_TSO500_CTDNA-2.6.0.sh
You are not required to uninstall Docker or DRAGEN software. To remove Docker, review the install instructions for your operating system in the Docker documentation.
*DRAGEN TSO 500 Analysis Software v2.6.1 can run on a single server with another multi-version compatible DRAGEN TSO 500 Analysis Software, e.g. DRAGEN TSO 500 v2.5.4, and should be installed after v2.5.4. DRAGEN TSO 500 Analysis Software v2.6.1 can be co-installed with multi-version compatible DRAGEN TSO 500 ctDNA Analysis Software or other DRAGEN pipelines with any order of installation.
**For example, DRAGEN Enrichment, DRAGEN Germline, and others. Order of installation does not matter.
Uninstall all existing single-version compatible software on the server (see table above)
Install DRAGEN TSO 500 ctDNA Analysis Software v2.6.2
This step will disrupt previously installed single-version compatible software but will not impact multi-version compatible ones (see table above)
Install other multi-version DRAGEN software/pipelines if needed
Multi-version software can be installed in any order
As a root user, perform the following steps to install DRAGEN TSO 500 ctDNA Analysis Software v2.6.2:
Contact Illumina Customer Care at to obtain the DRAGEN TSO 500 ctDNA Analysis Software installer package.
Download the installation package provided in the email from Illumina. The link expires after 7 days.
It is recommended to use a command line tool like wget or curl to download the file rather than pasting the link into the web browser bar. For example:
curl -o {filename} "{link}"
wget -O {filename} "{link}"
Where the file name is the installation script file name, and the link is provided by Illumina Customer Care.
Make sure no other analysis is being performed. Installing the software while performing other analyses prevents the installer process from proceeding.
Copy the install script to the /staging directory to store the script in the directory.
Installation Script: install_DRAGEN_TSO500_CTDNA-2.6.2.run
MD5sum value: sha256:fb88b215f5f1077e9bff2cc153c739060a0f29c359523f4f9cbe36eb3258a85c
Use the following command to update the run script permission:
chmod +x /staging/install_DRAGEN_TSO500_CTDNA-2.6.2.run
Use the following command to run the installation script (run time ~ 20 minutes):
For Docker, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500_CTDNA-2.6.2.run . The script installs compatible DRAGEN software and removes any previously installed versions.
For Apptainer, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500_CTDNA-2.6.2.run -- --noDockerInstall This will not install Apptainer, but will install the analysis software in the Singularity Image File (SIF) format and modify the software to launch analyses using Apptainer.
During the installation process, you may be instructed to reboot or power cycle the system to complete the installation of the DRAGEN software. A power cycle of the system requires the server be shut down and restarted.
Log out of the server and log back in.
Install your DRAGEN server licenses if needed:
To run DRAGEN TSO 500 ctDNA Analysis Software v2.6.2 , you need TSOCombined license. This license is pre-installed on DRAGEN servers purchased after August 2022. To check if the license is already installed, run /opt/dragen/3.10.19/bin/dragen_lic command.
For servers connected to the Internet, install your software licenses as follows:
First, test and confirm that the server is connected to the Internet. Example: ping www.illumina.com
To install the license, enter: /opt/dragen/3.10.19/bin/dragen_lic -i auto
After installing DRAGEN server licenses, generate a list of installed licenses by running the following command: /opt/edico/bin/dragen_lic
If license installation is successful, the list should include TSOCombined.
If the expected licenses are not installed, contact Illumina Customer Care.
After installation is complete, make sure the system functions properly by running the following command: /usr/local/bin/check_DRAGEN_TSO500_CTDNA-2.6.2.sh
The script checks that:
All required services are running
Proper Docker image is installed
DRAGEN TSO 500 ctDNA Analysis Software can successfully process a test data set
The system check script runs for approximately 25 minutes. If the script prints a failure message, contact Illumina Technical Support and provide the /staging/check_DRAGEN_TSO500_CTDNA_<timestamp>.tgz output file.
If using MacOS to connect to a server, an error can occur if the local settings are not in English. To resolve the error, disable the ability to set environment variables automatically in Terminal settings.
The DRAGEN TSO 500 ctDNA Analysis Software installation includes an uninstall script called uninstall_DRAGEN_TSO500_CTDNA-2.6.2.sh, which is located in /usr/local/bin.
Executing the uninstall script removes the following assets:
All DRAGEN TSO 500 Analysis Software related scripts located in /usr/local/bin
Resources found in /staging/illumina/DRAGEN_TSO500_CTDNA-2.6.2
The dragen_tso500_ctdna Docker image
To uninstall the DRAGEN TSO 500 ctDNA Analysis Software, run the following command as a root user:
uninstall_DRAGEN_TSO500_CTDNA-2.6.2.sh
You are not required to uninstall Docker or DRAGEN software. To remove Docker, review the install instructions for your operating system in the Docker documentation.
For servers not connected to the internet, contact Illumina Customer Care at for license information.
Instructions to install DRAGEN TSO 500 ctDNA Analysis Application on NovaSeq 6000Dx (RUO mode)
The following requirements must be met to install and run DRAGEN TruSight Oncology 500 ctDNA Analysis Application on NovaSeq 6000Dx:
A NovaSeq 6000Dx sequencing instrument with Illumina Run Manager v1.6.2 or later installed and paired with DRAGEN Server v4.
Administrator privileges on Illumina Run Manager.
Perform the following steps to download and install the DRAGEN TruSight Oncology 500 ctDNA Analysis Application on NovaSeq 6000Dx installation package:
Contact Illumina Customer Care for the link to the installation package. The link expires after 7 days.
Download the installation package with the link provided in the email from Illumina Customer Care. The installation package contains the following files:
DRAGEN IRES file: drageninstaller_<DRAGEN_VERSION>.el8.x86_64_prod.ires
Illumina Run Manager: TSO500L_v<APP_VERSION>.iapp
Install the DRAGEN version using the IRES file.
Log into Illumina Run Manager as an administrator.
From the Settings menu, select DRAGEN.
Select Add DRAGEN Installer.
Select the DRAGEN IRES file to begin installation.
Check the install versions list to verify that the appropriate DRAGEN version is listed
Install the Illumina Run Manager-compatible application.
Log into Illumina Run Manager as an administrator.
From the left-hand menu, select Applications.
Select the RUO tab, select Install Application, and then select the IAPP file to install the application.
Check the RUO Applications list to verify that the appropriate application version is listed. You can configure application settings such as required users from this list.
Perform the following steps to specify a location to store analysis results:
Log into Illumina Run Manager as an administrator.
From the Settings menu, select External Storage for Analysis Results.
Configure the following parameters:
Server Location: The path of the preferred output file location. A change to the server location may prompt you to enter the domain, user name, and password to the new server location.
In addition to storing the analysis results from any sequencing runs, this location contains the input data created when setting up runs. Make sure that the server location has sufficient storage space for your run.
Encryption—Select Require encryption during file transfer.
Select Save to preserve the changes to the external storage output parameters.
Illumina Connected Analytics (ICA) subscription includes access to DRAGEN TruSight Oncology 500 ctDNA Analysis Software. To get started, you need:
An ICA account with a valid subscription
A positive balance of iCredits for data storage
Refer to the Software Registration page for information on how to register ICA subscription and iCredits.