IC OS Installation Runbook - Supermicro
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 Setup
Reboot or power on the server. Watch for the screen with the Supermicro logo and boot options underneath it. Press DEL (delete) a couple of times, once the options are listed. If your option is recognized by the system, it should be saying: Entering Setup…
UEFI - Advanced Settings
Change to the Advanced menu Select Boot Feature and press enter Set Wait For "F1" If Error to Disabled ; press ESC (escape) to return to previous menu Select ACPI Settings and press enter Set PCI AER Support to Enabled ; set NUMA Nodes Per Socket to NPS0 ; press ESC (escape) to return to previous menu Select NB Configuration and press enter Set 4-link xGMI max speed to Auto ; press ESC (escape) to return to previous menu Select PCIe/PCI/PnP Configuration and press enter Set SR-IOV Support to Enabled ; set NVMe Firmware Source to AMI Native Support ; set M.2 (ACPI) Firmware Source to AMI Native Support ; press ESC (escape) to return to previous menu
UEFI - Boot Settings
Change to the Boot menu Set Boot Mode Select to UEFI Change to Save & Exit menu Select Save Changes and Reset and press enter Select Yes and press enter. The system will now reboot.
Booting the USB image
Watch for the screen with the Supermicro logo and boot options underneath it. Press F11 a couple of times, once the options are listed. In the Boot Menu, select the USB device and press enter 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.
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.
If your option is recognized by the system, it should be saying Invoking Boot Menu