1. Documentation
    2. history bug_report picture_as_pdf
×

Connecting to virtual machine consoles

Connecting to the VNC console

You can connect to the VNC console of a virtual machine by using the OpenShift Container Platform web console or the virtctl command line tool.

Connecting to the VNC console by using the web console

You can connect to the VNC console of a virtual machine (VM) by using the OpenShift Container Platform web console.

If you connect to a Windows VM with a vGPU assigned as a mediated device, you can switch between the default display and the vGPU display.
Procedure

  1. On the Virtualization → VirtualMachines page, click a VM to open the VirtualMachine details page.

  2. Click the Console tab. The VNC console session starts automatically.

  3. Optional: To switch to the vGPU display of a Windows VM, select Ctl + Alt + 2 from the Send key list.

    • Select Ctl + Alt + 1 from the Send key list to restore the default display.

  4. To end the console session, click outside the console pane and then click Disconnect.

Connecting to the VNC console by using virtctl

You can use the virtctl command line tool to connect to the VNC console of a running virtual machine.

If you run the virtctl vnc command on a remote machine over an SSH connection, you must forward the X session to your local machine by running the ssh command with the -X or -Y flags.
Prerequisites

  • You must install the virt-viewer package.

Procedure

  1. Run the following command to start the console session:

    $ virtctl vnc <vm_name>

  2. If the connection fails, run the following command to collect troubleshooting information:

    $ virtctl vnc <vm_name> -v 4

Connnecting to the serial console

You can connect to the serial console of a virtual machine by using the OpenShift Container Platform web console or the virtctl command line tool.

Connecting to the serial console by using the web console

You can connect to the serial console of a virtual machine (VM) by using the OpenShift Container Platform web console.

Procedure

  1. On the Virtualization → VirtualMachines page, click a VM to open the VirtualMachine details page.

  2. Click the Console tab. The VNC console session starts automatically.

  3. Click Disconnect to end the VNC console session. Otherwise, the VNC console session continues to run in the background.

  4. Select Serial console from the console list.

  5. To end the console session, click outside the console pane and then click Disconnect.

Connecting to the serial console by using virtctl

You can use the virtctl command line tool to connect to the serial console of a running virtual machine.

Procedure

  1. Run the following command to start the console session:

    $ virtctl console <vm_name>

  2. Press Ctrl+] to end the console session.

Connecting to the desktop viewer

You can connect to a Windows virtual machine (VM) by using the desktop viewer and the Remote Desktop Protocol (RDP).

Connecting to the desktop viewer by using the web console

You can connect to the desktop viewer of a Windows virtual machine (VM) by using the OpenShift Container Platform web console.

Prerequisites

  • You installed the QEMU guest agent on the Windows VM.

  • You have an RDP client installed.

Procedure

  1. On the Virtualization → VirtualMachines page, click a VM to open the VirtualMachine details page.

  2. Click the Console tab. The VNC console session starts automatically.

  3. Click Disconnect to end the VNC console session. Otherwise, the VNC console session continues to run in the background.

  4. Select Desktop viewer from the console list.

  5. Click Create RDP Service to open the RDP Service dialog.

  6. Select Expose RDP Service and click Save to create a node port service.

  7. Click Launch Remote Desktop to download an .rdp file and launch the desktop viewer.