Setup issues

Content Intelligence Installation and Deployment Guide
Version
3.0.x
File Size
660 KB
Audience
anonymous
Part Number
MK-HCI009-01
ft:lastEdition
2025-04-09

The Ansible summary is unclear.

Scroll up through the log and search for the term "Fatal". This will point to line providing the exact error that has occurred.

Setup of the private registry has failed.

  1. Search through the Ansible logs for the fatal error.
  2. The private registry step was executed before the hostnames were assigned and the secondary nodes were created.
    • Wait several minutes and attempt to rerun the step again.
    • Ensure that you are able to ping the secondary control plane's IP and hostname.
  3. Delete the private registry and existing images from each node.
    1. Stop the private registry: podman stop registry
    2. Delete all images from local: podman rmi --all
    3. Run the Install Private registries menu option again.

RKE2 setup has failed.

  1. Search through the Ansible logs for the fatal error.
  2. Possible network issues. Ensure you are able to SSH into the backend IPs and hostnames of the system nodes.
  3. Possible connectivity issues with the private registry. Run the following command on all 3 private registries to check the connection:

    curl -k https://<hostname>:15123/v2/_catalog

  4. If all 3 registries are unreachable, delete the private registry and existing images from each node.
    1. Stop the private registry: podman stop registry
    2. Delete all images from local: podman rmi --all
    3. Run the Deploy Private Registry step again.
  5. Uninstall RKE2 Rancher.
    1. Navigate to /usr/local/bin.
    2. Run the rke2-uninstall.sh script on all nodes.
    3. Run the Install 3rd Party (RKE2 and Rancher) on all nodes menu option again from the main menu.
Setup of the product has failed.
  1. Search through the Ansible logs for the fatal error.
  2. Rerun the Install Kubernetes and HCI menu option again from the main menu.
  3. Delete HCI:

    kubectl delete -ns hci

  4. If the above command is stuck, run the following command:

    NS=`kubectl get ns |grep Terminating | awk 'NR==1 {print $1}'` && kubectl get namespace "$NS" -o json | tr -d "\n" | sed "s/\"finalizers\": \[[^]]\+\]/\"finalizers\": []/" | kubectl replace --raw /api/v1/namespaces/$NS/finalize -f -

  5. After deleting HCI, rerun the Install Kubernetes and HCI menu option again from the main menu.