You are viewing documentation for a previous version of Platform9 products. For the latest Private Cloud Director documentation, click here.
Search
Managed Kubernetes
5.14
×
Overview
Getting Started
Clusters
PMK CLI
APIs
In Cluster Monitoring
Catapult Remote Monitoring
Platform9 Managed Add-ons
Platform Administration
Workloads & Apps
Support
Title
Message
Create new category
What is the title of your new category?
Edit page index title
What is the title of the page index?
Edit category
What is the new title of your category?
Edit link
What is the new title and URL of your link?
PMK Troubleshooting Guide
Summarize Page
Copy Markdown
Open in ChatGPT
Open in Claude
Issues by Component
Cluster
- 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 Cluster
| 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 |
| Cluster Creation using Public Cloud Provider (e.g. AWS) | Cluster creation fails, UI may show the failing step. | Troubleshooting Cluster Issues |
| Etcd Configuration |
| Troubleshooting Cluster Issues |
Nodes
- 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 |
| Node Preparation / Onboarding / Node Not Converged | Incompatible Package Version(s) | Troubleshooting Node Issues |
| Clock Skew |
| Troubleshooting Node Issues |
Pods
- 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 |
| Node Preparation / Onboarding / Node Not Converged | Error: CrashLoopBackOff | Troubleshooting Pod Issues |
Networking
- 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 |
| Calico CNI | Pod Networking broken / Kernel IP Forwarding not enabled on host | Troubleshooting Network Issues |
Applications
- 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 |
CLI
- ** CLI
- *: Troubleshooting steps for known issues of Command Line Interface clients.
| CLI | ||
|---|---|---|
| Component/Topic | Symptoms/Error Messages | Link to KB Article |
| Kubectl |
| Troubleshooting CLI Issues |
| Etcdctl |
| Troubleshooting CLI Issues |
AWS EC2 Clusters
- Troubleshooting guidance for known issue on clusters using AWS Cloud Provider:
| AWS | ||
|---|---|---|
| Component/Topic | Symptoms/Error Messages | Link to KB Article |
| Instance registration on Elastic Load Balancer | Elastic Load Balancer (ELB) Shows No Active Instances | AWS Troubleshooting |
| Node Preparation / Onboarding / Node Not Converged | NodePort Service Isn't Externally Reachable | AWS Troubleshooting |
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Last updated on Jun 6, 2024
Was this page helpful?
Discard Changes
Do you want to discard your current changes and overwrite with the template?
Archive Synced Block
Message
Create new Template
What is this template's title?
Delete Template
Message