From b633f9066f46802365c4ea1d8ca6125d734e90b8 Mon Sep 17 00:00:00 2001 From: Valentin Knabel Date: Wed, 12 Jun 2024 14:51:27 +0200 Subject: [PATCH] docs: troubleshoot switch sync failing --- docs/src/installation/troubleshoot.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/src/installation/troubleshoot.md b/docs/src/installation/troubleshoot.md index 0bc874382e..3b67b2dcad 100644 --- a/docs/src/installation/troubleshoot.md +++ b/docs/src/installation/troubleshoot.md @@ -225,3 +225,12 @@ There are some scenarios (can be vendor-specific), which can cause a machine UUI 1. After five minutes, the orphaned machine UUID will be marked dead (💀) because machine events will be sent only to the most recent UUID 1. Identify the dead machine through `metalctl machine ls` 1. Remove the dead machine forcefully with `metalctl machine rm --remove-from-database --yes-i-really-mean-it ` + +### Fixing Switch Issues + +#### switch-sync-failing + +For your network infrastructure it is key to adapt to new configuration. In case this sync process fails for more than 10 minutes, it is likely to require manual investigation. + +Depending on your switch operating system, the error sources might differ a lot. +Try to connect to your switch using the console or ssh and investigate the logs. Check if the hard drive is full.