IC OS Installation Runbook - Dell Poweredge

From Internet Computer Wiki
Jump to: navigation, search

This runbook covers all steps necessary to install the Internet Computer Operating System (hereinafter called IC-OS). The physical machine is expected to be racked and stacked according to the respective manual. In case you encounter any issues during the installation process, we kindly ask you to send an email with the error message to: [email protected]

Many thanks for your efforts in building the Internet Computer.

Download installation image

Download the IC-OS ISO image here:
https://download.dfinity.systems/blessed/ic/dcb2d23dfcd9de200f235110e618713cc884cb19/setup-os/setup-os.iso

Download the corresponding checksum here:
https://download.dfinity.systems/blessed/ic/dcb2d23dfcd9de200f235110e618713cc884cb19/setup-os/SHA256SUMS

Calculate and check checksum

Mac OS X

Open the Terminal and type:

shasum -a 256 ~/Downloads/setup-os_<version>.iso

Linux / Ubuntu

Open the Terminal and type:

sha256sum ~/Downloads/setup-os_<version>.iso

Windows

Open PowerShell and type:

Get-FileHash -Algorithm SHA256 .\Downloads\setup-os_<version>.iso

Compare the calculated checksum with the one provided by the DFINITY foundation. Only continue if they are identical, otherwise please contact the DFINITY foundation.

Create Bootable USB Stick

Mac OS X

Open the Terminal and type:

diskutil list
  • The diskutil command simply shows all available drives. Please make sure /dev/sda is your USB stick and not any other drive. Warning: You risk losing your own data if you specify a wrong drive.
dd if=~/Downloads/setup-os_<version>.iso of=/dev/sda

Linux / Ubuntu

Open the Terminal and type

blkid

The blkid command simply shows all available drives. Please make sure /dev/sda is your USB stick and not any other drive. Warning: You risk losing your own data if you specify a wrong drive.

dd if=~/Downloads/setup-os_<version>.iso of=/dev/sda

Windows

Download Rufus Portable from: https://rufus.ie/en/ Start Rufus ; select the USB stick under device ; select the previously downloaded IC-OS disk image and press start ; choose the DD Image mode and press OK ; confirm the operation by pressing OK

Connect Crash Cart

In order to configure the UEFI and initiate the installation of the IC-OS, please connect a crash cart to the physical machine. Plug-in the VGA/Video, keyboard and IC-OS USB stick

UEFI - Enter System Setup

Reboot or power on the server. Watch for the Blue screen with boot options in the top left corner. Press F2 a couple of times, once the options are listed. f your option is recognized by the system, it should be highlighting Entering System Setup.

UEFI - System BIOS

In the System Setup, select System BIOS and press enter. In the System BIOS, select Processor Settings and press enter. Set NUMA Nodes Per Socket to 0 ; set Minimum SEV non-ES ASID to 253 ; select back to return to System BIOS.

UEFI - Boot Settings

Select Boot Settings and press enter. Set Boot Mode to UEFI ; select back to return to System BIOS.

UEFI - Integrated Devices

Select Integrated Devices and press enter. Set Pcie Preferred IO Bus to Enabled ; set Enhanced Preferred IO to Enabled ; SR-IOV Global Enable to Enabled ; select back to return to System BIOS.

UEFI - Miscellaneous Settings

Select Miscellaneous Settings and press enter. Set F1/F2 Prompt on Error to Disabled ; select back to return to System BIOS. Select Finish and press enter. Select Yes to save the changes and press enter. Select OK and press enter. Confirm the exit and press enter. The system will reboot now.

Boot Manager - Enter Boot Manager

Watch for the Blue screen with boot options in the top left corner. Press F11 a couple of times, once the options are listed. If your option is recognized by the system, it should be highlighting Entering Boot Manager. In the Boot Manager, select One-shot UEFI Boot Menu and press enter. In the Boot Menu, select your USB device and press enter.

IC-OS - Installer Boot

Please wait while the USB Installer is booting up. This process can take up to 3 minutes. The IC-OS installation starts. Please keep an eye on the progress. This part can take up to 8 minutes. If you encounter any issues, please send an email with the error message to: [email protected] Once you get asked to insert the HSM, please remove the keyboard and instead insert the HSM USB device. If the installation finished successfully, it will initiate a reboot. Please do not unplug the USB stick or HSM USB device at this point.

IC-OS - First Boot

The first boot of the IC-OS still requires the HSM USB device. Please wait until further instructions. This step can take up to 2 minutes. Once you see this message, you may unplug the HSM USB device, USB stick and VGA/Video. Your machine successfully joined the Internet Computer.