Skip to content

Installation

The following sections contain tips to troubleshoot or get assistance with failed installations.

Logging into the Harvester Installer (a live OS)

Users can press the key combination CTRL + ALT + F2 to switch to another TTY and log in with the following credentials:

  • User: rancher
  • Password: rancher

Meeting hardware requirements

Receiving the message "Loading images. This may take a few minutes..."

  • Because the system doesn't have a default route, your installer may become "stuck" in this state. You can check your route status by executing the following command:
$ ip route
default via 10.10.0.10 dev harvester-mgmt proto dhcp        <-- Does a default route exist?
10.10.0.0/24 dev harvester-mgmt proto kernel scope link src 10.10.0.15
  • Check that your DHCP server offers a default route option. Attaching content from /run/cos/target/rke2.log is helpful too.

Collecting information

Please include the following information in a bug report when reporting a failed installation:

  • A failed installation screenshot.
  • Content of these files:

    /var/log/console.log
    /run/cos/target/rke2.log
    /tmp/harvester.*
    /tmp/cos.*
    
  • Output of these commands:

    blkid
    dmesg