Troubleshooting¶
Security risk error¶
Alan AI Studio currently uses self-signed certificates that are available in the cfg/ans-development/certs
folder of the installation package. Browsers may warn against using self-signed certificates.
To avoid it, add an exception in Chrome:
In the top-right corner of the Chrome window, click three dots and select Settings.
Scroll down and click Advanced to expand the advanced settings.
Under the Privacy and Security section, click Manage Certificates.
In the Certificates window, go to the Authorities tab.
Click Import and select the self-signed certificate file in the installation package.
Alan AI Cloud deployment works incorrectly¶
You may experience the following symptoms:
Unable to access Alan Studio through a web browser
Internal errors or general errors are displayed as toaster notifications in the top right corner of Alan AI Studio
The Alan AI button is unable to connect (the loader on the AI agent button keeps spinning indefinitely)
The
Disconnected
banner appearing in Alan AI StudioInfinite loading animation in Alan Studio Debug Chat (disconnected or model is updating)
Steps to troubleshoot:
In the Terminal, run:
kubectl get pods
Check the output to ensure all pods are in the
1/1 Running
state.All pods, except for
alan-dialog
pods, should be singular:If any other pod is duplicated, delete the oldest duplicate using the following command:
kubectl delete pod {pod_name}
Check the pods status using the following command:
kubectl get pods
If the pod deleted at the previous step reappears and duplicates again, run the following commands in sequence:
./scripts/local-helm-uninstall.sh ./scripts/local-delete-alan-pods.sh ./scripts/local-helm-install.sh
All the data like projects, statistics and project settings are stored in persistent volumes and will remain unaffected by the reinstallation.
If the number of pods is correct but some aren’t in the
1/1 Running
state, use the following command to check the pod logs:kubectl describe pod {pod_name}
Common issues found in the logs may include:
Unbound Persistent Volume claim: indicates Kubernetes and Docker can’t allocate requested resources, possibly due to Docker errors or misconfigurations.
Unsupported architecture manifest
Recommended configuration for Docker:
CPU limit: > 4
Memory limit: > 12 GB
Swap: > 2 GB
Virtual disk limit: > 100 GB
Try restarting Docker. If this doesn’t help, restart your workstation to free up the necessary resources needed for local deployment.
If the deployment still doesn’t work after a restart, reinstall it by running the following commands in sequence:
./scripts/local-helm-uninstall.sh ./scripts/local-delete-alan-pods.sh ./scripts/local-helm-install.sh