Troubleshoot On-Premise Installation Failures

If your on-premise installation fails and you need Cisco support, perform the following procedures so we can diagnose the root cause:

• Obtain helmStderr output logs

• Create a support bundle

Collect Information for Cisco Support

Obtain helmStderr Output Logs

To obtain the helmStderr output for a failed deployment:

1. In the Admin Console Dashboard, click the following button to view deploy logs:
   

   A dialog opens with several logs.

2. Choose the helmStderr logs. It often includes information about why the deployment failed.
   

Create a Support Bundle

A support bundle contains details about the Provider Connectivity Assurance application that helps Cisco diagnose the reason for the deployment failure. Create a support bundle by following this guide: Support Bundles.

Tips for Self-Diagnosing Issues

To troubleshoot deployment issues on your own, you typically access Kubernetes resources by using the kubectl command. To access the cluster via kubectl, first use the Provider Connectivity Assurance CLI to set up your session using the shell command.

sudo ./provider-connectivity-assurance shell

After you run this command, you can run the kubectl command against your cluster.

The majority of the relevant resources reside in the pca namespace. Most troubleshooting efforts begin looking at pod statuses.

kubectl -n pca get pods

Pods in an erroneous state are often the areas that require attention. Get more information about pods by viewing pod events using the describe command or by viewing the pod logs.

For example, to view the pod description of the skylight-aaa pod:

kubectl -n pca describe pod -l app=skylight-aaa

And to view its logs:

kubectl -n pca logs -l app=skylight-aaa

To work around issues, you may need to edit a deployment, StatefulSet, ConfigMap, or other another Kubernetes resource. Do not make these changes without guidance from a Provider Connectivity Assurance support specialist. Another common troubleshooting step is to delete pods to recreate them with a fresh start.