Installing Red Hat Enterprise Linux

There are several methods for installing Red Hat Enterprise Linux as described in the Red Hat Enterprise Linux Installation Guide.

See the DGX Software for Red Hat Enterprise Linux Release Notes for the Linux distributions that are qualified and tested for use with the DGX Software.

For convenience, this section describes how to install Red Hat Enterprise Linux using the Quick Install method, and shows when to reclaim disk space in the process. It describes a minimal installation. If you have a preferred method for installing Red Hat Enterprise Linux, then you can skip this section but be sure to reclaim disk space occupied by the existing Ubuntu installation.

The interactive method described here installs Red Hat Enterprise Linux on DGX using a connected monitor and keyboard and USB stick with the ISO image, or remotely through the remote console of the BMC.

Obtaining Red Hat Enterprise Linux

Obtain the Red Hat Enterprise Linux ISO image and store on your local disk or create a boot USB drive formatted for UEFI. See Downloading Red Hat Enterprise Linux for instructions.

Booting Red Hat Enterprise Linux ISO Locally

  1. Plug the USB flash drive containing the Red Hat Enterprise Linux ISO image into the DGX.
  2. Connect a monitor and keyboard directly to the DGX.
  3. Boot the system and press F11 when the NVIDIA logo appears to get to the boot menu.
  4. Select the UEFI volume name that corresponds to the inserted USB flash drive, and boot the system from it.
  5. Follow the instructions at Installing Red Hat Enterprise Linux

Booting Red Hat Enterprise Linux ISO Remotely

Skip this chapter if you are using a monitor and keyboard for installing locally.

Booting the ISO Image on the DGX-1 Remotely

Skip this chapter if you are using a monitor and keyboard for installing locally. For instructions applicable to the NVIDIA DGX-2, see Booting the ISO Image on the DGX-2 Remotely
  1. Connect to the BMC and change user privileges.
    1. Open a Java-enabled web browser within your LAN and go to http://<BMC-ip-address>/, then log in.

      Use Firefox or Internet Explorer. Google Chrome is not officially supported by the BMC.

    2. From the top menu, click Configuration and then select User Management.
    3. Select the user name that you created for the BMC, then click Modify User.
    4. In the Modify User dialog, select the VMedia checkbox to add it to the extended privileges for the user, then click Modify.

  2. Set up the ISO image as virtual media and reboot the system.
    1. From the top menu, click Remote Control and select Console Redirection.

    2. Click Java Console to open the remote JViewer window. Make sure pop-up blockers are disabled for this site.
    3. From the JViewer top menu bar, click Media and then select Virtual Media Wizard.

    4. From the CD/DVD Media: I section of the Virtual Media dialog, click Browse and then locate the Red Hat Enterprise Linux ISO file on your system and click Open.

      You can ignore the device redirection warning at the bottom of the Virtual Media wizard as it does not affect the ability to re-image the system.

    5. Click Connect CD/DVD, then click OK at the Information dialog.

      The Virtual Media window shows that the ISO image is connected.

    6. Close the window. The CD ROM icon in the menu bar turns green to indicate that the ISO image is attached.

    7. From the top menu, click Power and then select Reset Server.

    8. Click Yes and then OK at the Power Control dialogs, then wait for the system to power down and then come back online.
  3. Boot the CD ROM image.

    Typically, the default boot order does not boot the CDROM image. This can be changed in the BIOS or as a one-time option in the boot menu. To bring up the boot menu, press F11 at the beginning of the boot process. Pressing F11 will display Show Boot Options at the top of the virtual display before entering the boot menu. Use the ‘soft’ keyboard (Menu → Keyboard Layout → SoftKeyboard → <Language>) to bring up a virtual keyboard if pressing the physical key has no effect.

    1. In the boot menu, select UEFI: AMI Virtual CDROM 1.00 as the boot device and then press ENTER.

    2. Follow the instructions at Installing Red Hat Enterprise Linux.

Booting the ISO Image on the DGX-2 Remotely

Skip this chapter if you are using a monitor and keyboard for installing locally.
  1. Connect to the BMC and ensure the required user privileges are set.
    1. Open a browser within your LAN and go to https://<BMC-ip-address>/, then log in.
    2. From the left-side menu, click Settings and then select User Management.
    3. Click the card with the user name that you created for the BMC.
    4. In the User Management Configuration dialog, make sure the VMedia Access checkbox is selected, then click Save.

  2. Set up the ISO image as virtual media.
    1. From the left-side menu, click Remote Control.

    2. Select Launch KVM.

    3. From the top menu bar in the KVM window, click Browse File and select the ISO image, then click Start Media.

      The CD image should now be connected.

    4. From the top menu bar in the KVM window, click Power and then select Reset Server.
  3. Boot from the virtual media.

    Typically, the default boot order does not boot the CDROM image. This can be changed in the BIOS or as a one-time option in the boot menu.

    1. To bring up the boot menu, press F11 at the beginning of the boot process.

      Pressing F11 will display Entering Boot Menu in the virtual display before entering the boot menu.

    2. In the boot menu, select UEFI: Virtual CDROM 1.00 as the boot device and then press ENTER.

    3. Follow the instructions at Installing Red Hat Enterprise Linux

Installing Red Hat Enterprise Linux

Installing on the DGX-1

This section assumes you have booted the Red Hat Enterprise Linux ISO image, either locally or remotely.

