# Software Installation

## Installation Requirements

The following are the minimum requirements for the DRAGEN ORA Decompression Software:

| Component                       | Minimum Requirement                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| System memory                   | 8 GB RAM                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Free disk space                 | <p>From 2 GB to 15 GB depending on how many different specific references are needed for the decompression. Specific references are available for downloads in the <a href="https://support.illumina.com/sequencing/sequencing_software/DRAGENORA.html">ORA Support Site</a>.<br>For human data, 2 GB are required. The default human reference is already pre-installed within the software and does not need to be downloaded.</p> |
| Compatible Linux distributions  | <ul><li>CentOS 7 and later</li><li>Ubuntu 14 and later</li><li>Oracle 8 and later</li><li>Fedora 26</li><li>Debian 8</li></ul>                                                                                                                                                                                                                                                                                                       |
| Compatible Mac distribution     | Mac 10.15 and later (Apple silicon and Intel CPU processors)                                                                                                                                                                                                                                                                                                                                                                         |
| Compatible Windows distribution | Windows 10 and later                                                                                                                                                                                                                                                                                                                                                                                                                 |

## Installing the DRAGEN ORA Decompression Software

Use the following steps to install the DRAGEN ORA Decompression Software once DRAGEN ORA Decompression has been downloaded from the [ORA Support Site](https://support.illumina.com/sequencing/sequencing_software/DRAGENORA.html).

### Linux or Mac

**1.** Extract the archive files using the following command:

```
tar -xzvf orad.2.7.0.linux.tar.gz (Linux) 
tar -xzvf orad.2.7.0.mac.tar.gz (Mac)
```

**2.** Navigate to the `Orad` directory as follows:

```
cd orad.2.7.0.linux
```

**3.** Move the executable to your preferred location as follows:

```
mv orad your_preferred_location/
```

**4.** Add Orad to your path as follows:

```
echo 'PATH=$PATH: your_preferred_location/'» ~/.bashrc source ~/.bashrc

```

**5.** Move the `oradata` folder content into the home repository as follows:

```
mv oradata ~
```

To store the folder in a different location, use the following command:

```
mv oradata ~/otherlocation/
```

When oradata has been moved in another location, you can:

* either point to the reference by using the `ORA_REF_PATH` environment variable as follows:

```
export ORA_REF_PATH=~/otherlocation/oradata/
```

* or use the following command at decompression

```
--ora-reference ~/otherlocation/
```

### Windows

**1.** Extract the downloaded archive with a software that can handle gziped tarballs, such as 7-Zip. Right-click on the archive and select **Extract with**. The following two files are extracted:

* orad-win64.exe
* refbin

The following steps use C:\Users\user1 as an example location. Change C:\Users\user1 to the location where you extracted the archive.

**2.** Open the Command Prompt application.

**3.** Set the environment variables to use the `orad-win64.exe` and the `refbin` file with the `set` command or the `setx` command. The `set` command configures the variables temporarily (for the current console window) while the `setx` command configures the variables permanently.

**4.** Set the path to the `orad-win64.exe` file to the `PATH` environment variable as follows:

```
set PATH=%PATH%; C:\Users\user1
```

or

```
setx PATH=%PATH%; C:\Users\user1
```

**5.** Set the path to the `refbin` file to an ORA\_REF\_PATH environment variable as follows:

```
set ORA_REF_PATH= C:\Users\user1
```

or

```
setx ORA_REF_PATH= C:\Users\user1
```


---

# 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.connected.illumina.com/ora/product-guides/dragen-ora-decompression/software-installation.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.
