Operational Guide

This guide describes MetalK8s ISO preparation steps, upgrade and downgrade guidelines, supported versions and best practices required for operating MetalK8s. Refer to the Installation if you do not have a working MetalK8s setup.

• Bootstrap Node Backup and Restoration Procedure
  • Backup procedure
  • Restoration procedure
• Enable IP-in-IP encapsulation
• ISO Preparation
• Upgrade Guide
  • Supported Versions
  • Upgrade Pre-requisites
  • Upgrade Steps
• Downgrade Guide
• Supported Versions
• Downgrade Pre-requisites
• Downgrade Steps
• Changing the hostname of a MetalK8s node
• Volume Management
  • StorageClass Creation
  • Volume Management using the CLI
    • Volume Creation
    • Volume Deletion
  • Volume Management using the UI
    • Volume Creation
    • Volume Deletion
• Account Administration
  • Administering Grafana
    • Changing Grafana username and password
  • Administering MetalK8s GUI, Kubernetes API and Salt API
    • Managing Kubernetes API username and password
• Troubleshooting Guide
  • Bootstrap Installation Errors
    • Bootstrap Installation fails with no straightforward reason
    • Errors after restarting the Bootstrap node
    • Bootstrap fails and console log is unscrollable
  • Account Administration Errors
    • Forgot the MetalK8s GUI password
  • General Kubernetes Resource Errors
    • Pod status shows “CrashLoopBackOff”
    • Persistent Volume Claim(PVC) stuck in “Pending” state
    • Access to MetalK8s GUI fails with “undefined backend”
    • Pod and Service CIDR conflicts