DRAGEN Bio IT Platform v3 Oracle 8 upgrade instructions

Important Notes:

1. Remote upgrade (via BMC) is not supported.

2. DRAGEN v3.9.5 and above have Oracle Linux 8 specific installers.

3. DRAGEN TSO500 v2.1 (or higher) and DRAGEN TSO500 Solid v2.1.1 (or higher) have Oracle Linux 8 specific installers. Contact [e-mail] for the installers.

4. Users running older versions of DRAGEN and/or specialized workflows such as DRAGEN TSO500 Solid/ctDNA, DRAGEN Covid Pipeline must stay on CentOS 7.

Introduction CentOS 7 is reaching end-of-life and will no longer receive maintenance and security updates after June 30, 2024. For more information, refer to the CentOS product information page.

Illumina will be discontinuing support of the CentOS 7 operating system for all DRAGEN Servers on June 30, 2024. Illumina will continue to release DRAGEN software versions compatible with CentOS 7 through June 30, 2023.

Users with the Illumina DRAGEN Server v3 or v4 should make plans to upgrade their affected DRAGEN Servers to Oracle 8 before June 30, 2023 to continue to receive the latest DRAGEN software.

Prerequisites

• USB stick (at least 8GB) for the bootable image.

• A second USB stick for backup files.

• Identify if the DRAGEN server is a v3 or v4; below are pictures of a v3 server that can be used as reference. These instructions are specific to a v3 server.

  Front-side of a v3 server

  

Back-side of a v3 serverBackup Data

Note: The re-imaging process will delete all existing files and settings from the server. Backup any user data and settings before installing the new OS.

1. Login as root.

2. Insert the USB stick for backups into the DRAGEN server.

3. To identify the USB device name, run:

$ fdisk -l  

The USB should be recognized as /dev/sdX where X is a number.

4. Create a directory to mount the USB to:

$ mkdir /media/backupUSB  

5. Mount the backup USB.

$ mount /dev/sdX /media/backupUSB  

6. Obtain the serial number of the DRAGEN server by running the command:

$ dragen_info -b | grep 'Serial Number' | awk -F" " '{print $3}'  

7. Using the serial number that was just found, create a directory on the USB which will hold the backup files. Users can name the directory whatever they like, but using the serial number is a good idea if users have multiple DRAGEN servers.

$ mkdir /media/backupUSB/[SerialNumber]  

8. Change directories into the backup directory that was just created.

$ cd /media/backupUSB/[SerialNumber]  

9. Backup License files using the command:

$ tar -cvpf licenses.tar /var/lib/edico  

10. Backup mount points (fstab file).

$ cp /etc/fstab .  

Preparing Bootable USB

1. Download OL8 ISO. a. Verify checksum: MD5: 2CC7755477EB29E0BCF371A944B6F423

Information on how the MD5 checksum is generated can be found here: Generating the MD5 checksum for a file

2. Prepare a dedicated bootable USB with Ventoy.

• Download the installation package from here (like ventoy-x.x.xx-windows.zip).

  
• On the next page, select the green button "Download latest version" to download Ventoy.

  
• Unzip/Decompress the downloaded file.

• Run Ventoy2Disk.exe, select the USB drive (8GB or larger) and select the Install button (note: these images are from the Windows version).

  
• Copy the downloaded ISO file to the USB stick (or manually drag-drop to the USB drive).

• Verify MD5 checksum for ORCL8 file from step 1.

Installation

1. Insert bootable USB with the OL8 image; login as root.

2. Restart the server.

$ reboot -f  

3. Press DELETE to enter the BIOS while the system boots up.

4. In BIOS, go to the last tab, Save & Exit; scroll down to the Boot Override section using arrow keys and choose the USB drive UEFI: USB, Partition 2.
5. The system will open Ventoy user interface; select the Clonezilla option.
6. This will start Clonezilla, select the first option (Default settings, VGA 800x6000).

The installer runs for a few minutes, and once it installs Oracle Linux 8, it automatically reboots.

7. Once the system boots up (from the hard drive), select the first option, Oracle Linux Server (4.18.0-372.26.1.0.1.el8_8.x86_64) 8.6 or leave the screen as is (the first option is automatically loaded if nothing is selected in 10 seconds).

The system will reboot once this step is done.

8. Login using default root login credentials .

`Username: root`    
`Password: Hello@Illumina!`  

Users will be prompted to change the default root password at first login.

9. Run the following script.

$ /usr/local/bin/mfg_unset.sh  

Steps after Installation

1. Apply network configuration (refer to the page 15 of the Site Prep and Installation Guide for instructions.

2. Insert the backup USB.

3. To identify the USB name, run:

$ fdisk -l  

the USB will be recognized as /dev/sdX where X is a number.

4. Create a directory to which to mount the USB.

$ mkdir /media/backupUSB  

5. Mount the backup USB.

$ mount /dev/sdX /media/backupUSB  

6. Change into the USB backup directory. Make sure that the backup folder for the correct server is being used. If the serial number was used this would look like:

$ cd /media/backupUSB/[SerialNumber]  

7. Restore the DRAGEN license files.

$ tar -xvf license.tar -C /  

8. Restore the NFS and CIFS mounts from the fstab backup.

$ awk '$3 ~ /^(nfs|cifs)/' fstab >> /etc/fstab && mount -a  

9. Download and install the latest version of DRAGEN from the support site.

10. Confirm successful installation by running the DRAGEN self test.

$ /opt/edico/self_test/self_test.sh  

For DRAGEN v4.3.6 and higher, a self test can be run with the following command

$ /opt/dragen/4.3.6/self_test/self_test.sh  

If self test fails, perform a cold reboot of the server and run it again.

11. Create additional users as needed.

For any feedback or questions regarding this article (Illumina Knowledge Article #7438), contact Illumina Technical Support [e-mail].