Masquerade uses OVN-K over eno2/br-ex — no bridge setup required
Test cases(24 of 50)
Complete prerequisites first ([PRE-01](PRE-01) → [PRE-08](PRE-08) minimum) before running these tests. Go to prerequisites
NOT POSSIBLE on SNO — live migration requires ≥2 nodes. Documented as an expected failure.
Test on local storage
Optimal for single-NIC — OVN-K over eno2/br-ex, no bridge setup required
✗ NOT TESTABLE ON HETZNER -- TOS violation! OVN-K localnet works technically (verified 30.06.2026: ping successful), but any VM MAC that reaches eno2/the physical switch via this interface is detected and reported by Hetzner as an unauthorised MAC (server suspension threatened). Only the registered server MAC is permitted.
✗ NOT TESTABLE — SR-IOV requires a dedicated second NIC (Intel X710, Mellanox ConnectX). The sole NIC eno2 is consumed by OVN-K and cannot be used for SR-IOV VFs.
Variant A uses pure software bridges br-net1/2/3 (port: []) — no VM MAC leaves eno2/the physical switch, no TOS risk. Variant B (on-premises, trunk port) is relevant only with your own switch.
purely internal software bridges br-net1/br-net2 (port: []) — no VM MAC leaves the node
UserDefinedNetwork with Layer2 topology is a pure overlay (encapsulated Geneve tunnel within OVN-K) — explicitly NOT localnet, so no VM MAC leaves the node.
⚠️ DEDICATED NAMESPACE REQUIRED: see NOTE below.
2 Pools: internal-pool binds to br-net1 — external-pool binds to eno2, requires a 2nd public IP
external-pool uses a provider-registered additional IP (e.g. Hetzner Additional IP); MetalLB speaker announces with the node's own MAC.
⚠️ SHARED RESOURCE: external-pool currently has only ONE IP — Clean up after this test (delete vm-ssh-lb) before starting TC-HCP-002
Make VMs reachable via a real, externally accessible IP directly (like a physical server) — no port-forward, no NodePort with random port. Requires a second IP (external-pool from PRE-09); if not yet delivered, use the NodePort variant further below.
Confirm these before running steps:
- TC-MLB-001Verify MetalLB Basic Functionality
- TC-VM-001Create and boot first VM from template (RHEL 9)
- For external test: second Hetzner Additional IP delivered (otherwise NodePort fallback, see Commands / YAML tab)
1Verify prerequisite: VM test-vm-rhel9 running and MetalLB works (TC-MLB-001 green)
oc get vmi test-vm-rhel9 -n vmtestoc get pods -n metallb-system2Check which pool is currently available
oc get ipaddresspool -n metallb-system4Wait for assigned EXTERNAL-IP and note it
watch oc get svc vm-ssh-lb -n vmtest5Test SSH directly via the assigned IP (no NodePort, no tunnel) — with the SSH key, as the golden image has no password set
ssh -i ~/.ssh/ocp-vm-key cloud-user@<EXTERNAL-IP>6Verify IP stability after a VM restart (important for production!)
virtctl restart test-vm-rhel9 -n vmtestwatch oc get vmi test-vm-rhel9 -n vmtestoc get svc vm-ssh-lb -n vmtest7Connect via SSH again to confirm the service is reachable after restart
ssh -i ~/.ssh/ocp-vm-key cloud-user@<EXTERNAL-IP>8Test NodePort fallback
ssh -i ~/.ssh/ocp-vm-key -p 30022 cloud-user@<EXTERNAL-IP>9⚠️ Do NOT forget cleanup — external-pool has only ONE IP, also required by TC-HCP-002 (hosted cluster API endpoint). Without cleanup, MetalLB later silently falls back to internal-pool there (no error, but the IP is then not externally reachable)
oc delete svc vm-ssh-lb -n vmtestoc delete svc vm-ssh-nodeport -n vmtest⚠️ NOT usable by default on the current SNO cluster: there is no customer-controlled router in the path for peering. Left for documentation purposes and future tests.
L2Advertisement explicitly binds to br-net1/br-net2 — ARP announcements stay node-internal.
Single-NIC OK — HyperShift pods use the OVN-K pod network.
⚠️ Check Pod/Node Capacity before starting TC-HCP-002 — see steps below.
⚠️ SNO EXAMPLE INSTALLATION: --control-plane-availability-policy SingleReplica is mandatory on a single-node cluster.
⚠️ Be sure enough compute resources are available on the SNO node before starting this test.
Import over OVN-K — bandwidth is shared with OCP traffic on eno2/br-ex in this cluster