# 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

\\


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tso500software.illumina.com/dragen-tso-500-guides/dragen-tso-500-v2.6/getting-started/installation-of-novaseq-6000dx-tso-500-analysis-application.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.