20.3. Websocket Proxy
20.3.1. Websocket Proxy Overview
The websocket proxy allows users to connect to virtual machines via noVNC and SPICE HTML5 consoles. Previously, the websocket proxy could only run on the Red Hat Virtualization Manager machine, but now the proxy can run on any machine that has access to the network.
The websocket proxy can be installed and configured on the Red Hat Virtualization Manager machine during the initial configuration (see Configuring the Red Hat Virtualization Manager in the Installation Guide), or on a separate machine (see Installing a Websocket Proxy on a Separate Machine in the Installation Guide).
The websocket proxy can also be migrated from the Manager machine to a separate machine. See Section 20.3.2, “Migrating the Websocket Proxy to a Separate Machine”.
Note
SPICE HTML5 support is a Technology Preview feature. Technology Preview features are not fully supported under Red Hat Subscription Service Level Agreements (SLAs), may not be functionally complete, and are not intended for production use. However, these features provide early access to upcoming product innovations, enabling customers to test functionality and provide feedback during the development process.
20.3.2. Migrating the Websocket Proxy to a Separate Machine
For security or performance reasons the websocket proxy can run on a separate machine that does not run Red Hat Virtualization Manager. The procedure to migrate the websocket proxy from the Manager machine to a separate machine involves removing the websocket proxy configuration from the Manager machine, then installing the proxy on the separate machine.
The
engine-cleanup
command can be used to remove the websocket proxy from the Manager machine.
Procedure 20.5. Migrating the Websocket Proxy to a Separate Machine
- On the Manager machine, run
engine-cleanup
to remove the required configuration.# engine-cleanup
- Type
No
when asked to remove all components and press Enter.Do you want to remove all components? (Yes, No) [Yes]: No
- Type
No
when asked to remove the engine and press Enter.Do you want to remove the engine? (Yes, No) [Yes]: No
- Type
Yes
when asked to remove the websocket proxy and press Enter.Do you want to remove the WebSocket proxy? (Yes, No) [No]: Yes
SelectNo
if asked to remove any other components. - Install and configure the proxy on the separate machine. See Installing a Websocket Proxy on a Separate Machine in the Installation Guide for instructions.