Internet Computer wiki
From Internet Computer Wiki
Revision as of 23:40, 7 September 2022 by Katie.peters (talk | contribs) (Undo revision 3043 by Katie.peters (talk))
This Node deployment 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: support@internetcomputer.org
Many thanks for your efforts in building the Internet Computer.
Requirements
- A USB (3.0 speed that can hold at least 4GB) to put the image file on (A faster USB will allow the process to go much faster.)
- The Nitrokey HSM for your data center.
- A USB hub is helpful at some data centers, so you may wish to have one available.
- It is recommended that you have a plan for providing details if troubleshooting assistance is needed. We recommend that you track the serial number (on the pull-out tab) for each server and compare the screenshots in the directions with each step. If assistance is needed, you will need to provide:
- The serial number of the server in question
- Which step was last completed
- A screenshot or video showing any results that are different from what is expected.
- Verification of the HSM key and config.ini file that is being used.
I. Download installation image
- Download the IC-OS disk image here:
https://download.dfinity.systems/blessed/ic/f736069ae6a6e39a73f211c587705e0f8dfdfb06/setup-os/disk-img/disk-img.tar.gz - Download the corresponding checksum here:
https://download.dfinity.systems/blessed/ic/f736069ae6a6e39a73f211c587705e0f8dfdfb06/setup-os/disk-img/SHA256SUMS
II. Verify checksum and unarchive file
Mac OS X
- Open the Terminal and type:
shasum -a 256 ~/Downloads/disk-img.tar.gz
- Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please contact the Internet Computer Association.
- In the Terminal type:
tar xzvf ~/Downloads/disk-img.tar.gz
Linux / Ubuntu
- Open the Terminal and type:
sha256sum ~/Downloads/disk-img.tar.gz
- Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please contact the Internet Computer Association.
- In the Terminal type:
tar xzvf ~/Downloads/disk-img.tar.gz
Windows
- Open PowerShell and type:
Get-FileHash -Algorithm SHA256 .\Downloads\disk-img.tar.gz
- Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please contact the Internet Computer Association.
- In PowerShell type:
tar xzvf .\Downloads\disk-img.tar.gz
All Operating Systems
- Compare the calculated checksum with the one provided by the DFINITY foundation. Only continue if they are identical, otherwise please contact the DFINITY foundation.
III. Create Bootable IC-OS USB Stick
Mac OS X
- Open the Terminal and type:
diskutil list
- The diskutil command simply shows all available drives. Verify the drive that identifies your USB stick.
- In this next command, edit /dev/sda if needed so that it refers to 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>.img of=/dev/sda
Linux / Ubuntu
- Open the Terminal and type
blkid
- The blkid command simply shows all available drives. Verify the drive that identifies your USB stick.
- In this next command, edit /dev/sda if needed so that it refers to 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>.img of=/dev/sda
Windows
- Download Rufus Portable from: https://rufus.ie/en/
- Start Rufus
- Select the USB stick under Device and SELECT the previously downloaded IC-OS disk image and press START
- You may see some warnings. Make sure you don't have any other USBs in your computer and chose OK. Warning: You risk losing your own data if you specify a wrong drive.
- The Ready bar will go from left to right as it completes.
IV. Add configuration
Mac OS X
- Open Finder. You should now be able to see the CONFIG partition. If it's not visible, remove the USB and insert it again.
- Double-click to open it in TextEdit.
- Overwrite the example with your the IPv6 prefix, subnet and gateway of your data center.
- Once done, don’t forget to save the changes. If you need help, please do not hesitate to contact the Internet Computer Association.
Windows
- Open the Disk Management utility with a right click on the Start menu
- Right click the CONFIG partition
- Select Change drive letter or paths...
- Select any letter from the drop-down list
- Click OK.
- You should now be able to see the CONFIG partition in your Windows Explorer. Select the config.ini configuration file.
- Click on Edit to open it in a text-only editor. Do not use an editor that will add formatting, as this could cause the installation to fail.
- Overwrite the example with your own IPv6 prefix, subnet and gateway.
- Once done, don’t forget to save the changes. If you need help, please do not hesitate to contact the Internet Computer Association.
Linux
- Open the File Manager. You should now be able to see the CONFIG partition. If it's not visible, remove the USB and insert it again.
- Double-click to open it in KWrite.
- Overwrite the example with your own IPv6 prefix, subnet and gateway.
- Once done, don’t forget to save the changes. If you need help, please do not hesitate to contact the Internet Computer Association.
V. 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
VI. UEFI - Enter System Setup and reset IDRAC password
- 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.
- If your option is recognized by the system, it should be highlighting Entering System Setup.
- In the System Setup, select iDRAC Settings and press enter.
- Select User Configuration and press enter.
- Select Change Password and press enter.
- Enter in your desired password and select OK.
- Select Back and Finish.
VII. UEFI - System BIOS
VIII. UEFI - Boot Settings
IX. UEFI - Integrated Devices
X. UEFI - Miscellaneous Settings
-
- Confirm the exit and press enter. The system will reboot now. Please do not unplug the IC-OS USB stick at this point.