openstack-hypervisor

By Canonical

View on Snapcraft.io

Version2024.1

Revision560

LicenseApache-2.0

Confinementstrict

Basecore24

OpenStack Hypervisor

This snap is designed to be used with a deployed OpenStack Control plane such as delivered by Sunbeam.

Getting Started

To get started with the OpenStack Hypervisor, install the snap using snapd:

$ sudo snap install openstack-hypervisor

The snap needs to be configured with credentials and URL's for the Identity
service of the OpenStack cloud that it will form part of - for example:

$ sudo snap set openstack-hypervisor \

    identity.authurl=http://10.64.140.43:80/sunbeam-keystone \

identity.username=nova-hypervisor-01 \

identity.password=supersecure21

it's also possible to configure domain and project configuration.

The snap also needs to be configured with access to RabbitMQ:

$ sudo snap set openstack-hypervisor \

rabbitmq.url=rabbit://nova:supersecure22@10.152.183.212:5672/openstack

and with URL's for access to Network services:

$ sudo snap set openstack-hypervisor \

network.ovn-sb-connection=tcp:10.152.183.220:6642

The snap has numerous other configuration options - see "Configuration Reference"
for full details.

Configuration Reference

compute

Configuration of options related to compute (Nova):

compute.virt-type libvirt Virtualization type

This option is runtime detected by the snap and will be set
to kvm if the host is capable of full virtualization or qemu if not.

compute.cpu-mode (host-model) CPU mode for instances

Valid values: host-model, host-passthrough, custom, none.

compute.cpu-models CPU models for hypervisor

An ordered list of CPU models the host supports.

Only used with compute.cpu-mode is set to custom.

For more details please refer to the Nova [configuration reference](https://docs.openstack.org/nova/latest/admin/cpu-models.html)
for cpu models.

compute.spice-proxy-address (localhost) IP address for SPICE consoles

IP address to use for configuration of SPICE consoles in instances.

identity

Configuration of options related to identity (Keystone):

identity.auth-url Full URL for Keystone API

identity.username Username for services to use

identity.password Password for services to use

identity.user-domain-name (servicedomain) Domain for user
identity.project-name (services) Service project
identity.project-domain-name (service_domain) Domain for service project
identity.region-name (RegionOne) OpenStack region to use

logging

Configuration of logging options across all services:

logging.debug (false) Enable debug log level

node

Configuration of options related to the hypervisor node in general:

node.fqdn (hostname -f) Fully qualified hostname for node
node.ip-address IP address to use for service configuration

These options are use to configure the identity of the agents that
run as part of the snap.

network

Configuration of options related to networking, including Neutron
and OVN:

network.dns-domain DNS domain name to use for networking
network.dns-servers External DNS servers to use for forwarding DNS requests

network.external-bridge (br-ex) Name of OVS external network bridge
network.physnet-name (physnet1) Neutron label for physical network

network.ip-address (node.ip-address) IP address to use for overlay network endpoints
network.ovn-sb-connection (tcp:127.0.0.1:6642) OVN Southbound DB connection URL
network.enable-gateway (False) Enable OVS/OVS as north/south gateway

TLS configuration for OVN can also be supplied via snap configuration:

network.ovn-key Private TLS key
network.ovn-cert TLS certificate for ovn-key
network.ovn-cacert CA certificate (and chain) for certificate validation

All of the above options must be provided as base64 encoded strings.

rabbitmq

Configuration of options related to RabbitMQ messaging:

rabbitmq.url (rabbit://localhost:5672) Full connection URL to RabbitMQ

Update History

2024.1 (560)

1 Apr 2026, 21:28 UTC

Published25 Oct 2022, 09:42 UTC

Last updated18 Mar 2026, 04:10 UTC

First seen1 Apr 2026, 21:28 UTC