1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-07 00:48:01 +01:00
Files
openshift-docs/modules/virt-accessing-rdp-console.adoc

76 lines
1.9 KiB
Plaintext

// Module included in the following assemblies:
//
// * virt/virtual_machines/virt-accessing-vm-consoles.adoc
[id="virt-accessing-rdp-console_{context}"]
= Connecting to a Windows virtual machine with an RDP console
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, specify the IP address of the
attached L2 NIC to your 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
. Log in to the {VirtProductName} cluster through the `oc` CLI tool as a user with
an access token.
+
[source,terminal]
----
$ oc login -u <user> https://<cluster.example.com>:8443
----
. Use `oc describe vmi` to display the configuration of the running
Windows virtual machine.
+
[source,terminal]
----
$ oc describe vmi <windows-vmi-name>
----
+
.Example output
[source,yaml]
----
...
spec:
networks:
- name: default
pod: {}
- multus:
networkName: cnv-bridge
name: bridge-net
...
status:
interfaces:
- interfaceName: eth0
ipAddress: 198.51.100.0/24
ipAddresses:
198.51.100.0/24
mac: a0:36:9f:0f:b1:70
name: default
- interfaceName: eth1
ipAddress: 192.0.2.0/24
ipAddresses:
192.0.2.0/24
2001:db8::/32
mac: 00:17:a4:77:77:25
name: bridge-net
...
----
. Identify and copy the IP address of the layer 2 network interface. This is
`192.0.2.0` in the above example, or `2001:db8::` if you prefer IPv6.
. Open an RDP client and use the IP address copied in the previous step for the
connection.
. Enter the *Administrator* user name and password to connect to the
Windows virtual machine.