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:
Meeting hardware requirements¶
- Check that your hardware meets the minimum requirements to complete installation.
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.logis helpful too.
Modifying cluster token on agent nodes¶
When an agent node fails to join the cluster, it can be related to the cluster token not being identical to the server node token.
In order to confirm the issue, connect to your agent node (i.e. with SSH) and check the
rancherd service log with the following command:
$ sudo journalctl -b -u rancherd
If the cluster token setup in the agent node is not matching the server node token, you will find several entries of the following message:
... msg="Bootstrapping Rancher (master-head/v1.21.5+rke2r1)" msg="failed to bootstrap system, will retry: generating plan: insecure cacerts download from https://192.168.122.115:8443/cacerts: Get \"https://192.168.122.115:8443/cacerts\": EOF" ...
To fix the issue, you need to update the token value in the
rancherd configuration file
For example, if the cluster token setup in the server node is
ThisIsTheCorrectOne, you will update the token value as follow:
... token: 'ThisIsTheCorrectOne' ...
To ensure the change is persistent across reboots, update the
token value of the OS configuration file
name: Harvester Configuration stages: ... initramfs: - commands: - rm -f /etc/sysconfig/network/ifroute-harvester-mgmt files: - path: /etc/rancher/rancherd/config.yaml permissions: 384 owner: 0 group: 0 content: | role: cluster-init token: 'ThisIsTheCorrectOne' # <- Update this value kubernetesVersion: v1.21.5+rke2r1 labels: - harvesterhci.io/managed=true encoding: "" ownerstring: ""
To see what is the current cluster token value, log in your server node (i.e. with SSH)
and look in the file
/etc/rancher/rancherd/config.yaml. For example,
you can run the following command to only display the token's value:
$ sudo yq eval .token /etc/rancher/rancherd/config.yaml
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: