mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
CNV-66741: Add note about single VNC connection
This commit is contained in:
committed by
openshift-cherrypick-robot
parent
e47d6212ae
commit
3e24d4a5e8
BIN
images/vnc-console-warning.png
Normal file
BIN
images/vnc-console-warning.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 47 KiB |
@@ -49,6 +49,14 @@ endif::[]
|
||||
|
||||
. On the *Virtualization* -> *VirtualMachines* page, click a VM to open the *VirtualMachine details* page.
|
||||
. Click the *Console* tab. The VNC console session starts automatically.
|
||||
+
|
||||
[IMPORTANT]
|
||||
====
|
||||
Only one connection to the VNC console is possible at a time. If you attempt to create a second connection to the same VNC console, a warning is displayed, and you are prompted to disconnect the existing session before you create the new session.
|
||||
|
||||
image::vnc-console-warning.png[]
|
||||
====
|
||||
|
||||
ifdef::desktop-viewer,serial-console[]
|
||||
. Click *Disconnect* to end the VNC console session. Otherwise, the VNC console session continues to run in the background.
|
||||
. Select *{console-menu}* from the console list.
|
||||
|
||||
@@ -45,11 +45,29 @@ ifdef::vnc-console[]
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
$ virtctl vnc <vm_name>
|
||||
$ virtctl vnc <vm_name> -n <namespace> --preserve-session
|
||||
----
|
||||
+
|
||||
where:
|
||||
+
|
||||
<vm_name>:: The name of the VM.
|
||||
+
|
||||
<namespace>:: The namespace that contains the VM.
|
||||
+
|
||||
--preserve-session:: Prevents an existing VNC console connection from being disconnected if you attempt to start a new session.
|
||||
+
|
||||
Only one connection to the VNC console is possible at a time. If you attempt to create a second connection to the same VNC console, an error is displayed and the connection fails.
|
||||
+
|
||||
Example error message:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
can't access VMI example-vm: Internal error occurred: Can't connect to websocket (503): websocket: bad handshake: application info: Active VNC connection. Request denied.
|
||||
----
|
||||
+
|
||||
If you attempt to create a second connection to the same VNC console without using the `--preserve-session` flag, this forces the existing connection to disconnect to allow the new connection.
|
||||
|
||||
. If the connection fails, run the following command to collect
|
||||
troubleshooting information:
|
||||
. If the connection fails, run the following command to collect troubleshooting information:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
|
||||
@@ -16,7 +16,7 @@ You can connect to the following consoles to access running virtual machines (VM
|
||||
[id="vnc-console_virt-accessing-vm-consoles"]
|
||||
== Connecting to the VNC console
|
||||
|
||||
You can connect to the VNC console of a virtual machine by using the {product-title} web console or the `virtctl` command-line tool.
|
||||
You can connect to the Virtual Network Computing (VNC) console of a VM by using the {product-title} web console or the `virtctl` command-line tool.
|
||||
|
||||
:context: vnc-console
|
||||
include::modules/virt-connecting-to-vm-console-web.adoc[leveloffset=+2]
|
||||
|
||||
Reference in New Issue
Block a user