#420 canonical links for Troubleshooting (#835)

* canonicized troubleshooting/kubernetes-components

* canonicized troubleshooting/other-troubleshooting-tips

* canonicized troubleshooting

* files for 2.0-2.4, and 2.5
This commit is contained in:
Marty Hernandez Avedon
2023-09-08 15:35:01 -04:00
committed by GitHub
parent d5e9e0d111
commit a2952cd469
62 changed files with 248 additions and 0 deletions
@@ -2,6 +2,10 @@
title: General Troubleshooting title: General Troubleshooting
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/general-troubleshooting"/>
</head>
This section contains information to help you troubleshoot issues when using Rancher. This section contains information to help you troubleshoot issues when using Rancher.
- [Kubernetes components](../pages-for-subheaders/kubernetes-components.md) - [Kubernetes components](../pages-for-subheaders/kubernetes-components.md)
@@ -2,6 +2,10 @@
title: Troubleshooting Controlplane Nodes title: Troubleshooting Controlplane Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-controlplane-nodes"/>
</head>
This section applies to nodes with the `controlplane` role. This section applies to nodes with the `controlplane` role.
## Check if the Controlplane Containers are Running ## Check if the Controlplane Containers are Running
@@ -2,6 +2,10 @@
title: Troubleshooting etcd Nodes title: Troubleshooting etcd Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-etcd-nodes"/>
</head>
This section contains commands and tips for troubleshooting nodes with the `etcd` role. This section contains commands and tips for troubleshooting nodes with the `etcd` role.
@@ -2,6 +2,10 @@
title: Troubleshooting nginx-proxy title: Troubleshooting nginx-proxy
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-nginx-proxy"/>
</head>
The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role. The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role.
## Check if the Container is Running ## Check if the Container is Running
@@ -2,6 +2,10 @@
title: Troubleshooting Worker Nodes and Generic Components title: Troubleshooting Worker Nodes and Generic Components
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-worker-nodes-and-generic-components"/>
</head>
This section applies to every node as it includes components that run on nodes with any role. This section applies to every node as it includes components that run on nodes with any role.
## Check if the Containers are Running ## Check if the Containers are Running
@@ -2,6 +2,10 @@
title: DNS title: DNS
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/dns"/>
</head>
The commands/steps listed on this page can be used to check name resolution issues in your cluster. The commands/steps listed on this page can be used to check name resolution issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rotation of Expired Webhook Certificates title: Rotation of Expired Webhook Certificates
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/expired-webhook-certificate-rotation"/>
</head>
For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew. For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew.
In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue: In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue:
@@ -2,6 +2,10 @@
title: Kubernetes Resources title: Kubernetes Resources
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/kubernetes-resources"/>
</head>
The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters. The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Logging title: Logging
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/logging"/>
</head>
## Log levels ## Log levels
The following log levels are used in Rancher: The following log levels are used in Rancher:
@@ -2,6 +2,10 @@
title: Networking title: Networking
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/networking"/>
</head>
The commands/steps listed on this page can be used to check networking related issues in your cluster. The commands/steps listed on this page can be used to check networking related issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rancher HA title: Rancher HA
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/rancher-ha"/>
</head>
The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation. The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`). Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`).
@@ -2,6 +2,10 @@
title: Registered Clusters title: Registered Clusters
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/registered-clusters"/>
</head>
The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher. The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`) Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`)
@@ -2,6 +2,10 @@
title: User ID Tracking in Audit Logs title: User ID Tracking in Audit Logs
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/user-id-tracking-in-audit-logs"/>
</head>
The following audit logs are used in Rancher to track events occuring on the local and downstream clusters: The following audit logs are used in Rancher to track events occuring on the local and downstream clusters:
* [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/) * [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/)
@@ -2,6 +2,10 @@
title: Troubleshooting title: Troubleshooting
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/general-troubleshooting"/>
</head>
This section contains information to help you troubleshoot issues when using Rancher. This section contains information to help you troubleshoot issues when using Rancher.
- [Kubernetes components](pages-for-subheaders/kubernetes-components.md) - [Kubernetes components](pages-for-subheaders/kubernetes-components.md)
@@ -2,6 +2,10 @@
title: Troubleshooting Controlplane Nodes title: Troubleshooting Controlplane Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-controlplane-nodes"/>
</head>
This section applies to nodes with the `controlplane` role. This section applies to nodes with the `controlplane` role.
## Check if the Controlplane Containers are Running ## Check if the Controlplane Containers are Running
@@ -2,6 +2,10 @@
title: Troubleshooting etcd Nodes title: Troubleshooting etcd Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-etcd-nodes"/>
</head>
This section contains commands and tips for troubleshooting nodes with the `etcd` role. This section contains commands and tips for troubleshooting nodes with the `etcd` role.
@@ -2,6 +2,10 @@
title: Troubleshooting nginx-proxy title: Troubleshooting nginx-proxy
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-nginx-proxy"/>
</head>
The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role. The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role.
## Check if the Container is Running ## Check if the Container is Running
@@ -2,6 +2,10 @@
title: Troubleshooting Worker Nodes and Generic Components title: Troubleshooting Worker Nodes and Generic Components
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-worker-nodes-and-generic-components"/>
</head>
This section applies to every node as it includes components that run on nodes with any role. This section applies to every node as it includes components that run on nodes with any role.
## Check if the Containers are Running ## Check if the Containers are Running
@@ -2,6 +2,10 @@
title: DNS title: DNS
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/dns"/>
</head>
The commands/steps listed on this page can be used to check name resolution issues in your cluster. The commands/steps listed on this page can be used to check name resolution issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Kubernetes resources title: Kubernetes resources
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/kubernetes-resources"/>
</head>
The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters. The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Logging title: Logging
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/logging"/>
</head>
The following log levels are used in Rancher: The following log levels are used in Rancher:
| Name | Description | | Name | Description |
@@ -2,6 +2,10 @@
title: Networking title: Networking
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/networking"/>
</head>
The commands/steps listed on this page can be used to check networking related issues in your cluster. The commands/steps listed on this page can be used to check networking related issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rancher HA title: Rancher HA
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/rancher-ha"/>
</head>
The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation. The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml`). Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_rancher-cluster.yml`).
@@ -2,6 +2,10 @@
title: Imported clusters title: Imported clusters
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/registered-clusters"/>
</head>
The commands/steps listed on this page can be used to check clusters that you are importing or that are imported in Rancher. The commands/steps listed on this page can be used to check clusters that you are importing or that are imported in Rancher.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`) Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`)
@@ -2,6 +2,10 @@
title: Troubleshooting title: Troubleshooting
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/general-troubleshooting"/>
</head>
This section contains information to help you troubleshoot issues when using Rancher. This section contains information to help you troubleshoot issues when using Rancher.
- [Kubernetes components](pages-for-subheaders/kubernetes-components.md) - [Kubernetes components](pages-for-subheaders/kubernetes-components.md)
@@ -2,6 +2,10 @@
title: Troubleshooting Controlplane Nodes title: Troubleshooting Controlplane Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-controlplane-nodes"/>
</head>
This section applies to nodes with the `controlplane` role. This section applies to nodes with the `controlplane` role.
## Check if the Controlplane Containers are Running ## Check if the Controlplane Containers are Running
@@ -2,6 +2,10 @@
title: Troubleshooting etcd Nodes title: Troubleshooting etcd Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-etcd-nodes"/>
</head>
This section contains commands and tips for troubleshooting nodes with the `etcd` role. This section contains commands and tips for troubleshooting nodes with the `etcd` role.
@@ -2,6 +2,10 @@
title: Troubleshooting nginx-proxy title: Troubleshooting nginx-proxy
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-nginx-proxy"/>
</head>
The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role. The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role.
## Check if the Container is Running ## Check if the Container is Running
@@ -2,6 +2,10 @@
title: Troubleshooting Worker Nodes and Generic Components title: Troubleshooting Worker Nodes and Generic Components
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-worker-nodes-and-generic-components"/>
</head>
This section applies to every node as it includes components that run on nodes with any role. This section applies to every node as it includes components that run on nodes with any role.
## Check if the Containers are Running ## Check if the Containers are Running
@@ -2,6 +2,10 @@
title: DNS title: DNS
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/dns"/>
</head>
The commands/steps listed on this page can be used to check name resolution issues in your cluster. The commands/steps listed on this page can be used to check name resolution issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rotation of Expired Webhook Certificates title: Rotation of Expired Webhook Certificates
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/expired-webhook-certificate-rotation"/>
</head>
For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew. For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew.
In Rancher v2.5.12 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.5.11 or below, there are two methods to work around this issue: In Rancher v2.5.12 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.5.11 or below, there are two methods to work around this issue:
@@ -2,6 +2,10 @@
title: Kubernetes resources title: Kubernetes resources
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/kubernetes-resources"/>
</head>
The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters. The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Logging title: Logging
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/logging"/>
</head>
The following log levels are used in Rancher: The following log levels are used in Rancher:
| Name | Description | | Name | Description |
@@ -2,6 +2,10 @@
title: Networking title: Networking
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/networking"/>
</head>
The commands/steps listed on this page can be used to check networking related issues in your cluster. The commands/steps listed on this page can be used to check networking related issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rancher HA title: Rancher HA
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/rancher-ha"/>
</head>
The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation. The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`). Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`).
@@ -2,6 +2,10 @@
title: Registered clusters title: Registered clusters
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/registered-clusters"/>
</head>
The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher. The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`) Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`)
@@ -2,6 +2,10 @@
title: General Troubleshooting title: General Troubleshooting
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/general-troubleshooting"/>
</head>
This section contains information to help you troubleshoot issues when using Rancher. This section contains information to help you troubleshoot issues when using Rancher.
- [Kubernetes components](../pages-for-subheaders/kubernetes-components.md) - [Kubernetes components](../pages-for-subheaders/kubernetes-components.md)
@@ -2,6 +2,10 @@
title: Troubleshooting Controlplane Nodes title: Troubleshooting Controlplane Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-controlplane-nodes"/>
</head>
This section applies to nodes with the `controlplane` role. This section applies to nodes with the `controlplane` role.
## Check if the Controlplane Containers are Running ## Check if the Controlplane Containers are Running
@@ -2,6 +2,10 @@
title: Troubleshooting etcd Nodes title: Troubleshooting etcd Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-etcd-nodes"/>
</head>
This section contains commands and tips for troubleshooting nodes with the `etcd` role. This section contains commands and tips for troubleshooting nodes with the `etcd` role.
@@ -2,6 +2,10 @@
title: Troubleshooting nginx-proxy title: Troubleshooting nginx-proxy
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-nginx-proxy"/>
</head>
The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role. The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role.
## Check if the Container is Running ## Check if the Container is Running
@@ -2,6 +2,10 @@
title: Troubleshooting Worker Nodes and Generic Components title: Troubleshooting Worker Nodes and Generic Components
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-worker-nodes-and-generic-components"/>
</head>
This section applies to every node as it includes components that run on nodes with any role. This section applies to every node as it includes components that run on nodes with any role.
## Check if the Containers are Running ## Check if the Containers are Running
@@ -2,6 +2,10 @@
title: DNS title: DNS
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/dns"/>
</head>
The commands/steps listed on this page can be used to check name resolution issues in your cluster. The commands/steps listed on this page can be used to check name resolution issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rotation of Expired Webhook Certificates title: Rotation of Expired Webhook Certificates
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/expired-webhook-certificate-rotation"/>
</head>
For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew. For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew.
In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue: In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue:
@@ -2,6 +2,10 @@
title: Kubernetes Resources title: Kubernetes Resources
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/kubernetes-resources"/>
</head>
The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters. The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Logging title: Logging
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/logging"/>
</head>
## Log levels ## Log levels
The following log levels are used in Rancher: The following log levels are used in Rancher:
@@ -2,6 +2,10 @@
title: Networking title: Networking
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/networking"/>
</head>
The commands/steps listed on this page can be used to check networking related issues in your cluster. The commands/steps listed on this page can be used to check networking related issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rancher HA title: Rancher HA
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/rancher-ha"/>
</head>
The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation. The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`). Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`).
@@ -2,6 +2,10 @@
title: Registered Clusters title: Registered Clusters
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/registered-clusters"/>
</head>
The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher. The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`) Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`)
@@ -2,6 +2,10 @@
title: User ID Tracking in Audit Logs title: User ID Tracking in Audit Logs
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/user-id-tracking-in-audit-logs"/>
</head>
The following audit logs are used in Rancher to track events occuring on the local and downstream clusters: The following audit logs are used in Rancher to track events occuring on the local and downstream clusters:
* [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/) * [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/)
@@ -2,6 +2,10 @@
title: General Troubleshooting title: General Troubleshooting
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/general-troubleshooting"/>
</head>
This section contains information to help you troubleshoot issues when using Rancher. This section contains information to help you troubleshoot issues when using Rancher.
- [Kubernetes components](../pages-for-subheaders/kubernetes-components.md) - [Kubernetes components](../pages-for-subheaders/kubernetes-components.md)
@@ -2,6 +2,10 @@
title: Troubleshooting Controlplane Nodes title: Troubleshooting Controlplane Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-controlplane-nodes"/>
</head>
This section applies to nodes with the `controlplane` role. This section applies to nodes with the `controlplane` role.
## Check if the Controlplane Containers are Running ## Check if the Controlplane Containers are Running
@@ -2,6 +2,10 @@
title: Troubleshooting etcd Nodes title: Troubleshooting etcd Nodes
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-etcd-nodes"/>
</head>
This section contains commands and tips for troubleshooting nodes with the `etcd` role. This section contains commands and tips for troubleshooting nodes with the `etcd` role.
@@ -2,6 +2,10 @@
title: Troubleshooting nginx-proxy title: Troubleshooting nginx-proxy
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-nginx-proxy"/>
</head>
The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role. The `nginx-proxy` container is deployed on every node that does not have the `controlplane` role. It provides access to all the nodes with the `controlplane` role by dynamically generating the NGINX configuration based on available nodes with the `controlplane` role.
## Check if the Container is Running ## Check if the Container is Running
@@ -2,6 +2,10 @@
title: Troubleshooting Worker Nodes and Generic Components title: Troubleshooting Worker Nodes and Generic Components
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/kubernetes-components/troubleshooting-worker-nodes-and-generic-components"/>
</head>
This section applies to every node as it includes components that run on nodes with any role. This section applies to every node as it includes components that run on nodes with any role.
## Check if the Containers are Running ## Check if the Containers are Running
@@ -2,6 +2,10 @@
title: DNS title: DNS
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/dns"/>
</head>
The commands/steps listed on this page can be used to check name resolution issues in your cluster. The commands/steps listed on this page can be used to check name resolution issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rotation of Expired Webhook Certificates title: Rotation of Expired Webhook Certificates
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/expired-webhook-certificate-rotation"/>
</head>
For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew. For Rancher versions that have `rancher-webhook` installed, certain versions created certificates that will expire after one year. It will be necessary for you to rotate your webhook certificate if the certificate did not renew.
In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue: In Rancher v2.6.3 and up, rancher-webhook deployments will automatically renew their TLS certificate when it is within 30 or fewer days of its expiration date. If you are using v2.6.2 or below, there are two methods to work around this issue:
@@ -2,6 +2,10 @@
title: Kubernetes Resources title: Kubernetes Resources
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/kubernetes-resources"/>
</head>
The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters. The commands/steps listed on this page can be used to check the most important Kubernetes resources and apply to [Rancher Launched Kubernetes](../../pages-for-subheaders/launch-kubernetes-with-rancher.md) clusters.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Logging title: Logging
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/logging"/>
</head>
## Log levels ## Log levels
The following log levels are used in Rancher: The following log levels are used in Rancher:
@@ -2,6 +2,10 @@
title: Networking title: Networking
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/networking"/>
</head>
The commands/steps listed on this page can be used to check networking related issues in your cluster. The commands/steps listed on this page can be used to check networking related issues in your cluster.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI. Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml` for Rancher HA) or are using the embedded kubectl via the UI.
@@ -2,6 +2,10 @@
title: Rancher HA title: Rancher HA
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/rancher-ha"/>
</head>
The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation. The commands/steps listed on this page can be used to check your Rancher Kubernetes Installation.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`). Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kube_config_cluster.yml`).
@@ -2,6 +2,10 @@
title: Registered Clusters title: Registered Clusters
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/registered-clusters"/>
</head>
The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher. The commands/steps listed on this page can be used to check clusters that you are registering or that are registered in Rancher.
Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`) Make sure you configured the correct kubeconfig (for example, `export KUBECONFIG=$PWD/kubeconfig_from_imported_cluster.yml`)
@@ -2,6 +2,10 @@
title: User ID Tracking in Audit Logs title: User ID Tracking in Audit Logs
--- ---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/troubleshooting/other-troubleshooting-tips/user-id-tracking-in-audit-logs"/>
</head>
The following audit logs are used in Rancher to track events occuring on the local and downstream clusters: The following audit logs are used in Rancher to track events occuring on the local and downstream clusters:
* [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/) * [Kubernetes Audit Logs](https://rancher.com/docs/rke/latest/en/config-options/audit-log/)