Install DRAGEN TruSight Oncology 500 ctDNA Local Analysis Software
Installing the DRAGEN TruSight Oncology 500 ctDNA Local Analysis Software requires root privileges.
To run the product successfully on DRAGEN v3 servers, you must update the Docker configuration to store images and other working files in the /staging directory of the DRAGEN server, where there is sufficient storage space. To update the Docker configuration, you need root privileges to reconfigure Docker.
1. | Contact Illumina Technical Support to request a link to the installation script and confirm that the TSO 500 DRAGEN license is enabled for your server. Follow the instructions for DRAGEN license installation provided by Illumina Technical Support. Instructions are also available in the DRAGEN Server v3 Site Prep & Installation Guide (document # 1000000097923). |
2. | Download the installation script from the link provided in the email from Illumina. The link expires 7 days from generation. |
3. | Store the install_DRAGEN_TruSight_Oncology_500_ctDNA-2.1.1.run script in the /staging directory. |
The script requires approximately 33 GB of free space. Illumina recommends storing and executing the self-extracting installation script from the /staging directory.
4. | Update the permissions on the run script using the following command: |
sudo chmod +x /staging/install_DRAGEN_TruSight_Oncology_500_ctDNA-2.1.1.run
5. | Execute the installation script using the following command: |
use export TMPDIR=/staging. \
sudo /staging/install_DRAGEN_TruSight_Oncology_500_ctDNA-2.1.1.run
The self-test script checks the following functions and runs for approximately 30 minutes.
• | All the |
• | The proper resources are in place. |
• | The proper Docker images have been installed. |
• | The TruSight Oncology 500 ctDNA software can run successfully on a test data set. |
1. | Make sure the installation script has finished, and then run the following self-test script: |
/usr/local/bin/test_DRAGEN_TruSight_Oncology_500_ctDNA-2.1.1.sh
If the self-test prints a failure message, contact Illumina Technical Support and provide the output file found in /staging/tmp/test_DRAGEN_TruSight_Oncology_500_ctDNA_<timestamp>.tgz.
2. | [Optional] Only one user can run the self-test script. To run the self-test script for more than one user, use one of the following methods: |
• | Delete the /staging/tmp directory. |
• | Run the following command to allow all users to write to the /staging/tmp directory: |
chmod 777 /staging/tmp
When running an analysis on the DRAGEN server via SSH, Illumina recommends that you use a terminal multiplexer utility, which allows you to resume analysis in the event of a disconnection from the DRAGEN server.