From Fedora Project Wiki

(Create page)
 
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{QA/Test_Case
 
{{QA/Test_Case
 
|description=
 
|description=
Install a Fedora VM from PXE.
+
Import an existing VM disk image.
  
 
|setup=
 
|setup=
{{admon/note | Setting up PXE is outside the scope of this test case. |  If you don't have a pre-existing PXE setup, please skip this test. }}
+
Initial test day setup, a pre-existing VM image.
Initial test day setup, a pre-existing PXE setup. Either a specially configured virtual network or host bridge device is required for guests to PXE boot.
 
  
 
|actions=
 
|actions=
 +
 +
=== Ready your disk image ===
 +
 +
==== Personal pre-existing disk image ====
 +
For this test we want to be sure that all sorts of disk images will import and run correctly, so please consider using any existing disk image you have.
 +
 +
==== Fedora cloud image ====
 +
If you don't have an existing disk image, but still want to run the test, you can use a Fedora cloud image
 +
 +
* Install virt-customize with: <code>dnf install libguestfs-tools-c</code>
 +
* <code>wget https://kojipkgs.fedoraproject.org/compose/branched/Fedora-29-20180910.n.0/compose/Cloud/x86_64/images/Fedora-Cloud-Base-29-20180910.n.0.x86_64.qcow2</code>
 +
* Set the root password to '123456' with: <code> virt-customize --add Fedora-Cloud-Base-29-20180910.n.0.x86_64.qcow2 --root-password password:123456</code>
 +
** This is not secure, but should be fine for test purposes.
 +
* Disable cloud-init, since it hangs waiting for input: <code> virt-customize --add Fedora-Cloud-Base-29-20180910.n.0.x86_64.qcow2 --run-command "systemctl mask cloud-init.service" </code>
 +
 +
==== virt-builder pre-installed image ====
 +
virt-builder is a new tool that can download pre-installed minimal images for a variety of distros.
 +
 +
* Install virt-builder with: <code>yum install libguestfs-tools-c</code>
 +
* Use <code>virt-builder --list</code> to see the available distro images. We will use fedora-28
 +
* Download the image and set the root password to '123456': <code>virt-builder fedora-28 --root-password password:123456</code>
  
 
=== virt-manager ===
 
=== virt-manager ===
 +
 +
{{admon/note | No Fedora 29 os selection is available, please use the Fedora 28 option}}
 +
 
# Run virt-manager (should autoconnect to qemu)
 
# Run virt-manager (should autoconnect to qemu)
 
# Launch the 'New VM' wizard
 
# Launch the 'New VM' wizard
# Choose the 'PXE' option
+
# Choose the 'Import' option
 +
# Browse to the existing VM image.
 
# Make sure to enter a valid OS type, it's important for performance defaults.
 
# Make sure to enter a valid OS type, it's important for performance defaults.
 
# Proceed with through the wizard, using the default suggested values.
 
# Proceed with through the wizard, using the default suggested values.
 
# On the final page, use the VM name: test-day-vm
 
# On the final page, use the VM name: test-day-vm
# Ensure there are no network warnings on the final page. Choose the appropriate network device for PXE booting.
+
# Finish the install, verify your VM boots as expected. Depending on the OS and content of the image, additional devices may need to be configured in the 'customize before install' step.
# Start the install, and perform the install as you would on a normal machine.
 
  
 
=== virt-install ===
 
=== virt-install ===
  
 
An example virt-install invocation looks like
 
An example virt-install invocation looks like
 
+
  $> virt-install --name test-day-vm --ram 2048 \
+
sudo virt-install --name test-day-vm --ram 2048 \
         --disk path=/var/lib/libvirt/images/test-day-vm.img,size=10 \
+
         --disk /path/to/my/existing/vm/disk.img \
         --os-variant fedora20 \
+
         --os-variant fedora28 \
         --pxe
+
         --import
  
 
|results=
 
|results=

Latest revision as of 17:49, 10 September 2018

Description

Import an existing VM disk image.

Setup

Initial test day setup, a pre-existing VM image.

How to test

Ready your disk image

Personal pre-existing disk image

For this test we want to be sure that all sorts of disk images will import and run correctly, so please consider using any existing disk image you have.

Fedora cloud image

If you don't have an existing disk image, but still want to run the test, you can use a Fedora cloud image

virt-builder pre-installed image

virt-builder is a new tool that can download pre-installed minimal images for a variety of distros.

  • Install virt-builder with: yum install libguestfs-tools-c
  • Use virt-builder --list to see the available distro images. We will use fedora-28
  • Download the image and set the root password to '123456': virt-builder fedora-28 --root-password password:123456

virt-manager

Note.png
No Fedora 29 os selection is available, please use the Fedora 28 option
  1. Run virt-manager (should autoconnect to qemu)
  2. Launch the 'New VM' wizard
  3. Choose the 'Import' option
  4. Browse to the existing VM image.
  5. Make sure to enter a valid OS type, it's important for performance defaults.
  6. Proceed with through the wizard, using the default suggested values.
  7. On the final page, use the VM name: test-day-vm
  8. Finish the install, verify your VM boots as expected. Depending on the OS and content of the image, additional devices may need to be configured in the 'customize before install' step.

virt-install

An example virt-install invocation looks like

sudo virt-install --name test-day-vm --ram 2048 \
        --disk /path/to/my/existing/vm/disk.img \
        --os-variant fedora28 \
        --import

Expected Results

Guest installations start and perform without any issues. Guest is bootable after install completes.