Skip to main content

Overview

Polystack Compute exposes advanced hypervisor capabilities for workloads that require dedicated hardware resources, hardware-enforced security, or accelerated computing. These features are activated through flavor extra specs and require corresponding host-level configuration on participating compute nodes.
Administrator Access Required — This operation requires the admin role. Contact your Polystack administrator if you do not have sufficient permissions.
Prerequisites
  • Administrator credentials sourced (source openrc.sh)
  • Host-level hardware features configured through the deployment console (IOMMU, huge pages, VFIO)
  • Relevant scheduler filters active in the scheduler configuration

Features

EnterpriseNUMA-aware scheduling ensures that an instance’s vCPUs and memory are allocated from the same physical NUMA cell on the host, avoiding cross-node memory access penalties. The NUMATopologyFilter in the scheduler evaluates each host’s NUMA topology and rejects placements that would split an instance across cells.Unlike VMware’s cluster-wide EVC setting, Polystack provides per-flavor NUMA granularity — each flavor can define its own NUMA cell count and CPU/memory distribution, allowing mixed workload profiles on the same compute cluster.
Create a NUMA-aware flavor (2 NUMA nodes, 8 vCPUs)
For most workloads, setting hw:numa_nodes=1 is sufficient to ensure all resources are allocated from a single NUMA cell. Use hw:numa_nodes=2 only for large instances that exceed a single cell’s capacity.
EnterpriseCPU pinning dedicates physical CPU threads exclusively to a single instance, eliminating scheduling jitter and improving performance predictability for latency-sensitive workloads such as real-time databases, financial applications, and telco VNFs.Polystack supports three CPU policy modes:
  • dedicated — all vCPUs are pinned to exclusive physical threads
  • shared — vCPUs float across all available host CPUs (default behavior)
  • mixed — some vCPUs are pinned while others float, enabling a balance between deterministic performance for critical threads and flexible scheduling for background threads
Host requirements: NUMA topology support must be enabled on the compute node. The NUMATopologyFilter must be active in the scheduler filter chain.Create a flavor with dedicated CPU policy:
Create CPU-pinned flavor
Configure CPU pinning host requirements on participating nodes through the deployment console under Compute → Advanced → NUMA Configuration. Only hosts with NUMA support enabled accept CPU-pinned instances.
EnterpriseCPU feature masking normalizes the CPU instruction set exposed to instances, enabling live migration across compute nodes with different CPU generations. This is the Polystack equivalent of VMware’s Enhanced vMotion Compatibility (EVC), with a key difference: Polystack applies masking per-flavor or per-image rather than at the cluster level, allowing different workloads to use different CPU baselines on the same cluster.Set a common CPU model baseline on the flavor:
Set CPU model for cross-generation migration
When using host-model or host-passthrough, the instance exposes the host’s native CPU features. Live migration to a host with a different CPU generation will fail if the destination lacks required features. Use custom mode with an explicit model to guarantee migration compatibility.
EnterpriseHuge pages reduce TLB (Translation Lookaside Buffer) pressure for memory-intensive workloads. The hypervisor pre-allocates huge page pools on the host at boot time. Polystack supports two page sizes:
  • 2 MB huge pages — suitable for most workloads including databases, application servers, and general-purpose memory optimization. Lower host memory fragmentation risk.
  • 1 GB huge pages — optimal for HPC, in-memory analytics, and latency-sensitive network functions (DPDK, VNFs) where TLB coverage per entry is critical.
Host requirements: Huge page pools must be pre-allocated on the compute node. Configure pool sizes through the deployment console under Compute → Advanced → Memory Configuration.
Instances using huge pages are scheduled only onto hosts where the required huge page pool is allocated. The scheduler rejects hosts without sufficient huge pages of the requested size.
Use hw:mem_page_size=any to allow the scheduler to place the instance on a host with either 2 MB or 1 GB pages, maximizing scheduling flexibility.
EnterpriseGPU passthrough exposes a physical GPU device directly to an instance with near-native performance. The GPU is bound to the VFIO driver on the host and assigned exclusively to one instance at a time. Use this for AI/ML training, 3D rendering, and GPU-accelerated simulation workloads.Host requirements: IOMMU must be enabled in host BIOS and OS. The GPU must be bound to the VFIO driver. Configure this through the deployment console under Compute → Hardware → GPU Configuration.List available PCI resource providers to find the GPU alias:
List resource providers
Show inventory for a resource provider
Request the GPU in a flavor using the configured device alias:
Add GPU alias to flavor
All compute nodes exposing the same GPU type must use the same alias name. The PciPassthroughFilter must be active in the scheduler filter chain to route GPU-requesting instances to hosts with available devices.
EnterprisevTPM provides a software-emulated TPM chip inside the instance, enabling disk encryption (BitLocker, LUKS), measured boot attestation, and secure credential storage. Polystack supports live migration of vTPM instances with automatic secret transfer via Polystack Key Management — the encrypted TPM state is seamlessly transferred to the destination host without manual intervention.Supported models:Host requirements: Polystack Key Management must be enabled for secret storage. The swtpm software TPM emulator must be installed on all compute nodes.Provisioning methods:
In the Dashboard, vTPM can be enabled through the flavor extra specs panel or the image admin form. The instance detail page displays the vTPM status when attached.
vTPM state is encrypted at rest using a secret stored in Polystack Key Management. Ensure Polystack Key Management is enabled and healthy before provisioning vTPM instances. If the Key Management service is unavailable, vTPM instances cannot start or be live-migrated.
UEFI boot is required for Secure Boot, vTPM, and GPT-partitioned disk layouts. Enable UEFI at the image level or as a flavor property. Secure Boot adds an additional layer by verifying the bootloader signature at startup.Set UEFI firmware type on an image:
Enable UEFI boot on an image
Enable Secure Boot through a flavor property:
Require Secure Boot via flavor
Secure Boot requires a signed bootloader in the guest OS. Unsigned kernels and bootloaders will fail to start with Secure Boot enabled. Verify guest OS compatibility before deploying Secure Boot in production.
EnterprisePCI passthrough grants exclusive access to any host PCI device — network adapters, accelerators, storage controllers, or FPGAs — to a single instance. The device is isolated from the host OS using IOMMU groups, providing hardware-level isolation and near-native performance.Host requirements: IOMMU must be enabled. Device aliases must be configured and consistent across all nodes exposing the same device type. Configure through the deployment console under Compute → Hardware → PCI Passthrough.
Request a PCI device via flavor
Replace <device-alias> with the alias name configured in the deployment console. The number after the colon specifies how many devices to attach (typically 1).
PCI-attached devices cannot be live-migrated. Instances with PCI passthrough are limited to cold migration only. Factor this constraint into your maintenance and availability planning.

Next Steps

Flavor Management

Apply extra specs to flavors to activate advanced hardware features for tenants.

Security Hardening

Combine vTPM and UEFI Secure Boot with compute control plane hardening.

Admin Guide

Return to the Compute Administration Guide index.