Troubleshooting a Manual Setup

Troubleshooting a Manual Setup

This section covers troubleshooting after performing a manual setup.
To perform a manual setup, refer to Manually Setting Up a Resonate Kubernetes Cluster.

Common Issues

The following are some common issues:
Common Issues
Problem
Solution
Snap not found
  • Ensure snapd is installed and running.
    snap list
  • Check if
    /snap symlink
    exists:
    ls -la /snap
  • Adjust your path or restart your session.
MicroK8s not starting
  • Check logs:
    sudo microk8s inspect
  • Restart the MicroK8s Kubernetes environment:
    sudo microk8s stop && sudo microk8s start
Storage issues
  • For single-node (hostpath), ensure
    /data/volumes
    exists and is writable.
  • For multi-node (Rook-Ceph), verify that the block devices are unmounted and have no file system.
Firewall issues (Red Hat)
  • Check if firewalld is running:
    sudo systemctl status firewalld
  • Verify the microk8s zone:
    sudo firewall-cmd --list-all-zones | grep -A5 microk8s
Node
join
failures
  • Check network connectivity between nodes.
  • Have your system administrator verify that ports 25000 and 19001 are accessible.
  • Have your system administrator ensure that system time is synchronized.

Log Files

To help with troubleshooting, check the log files:
  • For MicroK8s log files:
    sudo microk8s inspect
  • For Snap log files:
    sudo journalctl -u snapd
  • For System log files:
    sudo journalctl -xe