Installation of TSO 500 ctDNA v2.6.0 on Standalone DRAGEN Server
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.
Installation Instructions
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.
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.
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_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/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.
Running the System Check
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.
Uninstall Software
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.
Last updated
Was this helpful?