# 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) |