openstack/ironic
Code Issues Proposed changes
ironic/doc/source/install/install.rst
Steve Baker beaaf405d3 Add ironic-novncproxy service 
This is a forklift of the nova novncproxy service to act as the noVNC
front-end to graphical consoles.

The service does the following:
- serves noVNC web assets for the browser based VNC client
- creates a websocket to proxy VNC traffic to an actual VNC server
- decouples authentication traffic so that the source server can have
  a different authentication method than the browser client

The forklifted code has been adapted to Ironic conventions, including:
- [vnc] config options following Ironic conventions and using existing
  config options where appropriate
- Removing the unnecessary authentication method VeNCrypt, leaving only
  the None auth method.
- Adapting the ironic-novncproxy command to use Ironic's service launch
  approach, allowing it to be started as part of the all-in-one ironic
- Replace Nova's approach of looking up the instance via the token.
  Instead the node UUID is included in the websocket querystring
  alongside the token
- Removing cookie fallback when token is missing from querystring
- Removing expected protocol validation in the websocket handshake
- Removing internal access path support
- Removing enforce_session_timeout as this will be done at the
  container level

Related-Bug: 2086715
Change-Id: I575a8671e2262408ba1d690cfceabe992c2d4fef
2025-02-19 20:17:57 +00:00

2.5 KiB
Raw Permalink Blame History

Install and configure the Bare Metal service

This section describes how to install and configure the Bare Metal service, code-named ironic, manually from packages on one of the three popular families of Linux distributions.

Alternatively, you can use one of the numerous projects that install ironic. One of them is provided by the bare metal team:

  • Bifrost installs ironic in the standalone mode (without the rest of OpenStack).

More installation projects are developed by other OpenStack teams:

install-rdo.rst install-ubuntu.rst install-obs.rst

Install and configure components

Using DNF on RHEL/CentOS Stream and RDO packages:

# dnf install openstack-ironic-api openstack-ironic-conductor openstack-ironic-novncproxy python3-ironicclient

On Ubuntu/Debian:

# apt-get install ironic-api ironic-conductor ironic-novncproxy python3-ironicclient

On openSUSE/SLES:

# zypper install openstack-ironic-api openstack-ironic-conductor ironic-novncproxy python3-ironicclient

Warning

Support for SUSE systems is best effort, it is not tested in the CI.