OpenStack Hypervisor

Learn about actions >

• disable

  Prevent new instances from being created.

  Params

  • reason string

    Reason for disabling the hypervisor

• enable

  Allow new instances to be created.

• list-flavors

  List the flavors or compute host capabilities.

• list-gpus

  List host GPUs

• list-nics

  List host NICS, and which one are candidates for use as external NIC.

• refresh-snap

  Refresh the openstack-hypervisor snap to the latest available revision on the configured channel. The snap is held after installation to prevent automatic refreshes; use this action to apply updates explicitly.

• running-guests

  List the running guests on the hypervisor.

  Only lists guests created by the OpenStack cloud.

• set-hypervisor-local-settings

  Apply settings specific to this hypervisor unit

  Params

  • bridge-mapping string

    Space separated list of bridge:physnet:iface mappings. (br-ex:physnet1:ens3 ...)

  • external-nic string

    NIC that hypervisor will configure for North/South traffic

  • ip-address string

    IP address to use for service configuration

  • ovs-dpdk-ports string

    Comma separated list of interface names that will be used with DPDK.

    The interfaces will be bound to the DPDK-compatible driver (vfio-pci by default) and corresponding DPDK ports will be created in OVS. Any bridges and bonds that use those interfaces will be updated with the resulting DPDK ports, based on the MAAS/Netplan configuration.

    The NUMA nodes of those interfaces will be used to determine pinned CPUs and huge pages used by OVS.

  • pci-excluded-devices string

    A list of PCI addresses that will be excluded from the Nova PCI device whitelist. The main purpose of this setting is to accommodate per-node exclusion lists.

    For example, let's say that the user whitelisted all Intel x550 devices and then excluded one out of 4 such interfaces: pci_device_specs = [{"vendor_id": "8086", "product_id": "1563"}] excluded_devices = ["0000:1b:00.1"]

    The updated device spec will contain the vendor/product and pci address of the remaining 3 Intel x550 devies.

    [
        {"vendor_id": "8086", "product_id": "1563", "address": "0000:19:00.0"},
        {"vendor_id": "8086", "product_id": "1563", "address": "0000:19:00.1"},
        {"vendor_id": "8086", "product_id": "1563", "address": "0000:1b:00.0"},
    ]

    A device spec that doesn't contain any excluded devices will not be modified.

  • spice-proxy-address string

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