Difference between revisions of "Node Deployment Guide"

From Internet Computer Wiki
Jump to: navigation, search
(Update verify node onboarding step)
m
Line 125: Line 125:
 
#:[[File:36-sm.png|580px|screenshot]]
 
#:[[File:36-sm.png|580px|screenshot]]
 
# If the installation finished successfully, it will initiate a reboot.  
 
# If the installation finished successfully, it will initiate a reboot.  
#:[[File:38-sm.png|580px|screenshot]]
+
#:[[File:38-sm.png|580px|screenshot]]<br />
 
 
 
 
 
== 8. First Boot ==
 
== 8. First Boot ==
 
Please remember to check the [[Possible Node Onboarding Errors]] page if you encounter any errors onboarding.
 
Please remember to check the [[Possible Node Onboarding Errors]] page if you encounter any errors onboarding.
Line 138: Line 136:
 
== 9. Verify node onboarding ==
 
== 9. Verify node onboarding ==
  
# Verify that your node was successfully onboarded by checking its status on the [https://dashboard.internetcomputer.org/ dashboard] is set to either “Awaiting Subnet” or “Active in Subnet”. The internal dashboard can be searched by your Node Provider principal. There, you should see the machine ID of your node.
+
# Verify that your node was successfully onboarded by checking its status on the [https://dashboard.internetcomputer.org/ dashboard] is set to either “Awaiting Subnet” or “Active in Subnet”. The internal dashboard can be searched by your Node Provider principal. There, you should see the machine ID of your node, outputed in step 8.
#* [[File:Dashboard-node-verification.png|thumb|998x998px]]
+
#*[[File:Dashboard-node-verification.png|thumb|998x998px]]
 
#:
 
#:

Revision as of 22:24, 23 June 2023

This runbook covers all steps necessary to install the Internet Computer Operating System (IC-OS) on Gen-2 hardware. Gen-1 hardware Node Providers should use the Gen-1 runbooks.

The physical machine is expected to be racked and stacked according to its respective manual.

In case you encounter any issues during the installation process, check the Possible Node Onboarding Errors page. Otherwise, post your issue in the Node Provider Matrix channel.

Many thanks for your efforts in building the Internet Computer.

Note: the following instructions are for onboarding nodes without using a NitroKey HSM. If you wish to follow the legacy procedure to onboard using a NitroKey HSM, follow the NitroKey HSM installation runbook.

Requirements

1. Download installation image

Follow the instructions on the IC-OS Download Page

2. Verify checksum and unarchive file

Mac OS X

  1. Open the Terminal and type:
    shasum -a 256 ~/Downloads/disk-img.tar.gz
    
  2. Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please post your issue in the Node Provider Matrix channel.
    Open the Terminal and type:
    tar xzvf ~/Downloads/disk-img.tar.gz
    

Linux / Ubuntu

  1. Open the Terminal and type:
    sha256sum ~/Downloads/disk-img.tar.gz
    
  2. Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please post your issue in the Node Provider Matrix channel.
    Open the Terminal and type:
    tar xzvf ~/Downloads/disk-img.tar.gz
    

Windows

  1. Open PowerShell and type:
    Get-FileHash -Algorithm SHA256 .\Downloads\disk-img.tar.gz
    
  2. Compare the calculated checksum with the file downloaded in the previous step. Warning: Only continue if they are identical, otherwise please post your issue in the Node Provider Matrix channel.
    Open PowerShell and type:
    tar xzvf .\Downloads\disk-img.tar.gz
    

3. Create Bootable USB Stick

Mac OS X

  1. Open the Terminal and type:
    diskutil list
    
  2. All available drives should be shown. Identify which device corresponds to your USB stick. You may need to unmount the USB drive:
    sudo diskutil unmount /dev/YOUR_USB_DEVICE_MOUNTED_PARTITION # E.g. /dev/disk4s1
    
  3. The file path is an example. Use the absolute path to the downloaded image. Warning: You risk losing your own data if you specify a wrong device.
    sudo dd if=/Users/YOUR_USER_NAME/Downloads/disk.img of=/dev/YOUR_USB_DEVICE bs=1M
    

