# PMK Troubleshooting Guide

### Issues by Component <a href="#issues-by-component" id="issues-by-component"></a>

### Cluster <a href="#cluster" id="cluster"></a>

* **Cluster** A PMK cluster needs to be created by using onboarded (authorized) nodes. Refer the table below for issues related to a cluster: [Troubleshooting Cluster Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cluster-issues)

|                                                           | Cluster                                                                              |                                                                                                                                        |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Component/Topic**                                       | **Symptoms/Error Messages**                                                          | **Link to KB Article**                                                                                                                 |
| BareOS Cluster Creation                                   | Cluster creation fails, UI may show the failing step.                                | [Troubleshooting Cluster Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cluster-issues) |
| *Cluster Creation using Public Cloud Provider (e.g. AWS)* | Cluster creation fails, UI may show the failing step.                                | [Troubleshooting Cluster Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cluster-issues) |
| Etcd Configuration                                        | <ul><li>Heartbeat/Election Timeout Interval</li><li>Database Size Exceeded</li></ul> | [Troubleshooting Cluster Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cluster-issues) |

### Nodes <a href="#nodes" id="nodes"></a>

* **Nodes**: Linux servers are configured by PMK before they can be used to create a cluster. The configuration process includes installing PMK-specific packages and verifying other prerequisites.

|                                                      | Nodes                                                                                                                            |                                                                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Component/Topic**                                  | **Symptoms/Error Messages**                                                                                                      | **Link to KB Article**                                                                                                           |
| *VIP association on Master nodes*                    | VIP Not Routable from Other Masters (Misconfigured)                                                                              | [Troubleshooting Node Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-node-issues) |
| *Node Preparation / Onboarding / Node Not Converged* | Incompatible Package Version(s)                                                                                                  | [Troubleshooting Node Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-node-issues) |
| Clock Skew                                           | <ul><li>PF9 Host agent fails to generate certificates.</li><li>Error message in hostagent.log: “Unable to vouch URL …”</li></ul> | [Troubleshooting Node Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-node-issues) |

### Pods <a href="#pods" id="pods"></a>

* **Pods** While deploying workloads to Kubernetes (PMK), you may encounter issues around starting pods for deployments. If the dashboard (UI) reports unhealthy workload, refer the table below:

|                                                      | Pods                        |                                                                                                                                |
| ---------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Component/Topic**                                  | **Symptoms/Error Messages** | **Link to KB Article**                                                                                                         |
| *Pods / Deployments*                                 | Error: ImagePullBackOff     | [Troubleshooting Pod Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-pod-issues) |
| *Node Preparation / Onboarding / Node Not Converged* | Error: CrashLoopBackOff     | [Troubleshooting Pod Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-pod-issues) |

### Networking <a href="#networking" id="networking"></a>

* **Network**: Various issues seemingly related to Kubernetes workloads may be caused by underlying network issues. Refer the table below for known networking issues:

|                     | Network                                                          |                                                                                                                                        |
| ------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Component/Topic** | **Symptoms/Error Messages**                                      | **Link to KB Article**                                                                                                                 |
| *DNS*               | Errors due to domain name/host name resolution failure           | [Troubleshooting Network Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-network-issues) |
| *Calico CNI*        | Pod Networking broken / Kernel IP Forwarding not enabled on host | [Troubleshooting Network Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-network-issues) |

### Applications <a href="#applications" id="applications"></a>

* **Applications**: Applications can be deployed using the Apps Catalog tab of Apps Dashboard. Applications can only be deployed to clusters that have been registered with a repository. The table below outlines some common issues when deploying or managing apps.

|                     | Applications                            |                                                                                                                                                |
| ------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Component/Topic** | **Symptoms/Error Messages**             | **Link to KB Article**                                                                                                                         |
| *MetalLB*           | MetalLB is configured but doesn’t work. | [Troubleshooting Application Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-application-issues) |

### CLI <a href="#cli" id="cli"></a>

* **CLI**: Troubleshooting steps for known issues of Command Line Interface clients.

|                     | CLI                                                                          |                                                                                                                                |
| ------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Component/Topic** | **Symptoms/Error Messages**                                                  | **Link to KB Article**                                                                                                         |
| *Kubectl*           | <ul><li>API Server Unreachable</li><li>Invalid Token in Kubeconfig</li></ul> | [Troubleshooting CLI Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cli-issues) |
| *Etcdctl*           | <ul><li>Incorrect Endpoint(s)</li><li>Certificates Not Specified</li></ul>   | [Troubleshooting CLI Issues](https://docs.platform9.com/managed-kubernetes/support/troubleshooting/troubleshooting-cli-issues) |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform9.com/managed-kubernetes/support/troubleshooting/pmk-troubleshooting-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.