For instructions applicable to the DGX-2, see Installing on the DGX-2 .

  1. After booting the ISO image through either the BMC or from the USB drive, select Install Red Hat Enterprise Linux and then press Enter to start the installation.

  2. Refer to the Red Hat Enterprise Linux Quick Installation Guide for guidance on using the installer.

    Configure the language, region, date, time, keyboard, and other configuration options you may need from the Installation Summary screen.

  3. Set up the system drive.

    This step removes the Ubuntu installation in order to reclaim space for the Red Hat Enterprise Linux installation.

    1. From the Installation Summary screen, click INSTALLATION DESTINATION.

    2. Select the first drive (sda) as the installation drive, then select Automatically configure partitioning under Other Storage Options and click Done.

      The Installation Options dialog box appears.

    3. At the Installation Options dialog, click Reclaim space.

    4. At the Device Selection screen, click Delete all to delete all existing data on the system drive.

    5. Click Reclaim space to permanently delete all data from the drive and to use it as the destination drive.

  4. Configure Ethernet.

    Select and enable the Ethernet device. This defaults to DHCP and can be changed for static IP configurations under Configure.

  5. From the INSTALLATION SUMMARY screen, click Begin installation to start the installation.

    1. While the installation process is running, set your password (ROOT PASSWORD) and create a new user (USER CREATION) from the Configuration screen.
    2. When the installation completes, click Reboot to reboot the system.
      Note: If you have installed Red Hat Enterprise Linux 7.5 and are using the BMC remote console, then follow the instructions provided in the release notes under Black screen on BMC Remote Console with Red Hat Enterprise Linux 7.5.
  6. Register the system with the Red Hat Enterprise Customer Portal to complete the initial setup.
    • If you installed with the Server with GUI base environment, the Initial Setup starts automatically where you can accept the license agreement and register the system. See the Red Hat instructions for details.
    • If you installed with any other base environment, log on to the system as root user and then register the system.
      subscription-manager register --auto-attach --username=user_name --password=password
    See How to register and subscribe a system to the Red Hat Customer Portal using Red Hat Subscription-Manager for further information.

Installing on the DGX-2

This section assumes you have booted the Red Hat Enterprise Linux ISO image, either locally or remotely.

For instructions applicable to the DGX-1, see Installing on the DGX-1.

  1. After booting the ISO image through either the BMC or from the USB drive, select Install Red Hat Enterprise Linux and then press Enter to start the installation.

  2. Refer to the Red Hat Enterprise Linux Quick Installation Guide for guidance on using the installer.

    Configure the language, region, date, time, keyboard, and other configuration options you may need from the Installation Summary screen.

  3. Set up the boot disks.

    The DGX OS, which is installed in the factory before shipping out the DGX-2, creates a RAID-1 array on the two M.2 NVMe boot disks. Therefore, it is necessary to select both boot disks when installing RHEL 7 on a DGX-2.

    1. From the Installation Summary screen, click INSTALLATION DESTINATION.

    2. At the Installation Destination screen, select both M.2 disks (i.e. the 894.25 GB ones) and the "I will configure partitioning" radio button, then click Done.

      The Manual Partitioning window appears.

    3. Expand the Unknown drop-down menu.

      This shows the disks that Red Hat Enterprise Linux has identified.  They will be
      • the RAID-1 root partition (ext4, 893 GB),
      • the first EFI system partition (ESP) (nvme0n1p1, 512 MB), and
      • the second ESP (nvme1n1p1, 512 MB).
    4. Select the ext4 partition and reformat it as xfs, then set the mount point to "/" and label it as "md0"

    5. Click Update Settings.
  4. Create an EFI partition.
    1. Select the nvme0m1p1 partition and reformat is as an EFI System Partition, then set the mount point to "/boot/efi" and click Update Settings.

      At this point, the two partitions you configured will be under the New Red Hat Enterprise Linux Installation drop down menu, and the nvme1n1p1 EFI partition will still be in Unknown.  We can't create a second ESP because Red Hat Enterprise Linux won't allow you to create two partitions mounted on the same mount point, i.e. /boot/efi, even if they are on different disks. You can replicate the ESP after installing the "DGX System Management" yum group, which provides a tool to accomplish this.
    2. Click Done. A yellow-highlighted warning appears on the bottom of the screen.

    3. Click the yellow-highlighted warning message. The following message appears.

      The message appears because the DGX OS from the factory has created a RAID 1 array for the root partition, and has replicated the EFI system partitions.
    4. Close the warning and then press Done. A summary of the partitioning steps appears.

    5. Click Accept Changes to get back to the main Installation Summary Screen.

      There should no longer be a yellow warning icon on the System: Installation Destination option.

  5. Configure Ethernet.

    Select and enable the Ethernet device. This defaults to DHCP and can be changed for static IP configurations under Configure.

  6. From the INSTALLATION SUMMARY screen, click Begin installation to start the installation.

    1. While the installation process is running, set your password (ROOT PASSWORD) and create a new user (USER CREATION) from the Configuration screen.
    2. When the installation completes, click Reboot to reboot the system.
      Note: If you have installed Red Hat Enterprise Linux 7.5 and are using the BMC remote console, then follow the instructions provided in the release notes under Black screen on BMC Remote Console with Red Hat Enterprise Linux 7.5.
  7. Register the system with the Red Hat Enterprise Customer Portal to complete the initial setup.
    • If you installed with the Server with GUI base environment, the Initial Setup starts automatically where you can accept the license agreement and register the system. See the Red Hat instructions for details.
    • If you installed with any other base environment, log on to the system as root user and then register the system.
      subscription-manager register --auto-attach --username=user_name --password=password
    See How to register and subscribe a system to the Red Hat Customer Portal using Red Hat Subscription-Manager for further information.