From ccc614e4c9a87be0caab9416a14b3d970b2a28f1 Mon Sep 17 00:00:00 2001 From: Ayo Kayode Date: Tue, 21 Oct 2025 17:28:11 +0100 Subject: [PATCH] verify creation of test VMs during testenv setup Added verification check to ensure that test virtual machines are successfully created during the setup of the Bifrost test environment. This helps confirm that the test environment is properly configured and that the VM creation process runs as expected. Change-Id: Ia479aff9a435d72aea7885faa6b55542ce8fd199 Signed-off-by: Ayo Kayode --- doc/source/user/troubleshooting.rst | 33 +++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/doc/source/user/troubleshooting.rst b/doc/source/user/troubleshooting.rst index f8306b23..1d461719 100644 --- a/doc/source/user/troubleshooting.rst +++ b/doc/source/user/troubleshooting.rst @@ -166,6 +166,39 @@ DIB-based or any other IPA image, you will need to take the following steps: directly replaced on disk. The default where the kernel and ramdisk are located is in ``/httboot/``. +****************************************************** +Verifying Creation of Test Virtual Machines (VMs) +****************************************************** + +When using the Bifrost test environment, the ``./bifrost-cli testenv`` command +is expected to automatically create two virtual machines (VMs) for testing +purposes. These VMs simulate baremetal systems that Ironic can enroll and +deploy during provisioning. If the virtual machines are not created, subsequent +commands such as ``enroll`` or ``deploy`` will fail with errors indicating that +no nodes are available for registration. + +Check for the presence of the test VMs using the following commands + +.. code-block:: bash + + virsh list --all + +If the setup is successful, two VMs (for example, ``testvm1`` and ``testvm2``) +should appear in the list. If no VMs are listed, the test environment creation +was incomplete. This is often caused by insufficient host resources or issues +with the virtualization service (libvirt/KVM). + +Each test VM typically uses the following default resources: + +* 1 vCPU +* ~3 GB of RAM +* ~11 GB of virtual storage + +If the test VMs are not created, Ironic will not have real instances to +interact with, and only placeholder nodes will exist in the database. +As a result, any attempt to deploy will fail. Always verify that the test +VMs exist before proceeding with node enrollment and deployment. + *********************************************************** Node Enrollment and Provisioning in a Testing Environment ***********************************************************