mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-07 00:48:01 +01:00
43 lines
1.5 KiB
Plaintext
43 lines
1.5 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * virt/virtual_machines/virt-accessing-vm-consoles.adoc
|
|
|
|
[id="virt-vm-rdp-console-web_{context}"]
|
|
= Connecting to the RDP console
|
|
|
|
The desktop viewer console, which utilizes the Remote Desktop Protocol (RDP),
|
|
provides a better console experience for connecting to Windows virtual machines.
|
|
|
|
To connect to a Windows virtual machine with RDP, download the `console.rdp`
|
|
file for the virtual machine from the *Consoles* tab in the
|
|
*Virtual Machine Details* screen of the web console and supply it to your
|
|
preferred RDP client.
|
|
|
|
.Prerequisites
|
|
|
|
* A running Windows virtual machine with the QEMU guest agent installed. The
|
|
`qemu-guest-agent` is included in the VirtIO drivers.
|
|
* A layer-2 NIC attached to the virtual machine.
|
|
* An RDP client installed on a machine on the same network as the
|
|
Windows virtual machine.
|
|
|
|
.Procedure
|
|
|
|
. In the {VirtProductName} console, click *Workloads* -> *Virtualization* from the side menu.
|
|
. Click the *Virtual Machines* tab.
|
|
. Select a Windows virtual machine to open the *Virtual Machine Overview* screen.
|
|
. Click the *Console* tab.
|
|
. In the *Console* list, select *Desktop Viewer*.
|
|
. In the *Network Interface* list, select the layer-2 NIC.
|
|
. Click *Launch Remote Desktop* to download the `console.rdp` file.
|
|
. Open an RDP client and reference the `console.rdp` file. For example, using
|
|
*remmina*:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ remmina --connect /path/to/console.rdp
|
|
----
|
|
|
|
. Enter the *Administrator* user name and password to connect to the
|
|
Windows virtual machine.
|