Mirantis Container Cloud (MCC) becomes part of Mirantis OpenStack for Kubernetes (MOSK)!

Starting with MOSK 25.2, the MOSK documentation set covers all product layers, including MOSK management (formerly MCC). This means everything you need is in one place. The separate MCC documentation site will be retired, so please update your bookmarks for continued easy access to the latest content.

Enable maintenance mode on a cluster and machine using web UI

You can use the instructions below to enable maintenance mode on a cluster and machine using the Container Cloud web UI. To enable maintenance mode using the Container Cloud API, refer to Enable maintenance mode on a cluster and machine using CLI.

Caution

  • To enable maintenance mode on a machine, first enable maintenance mode on the related cluster.

  • To disable maintenance mode on a cluster, first disable maintenance mode on all machines of the cluster.

Warning

During cluster and machine maintenance:

  • Cluster upgrades and configuration changes (except of the SSH keys setting) are unavailable. Make sure you disable maintenance mode on the cluster after maintenance is complete.

  • Data load balancing is disabled while Ceph is in maintenance mode.

  • Workloads are not affected.

Enable maintenance mode on a cluster and machine

  1. Log in to the Container Cloud web UI with the m:kaas:namespace@operator or m:kaas:namespace@writer permissions.

  2. Enable maintenance mode on the cluster:

    1. In the Clusters tab, click the More action icon in the last column of the cluster you want to put into maintenance mode and select Enter maintenance. Confirm your selection.

    2. Wait until the Status of the cluster switches to Maintenance.

    Now, you can switch cluster machines to maintenance mode.

    Caution

    Due to the known issue 53886, you can only move controller machines into maintenance mode using the web UI. For worker nodes, use the API as described in Enable maintenance mode on a cluster and machine using CLI.

  3. In the Clusters tab, click the required cluster name to open the list of machines running on it.

  4. In the Maintenance column of the machine you want to put into maintenance mode, enable the toggle switch.

  5. Wait until the machine Status switches to Maintenance.

    Once done, the node of the selected machine is cordoned, drained, and prepared for maintenance operations.

    Important

    Proceed with the node maintenance only after the machine Status switches to Maintenance.

Disable maintenance mode on a cluster and machine

  1. Log in to the Container Cloud web UI with the m:kaas:namespace@operator or m:kaas:namespace@writer permissions.

  2. In the Clusters tab, click the required cluster name to open its machines list.

  3. In the Maintenance column of the machine you want to disable maintenance mode, disable the toggle switch.

  4. Wait until the machine Status does not display Maintenance, Pending maintenance, or the progress indicator.

  5. Repeat the above steps for all machines that are in maintenance mode.

  6. Disable maintenance mode on the related cluster:

    1. In the Clusters tab, click the More action icon in the last column of the cluster where you want to disable maintenance mode and select Exit maintenance.

    2. Wait until the cluster Status does not display Maintenance, Pending maintenance, or the progress indicator.