Linux / Ubuntu

  1. Open the Terminal and type
    blkid
    
  2. All available drives should be shown. Identify which device corresponds to your USB stick. You may need to unmount the USB drive:
    sudo diskutil unmount /dev/YOUR_USB_DEVICE_MOUNTED_PARTITION # E.g. /dev/sdb1
    
  3. Replace /dev/YOUR_USB_DEVICE with the device that corresponds to your USB stick. Warning: You risk losing your own data if you specify a wrong drive.
    sudo dd if=~/Downloads/disk.img of=/dev/YOUR_USB_DEVICE bs=1M
    

Windows

  1. Download and install Rufus Portable
  2. Start Rufus
  3. Select the USB stick under device and select the previously downloaded IC-OS disk image and press start
    screenshot
  4. You may see some warnings. Make sure you don't have any other USBs in your computer and chose OK
    screenshot
    screenshot
  5. The "Ready" bar will go from left to right as it completes.

4. Add configuration

Mac OS X

  1. Open Finder. You should now be able to see the CONFIG partition. If it's not visible, remove the USB and insert it again.
    screenshot
  2. Double-click to open it in TextEdit.
  3. Insert your IPv6 prefix, subnet and gateway.
    screenshot
  4. Once done, don’t forget to save the changes. If you need help, please do not hesitate to post your issue in the Node Provider Matrix channel.
    screenshot
  5. Copy node_operator_private_key.pem from Node Provider Onboarding step 5. Setup the Node Operator keys to the CONFIG partition. This file should have the name node_operator_private_key.pem, and sit next to config.ini, NOT inside the ssh_authorized_keys folder.

Windows

  1. Open the Disk Management utility with a right click on the Start menu
    screenshot#:
  2. Right click the CONFIG partition
  3. Select Change drive letter or paths...
    screenshot
  4. Select any letter from the drop-down list
    screenshot
  5. Click OK.
  6. You should now be able to see the CONFIG partition in your Windows Explorer. Select the config.ini configuration file
    screenshot
  7. Click on Edit to open it.
  8. Insert your IPv6 prefix, subnet and gateway.
    screenshot
  9. Once done, don’t forget to save the changes. If you need help, please do not hesitate to post your issue in the Node Provider Matrix channel.
    screenshot
  10. Copy node_operator_private_key.pem from Node Provider Onboarding step 5. Setup the Node Operator keys to the CONFIG partition. This file should have the name node_operator_private_key.pem, and sit next to config.ini, NOT inside the ssh_authorized_keys folder.

Linux

  1. 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.
    screenshot
  2. Double-click to open it in KWrite.
  3. Insert your IPv6 prefix, subnet and gateway.
    screenshot
  4. Once done, don’t forget to save the changes. If you need help, please do not hesitate to post your issue in the Node Provider Matrix channel.
    screenshot
  5. Copy node_operator_private_key.pem from Node Provider Onboarding step 5. Setup the Node Operator keys to the CONFIG partition. This file should have the name node_operator_private_key.pem, and sit next to config.ini, NOT inside the ssh_authorized_keys folder.

5. Connect Crash Cart

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

6. UEFI Setup and Boot Menu

Use the related page below to set up the BIOS/UEFI according to your hardware vendor.

Resume from this point when you are finished.

7. IC-OS Installation

  1. Please wait while the USB Installer is booting up. This process can take up to 3 minutes.
    screenshot
  2. The IC-OS installation starts. Please keep an eye on the progress. This part can take up to 10 minutes. Please remember to check the Possible Node Onboarding Errors page if you encounter any errors.
    screenshot
  3. If the installation finished successfully, it will initiate a reboot.
    screenshot

8. First Boot

Please remember to check the Possible Node Onboarding Errors page if you encounter any errors onboarding. Do NOT re-try the onboarding after proceeding to this section, as this can cause duplication within the registry.

  1. Once you see this message, you may unplug the USB stick and VGA/Video. You can ignore the message to remove the HSM, as you did not use an HSM to onboard your nodes.
    screenshot

Congratulations! Your machine successfully joined the Internet Computer! Again, once you see this message, do NOT re-try the onboarding after proceeding to this section, as this can cause duplication within the registry. The machine has joined the IC and the Node Provider will start receiving rewards!

9. Verify node onboarding

  1. Verify that your node was successfully onboarded by checking its status on the dashboard is set to either “Awaiting Subnet” or “Active in Subnet”. The internal dashboard can be searched by your Node Provider principal. There, you should see the machine ID of your node, outputed in step 8.
    • Dashboard-node-verification.png