21.3. Websocket Proxy

21.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 21.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.

21.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 21.5. Migrating the Websocket Proxy to a Separate Machine

  1. On the Manager machine, run engine-cleanup to remove the required configuration.
    # engine-cleanup
    
  2. Type No when asked to remove all components and press Enter.
    Do you want to remove all components? (Yes, No) [Yes]: No
    
  3. Type No when asked to remove the engine and press Enter.
    Do you want to remove the engine? (Yes, No) [Yes]: No
    
  4. Type Yes when asked to remove the websocket proxy and press Enter.
    Do you want to remove the WebSocket proxy? (Yes, No) [No]: Yes
    
    Select No if asked to remove any other components.
  5. Install and configure the proxy on the separate machine. See Installing a Websocket Proxy on a Separate Machine in the Installation Guide for instructions.