# 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.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.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.exe` 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
```