Chapter 3. Troubleshooting a cluster


To begin troubleshooting a MicroShift cluster, first access the cluster status.

3.1. Checking the status of a cluster

You can check the status of a MicroShift cluster or see active pods by running a simple command. Given in the following procedure are three commands you can use to check cluster status. You can choose to run one, two, or all commands to help you retrieve the information you need to troubleshoot the cluster.

Procedure

  • You can check the system status, which returns the cluster status, by running the following command:

    $ sudo systemctl status microshift

    If MicroShift is failing to start, this command returns the logs from the previous run.

  • Optional: You can view the logs by running the following command:

    $ sudo journalctl -u microshift
Note

The default configuration of the systemd journal service stores data in a volatile directory. To persist system logs across system starts and restarts, enable log persistence and set limits on the maximum journal data size.

  • Optional: If MicroShift is running, you can see active pods by entering the following command:

    $ oc get pods -A
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.