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
- Run
sudo platformctl statuson the server. It shows which part is broken. - Broken passwords, certificates or sign-in? Go to Recover a broken install.
- 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 |