Find the fix for an error

This page helps you find the fix for an error you hit while installing or running Cairn. Most fixes run on the server with platformctl or kubectl.

Start here

  1. Run sudo platformctl status on the server. It shows which part is broken.
  2. Broken passwords, certificates or sign-in? Go to Recover a broken install.
  3. Otherwise, find the message you see below. Each page shows the symptom, the cause and the fix.

Not listed? Read the step logs in /var/log/platformctl/, or open an issue at https://github.com/Mpratyush54/SERVER-automation/issues.

Install

You see Fix
apt hangs at "Waiting for cache lock" apt lock
TLS handshake timeout when downloading charts or images DNS or IPv6 timeout
Names do not resolve inside the cluster DNS resolution
A *.sslip.io name does not resolve inside the cluster sslip.io inside the cluster
k3s does not start; port 6443, 80 or 443 is in use k3s port conflict
toomanyrequests when pulling images Docker Hub rate limit
Pods are evicted; the node reports DiskPressure=True Disk pressure
GitHub Releases answers 502 or 504 during the install GitHub Releases is down
ImagePullBackOff on the API or portal ImagePullBackOff
cannot re-use a name that is still in use Helm name in use
TypeScript errors while building the API TypeScript build errors

Ingress, HTTPS and sign-in

You see Fix
The Let's Encrypt certificate never becomes ready cert-manager timeout
The ingress controller refuses a second ingress for the same host Ingress ownership
Portainer shows "Administrator initialization timeout" Portainer setup token
Portainer sign-in fails with tls: failed to verify certificate Portainer OIDC certificate
Argo CD returns 404 at /argocd Argo CD returns 404
Argo CD sign-in shows Invalid redirect URL Argo CD sign-in redirect
Grafana redirects in a loop at /grafana Grafana redirect

Databases and storage

You see Fix
The object storage Helm chart fails with has no value MinIO template error
The object storage volume stays Pending MinIO volume not found
A validation error from the document database when the API starts MongoDB validation
WRONGPASS or a wrong password after rotating a database password Wrong password after rotate

API and portal

You see Fix
The install's seed step fails with Failed to obtain auth token for seeding API seed failure
An Angular template fails to compile because of an @ sign Angular @ in templates