E.3. Websocket Proxy

1. On the Manager machine, run engine-cleanup to remove the required configuration.

   # engine-cleanup

   Copy to Clipboard Toggle word wrap

2. Type No when asked to remove all components and press Enter.

   Do you want to remove all components? (Yes, No) [Yes]: No

   Copy to Clipboard Toggle word wrap

3. Type No when asked to remove the engine and press Enter.

   Do you want to remove the engine? (Yes, No) [Yes]: No

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   Select No if asked to remove any other components.

Procedure

1. Install the websocket proxy:

   # yum install ovirt-engine-websocket-proxy

   Copy to Clipboard Toggle word wrap

2. Run the engine-setup command to configure the websocket proxy.

   # engine-setup

   Copy to Clipboard Toggle word wrap
   Note

   If the rhvm package has also been installed, choose No when asked to configure the Manager (Engine) on this host.

3. Press Enter to allow engine-setup to configure a websocket proxy server on the machine.

   Configure WebSocket Proxy on this machine? (Yes, No) [Yes]:

   Copy to Clipboard Toggle word wrap

4. Press Enter to accept the automatically detected host name, or enter an alternative host name and press Enter. Note that the automatically detected host name may be incorrect if you are using virtual hosts:

   Host fully qualified DNS name of this server [host.example.com]:

   Copy to Clipboard Toggle word wrap

5. Press Enter to allow engine-setup to configure the firewall and open the ports required for external communication. If you do not allow engine-setup to modify your firewall configuration, then you must manually open the required ports.

   Setup can automatically configure the firewall on this system.
   Note: automatic configuration of the firewall may overwrite current settings.
   Do you want Setup to configure the firewall? (Yes, No) [Yes]:

   Copy to Clipboard Toggle word wrap

6. Enter the FQDN of the Manager machine and press Enter.

   Host fully qualified DNS name of the engine server []: manager.example.com

   Copy to Clipboard Toggle word wrap

7. Press Enter to allow engine-setup to perform actions on the Manager machine, or press 2 to manually perform the actions.

   Setup will need to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action.
   Please choose one of the following:
   1 - Access remote engine server using ssh as root
   2 - Perform each action manually, use files to copy content around
   (1, 2) [1]:

   Copy to Clipboard Toggle word wrap

   1. Press Enter to accept the default SSH port number, or enter the port number of the Manager machine.

      ssh port on remote engine server [22]:

      Copy to Clipboard Toggle word wrap

   2. Enter the root password to log in to the Manager machine and press Enter.

      root password on remote engine server engine_host.example.com:

      Copy to Clipboard Toggle word wrap

8. Select whether to review iptables rules if they differ from the current settings.

   Generated iptables rules are different from current ones.
   Do you want to review them? (Yes, No) [No]:

   Copy to Clipboard Toggle word wrap

9. Press Enter to confirm the configuration settings.

   --== CONFIGURATION PREVIEW ==--
   
   Firewall manager                        : iptables
   Update Firewall                         : True
   Host FQDN                               : host.example.com
   Configure WebSocket Proxy               : True
   Engine Host FQDN                        : engine_host.example.com
   
   Please confirm installation settings (OK, Cancel) [OK]:

   Copy to Clipboard Toggle word wrap

   Instructions are provided to configure the Manager machine to use the configured websocket proxy.

   Manual actions are required on the engine host
   in order to enroll certs for this host and configure the engine about it.
   
   Please execute this command on the engine host:
      engine-config -s WebSocketProxy=host.example.com:6100
   and than restart the engine service to make it effective

   Copy to Clipboard Toggle word wrap

10. Log in to the Manager machine and execute the provided instructions.

    # engine-config -s WebSocketProxy=host.example.com:6100
    # systemctl restart ovirt-engine.service

    Copy to Clipboard Toggle word wrap