Add a troubleshooting guide

[jamiemonserrate]

Describe the solution you'd like Can we add a troubleshooting guide with the most common errors folks run into? Ideas to include

• how to debug a kube-vip not working scenario
• pre-requisites not installed on the host
• how to debug installer failures

[kerenbenzion]

do you have estimation when such guide will be released? I am currently trying to deploy a cluster using the byoh provider and I have a scenario where kube-vip is not working, and I am not sure how to debug it.

[jamiemonserrate]

We are aiming to get this done in the next couple of months. But in the meanwhile, we are happy to try to help you over Slack. Would you mind starting a thread in #cluster-api-baremetal on the kubernetes slack and tag @Anusha Hegde @Dharmjit @Jamie Monserrate, and we could help you get unblocked.

[kerenbenzion]

@jamiemonserrate would you mind sending me an invite to this workspace ?I am not part of it

thanks, Keren

[anusha94]

Hey @kerenbenzion , I see that you are trying to delete byohosts as mentioned in this issue here, so I'm hoping you got past the kube-vip issue? If not feel free to post your queries / errors / logs here or on slack (#cluster-api or #cluster-api-baremetal)

[anusha94]

Add to the troubleshooting guide - If your host linux is other than Ubuntu 20.04, say Ubuntu 18.04, then you may encounter this error while executing make prepare-byoh-docker-host-image

E: Unable to locate package linux-image-4.15.0-161-generic
E: Couldn't find any package by glob 'linux-image-4.15.0-161-generic'
E: Couldn't find any package by regex 'linux-image-4.15.0-161-generic'

[anusha94]

Some troubleshooting tips here - https://github.com/vmware-tanzu/cluster-api-provider-bringyourownhost/pull/424