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.

Access the bare metal node console

Available since MOSK 25.2 TechPreview

This section explains how to access bare metal nodes through the remote serial console. Login is available from both the web UI and CLI, allowing for simplified operations and reduced manual overhead compared to previous bare metal procedures.

The serial console uses the socat library and is supported by the ipmi hardware type.

In the MOSK Compute service (OpenStack Nova), the remote serial console is activated automatically for all bare metal nodes. Before you, as the end user, can access the console, the cloud administrator must explicitly enable it for the bare metal node.

Note

The serial console is resource-intensive. Administrators should avoid enabling it for many nodes at the same time.

For example, to enable and verify the console:

openstack baremetal console enable <node-UUID>
openstack baremetal console show <node-UUID>

After the cloud administrator enables the console, the Ironic Conductor service starts a socat proxy for the node.

Once the cloud administrator has enabled the remote serial console for the bare metal node, you can use it to access this node through either web UI or CLI:

  1. Open the Dashboard and log in to your account.

  2. Navigate to Compute → Instances and select the instance corresponding to the bare metal node you want to access.

  3. Click the Console tab.

This opens the remote serial console session in the browser, allowing you to interact with the bare metal node.

  1. Retrieve the console connection details:

    openstack console url show <node-UUID> --serial
    

    Example of system response:

    +--------+-----------------------------------------------------------------+
    | Type   | Url                                                             |
    +--------+-----------------------------------------------------------------+
    | serial | ws://127.0.0.1:6083/?token=5f7854b7-bf3a-41eb-857a-43fc33f0b1ec |
    +--------+-----------------------------------------------------------------+
    
  2. Use the URL from the output to access the console. For example, using websocat:

    websocat ws://127.0.0.1:6083/?token=5f7854b7-bf3a-41eb-857a-43fc33f0b1ec
    

This opens a terminal-like session directly to the serial console, allowing you to interact with the bare metal node.