Automation Suite on Linux installation guide

Last updated Mar 16, 2026

How to troubleshoot services during installation

Take the following steps on one of the cluster server nodes:

Obtain Kubernetes access.
```
on server nodes:
export KUBECONFIG="/etc/rancher/rke2/rke2.yaml"
export PATH="$PATH:/usr/local/bin:/var/lib/rancher/rke2/bin"

on agent nodes:
export KUBECONFIG="/var/lib/rancher/rke2/agent/kubelet.kubeconfig"
export PATH="$PATH:/usr/local/bin:/var/lib/rancher/rke2/bin"

# To validate, execute the following command which should not return an error:
kubectl get nodes
on server nodes:
export KUBECONFIG="/etc/rancher/rke2/rke2.yaml"
export PATH="$PATH:/usr/local/bin:/var/lib/rancher/rke2/bin"

on agent nodes:
export KUBECONFIG="/var/lib/rancher/rke2/agent/kubelet.kubeconfig"
export PATH="$PATH:/usr/local/bin:/var/lib/rancher/rke2/bin"

# To validate, execute the following command which should not return an error:
kubectl get nodes
```

Retrieve the ArgoCD password by running the following command:

kubectl get secrets/argocd-initial-admin-secret -n argocd --template '{{ .data.password }}' | base64 -d
kubectl get secrets/argocd-initial-admin-secret -n argocd --template '{{ .data.password }}' | base64 -d

Connect to ArgoCD.
Navigate to https://alm.<fqdn>.
Login using admin as the username and the password obtained at Step 2.
Locate the applications that are having issue by filtering the applications that are Missing/Degraded/Progressing.
Then open the application having an issue by selecting its card.
Locate any un-synced components by looking for the red broken heart icon, as shown in the following image.
Open the right-most component (usually pods) and select the Logs tab. The Logs will contain an error message indicating the reason for the pod failure.
Once you resolve any outstanding configuration issues, go back to the application home page and select the Sync button to sync the application.

Note:

If you receive the error message "Unable to sync: another operation is already in progress" select the syncing process, and then select Terminate to cancel the current synchronization. After the current sync is terminated, repeat the synchronization procedure as described in the previous steps.

Was this page helpful?

PREVIOUSHow to

NEXTHow to reduce permissions for an NFS backup directory