# Installation of NovaSeq 6000Dx TSO 500 Analysis Application

## Prerequisites

* A NovaSeq 6000Dx sequencing instrument with paired DRAGEN server v4
* Illumina Run Manager installed by Illumina support personnel
* `TSO500Combined` and `TSO500_HRD` licenses installed by Illumina support personnel
  * `TSO500Combined` and `TSO500_HRD` licenses are pre-installed in manufacturing since February 2025 and will need to be installed only for instruments purchased prior to that
* The user installing the app must have admin privileges on Illumina Run Manager

## Installation Instructions

1. Contact Illumina Customer Care\
   Contact Illumina Customer Care at <customercare@illumina.com> to obtain installation package for Illumina DRAGEN TruSight Oncology 500 (HRD) Analysis Application on NovaSeq 6000Dx.
2. Download the installation package\
   Download the installation package provided in the email by Illumina Customer Care. The link will expire after 7 days.

{% hint style="info" %}
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 name of either DRAGEN TSO 500 Analysis Application file or DRAGEN ires file, and the link is provided by Illumina Customer Care.
{% endhint %}

3. Installation package contents\
   The installation package contains the following:

<table><thead><tr><th width="213">Software</th><th width="88">Version</th><th width="332">Type</th><th>Dragen version installed</th></tr></thead><tbody><tr><td>DRAGEN TSO 500 v2.6.0</td><td>2.6.0</td><td><ul><li><p>DRAGEN TSO 500 Analysis Application: <code>DRAGEN_TSO500HRD_v2.6.0-2v12.iapp</code></p><ul><li><p>MD5sum:</p><p>After Feb 5, 2025: <em><code>608bde0f63bc1ae54e746e273055e749</code></em></p><p>Before Feb 5, 2025: <em><code>dc4fe5fe2fc3eca57969e978886dcedf</code></em></p></li></ul></li><li><p>DRAGEN ires: <code>drageninstaller_3.10.17-8.el8.x86_64_prod.ires</code></p><ul><li>MD5sum: <em><code>12df06502776d8b673c73fb714dc466a</code></em></li></ul></li></ul></td><td>3.10.17</td></tr><tr><td>DRAGEN TSO 500 v2.6.2</td><td>2.6.2</td><td><ul><li><p>DRAGEN TSO 500 Analysis Application: <code>DRAGEN_TSO500HRD_v2.6.2-4v3.iapp</code></p><ul><li>MD5sum:<em><code>f3d6575ef068fbc13f1cfdc2cb9e633e</code></em></li></ul></li><li><p>DRAGEN ires: <code>drageninstaller_3.11.2-8.el8.x86_64_prod.ires</code></p><ul><li>MD5sum: <em><code>cd980922bb3ed456ff31295ff49cb2fa</code></em></li></ul></li></ul></td><td>3.11.2</td></tr></tbody></table>

{% hint style="warning" %}
The v2.6.2 app uses DRAGEN v3.11.2, which is not designed to be co-installed with earlier DRAGEN versions (e.g. v3.10.18 and below, v4.3.5 and below). When launching analysis after installing another NovaSeq 6000Dx app and its dependent version of DRAGEN (that does not support multi-version installation), the software may sporadically be unable to run.\
\
For example, users may encounter an issue if the following steps occur in order:

1. installation of the DRAGEN TSO 500 v2.6.2 app for NovaSeq 6000Dx and its dependent DRAGEN, v3.11.2
2. installation of the DRAGEN TSO 500 v2.6.0 app\* for NovaSeq 6000Dx and its dependent DRAGEN, v3.10.17
3. analysis is initiated using DRAGEN TSO 500 v2.6.2 app

<sup>\*</sup>or any other app requiring an incompatible DRAGEN version. See [installation-of-2.6.2-on-standalone-dragen-server](https://help.tso500software.illumina.com/dragen-tso-500-guides/dragen-tso-500-v2.6/getting-started/installation-of-2.6.2-on-standalone-dragen-server "mention") for DRAGEN co-installation compatibility.

See Troubleshooting section for a workaround. [novaseq-6000dx-app-troubleshooting](https://help.tso500software.illumina.com/dragen-tso-500-guides/dragen-tso-500-v2.6/troubleshooting/novaseq-6000dx-app-troubleshooting "mention")
{% endhint %}

4. Install the DRAGEN version using the ires:
   1. Log into Illumina Run Manager as a user with admin credentials
   2. Navigate to the top left menu to "DRAGEN" in the drop down
   3. Select "Add DRAGEN Installer" and upload the DRAGEN ires file
   4. The installation is complete once the DRAGEN version as list in table above is in the install version(s) list

\\