From Fedora Project Wiki

Initial setup

  • Prepare installation media available at {URL} according to instructions from Installation Guide
  • Optionally install virtualization support in Fedora:
# yum -y install @virtualization
# service libvirtd start
# cp $FEDORA_ISO /var/lib/libvirt/images/Fedora.iso
  • To start virtual machine you can use this command:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso
  • You can destroy virtual machine right after execution of a test case with these commands:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Installation on bios/firmware RAID

Setup

Important.png
Bare metal required
This can not be run in virtual machine
  1. You need a machine with bios/firmware RAID supported by dmraid or MD. Linux MD driver supports Intel Matrix RAID technology, dmraid supports following products:
    • asr  : Adaptec HostRAID ASR (0,1,10)
    • ddf1  : SNIA DDF1 (0,1,4,5,linear)
    • hpt37x  : Highpoint HPT37X (S,0,1,10,01)
    • hpt45x  : Highpoint HPT45X (S,0,1,10)
    • isw  : Intel Software RAID (0,1,5,01)
    • jmicron : JMicron ATARAID (S,0,1)
    • lsi  : LSI Logic MegaRAID (0,1,10)
    • nvidia  : NVidia RAID (S,0,1,10,5)
    • pdc  : Promise FastTrack (S,0,1,10)
    • sil  : Silicon Image(tm) Medley(tm) (0,1,10)
    • via  : VIA Software RAID (S,0,1,10)
    • dos  : DOS partitions on SW RAIDs
  2. you need multiple hard drives connected to controller supporting RAID setup,
  3. setup arbitary RAID level in your firmware.

Action

  1. Boot the installation media on prepared machine,
  2. finish the installation by choosing default options.

Expected Results

  1. Installation starts up properly,
  2. RAID device is recognized and used,
  3. system is installed without issue, it boots up,
  4. system is installed on RAID and not underlying devices.

Cleanup

N/A

Installation on iSCSI

Setup

Important.png
Additional computer required
This test case requires test machine and another computer providing necessary services
Note.png
The other iSCSI targets
This document describes, how to work with sw iSCSI target on Fedora with scsi-target-utils package. If you managed hw target for testing or if you are using different tools for sw targets, hopefully you are also able to control it.
Important.png
Firewall settings
Ensure, port 3260 is available for incoming connection and there is no blocking firewall in the way between target and test machine.
Note.png
Hint
You can setup iSCSI target on the physical host where you are running your virtual machines
  • Setup iSCSI target (server providing iSCSI drive). To run software iSCSI target on Fedora run following commands:
# dd if=/dev/zero of=/tmp/disk bs=1M seek=8000 count=1
# losetup /dev/loop0 /tmp/disk
# yum -y install scsi-target-utils
# service tgtd start
# tgtadm --lld iscsi --op new --mode target --tid=1 --targetname iqn.2009-02.com.example:for.all
# tgtadm --lld iscsi --op new --mode logicalunit --tid 1 --lun 1 -b /dev/loop0
# tgtadm --lld iscsi --op bind --mode target --tid 1 -I ALL
  • note the IP address of machine hosting the iSCSI target,
  • run the installation on bare metal or virtual machine,
    • To start virtual machine you can use this command:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images

Action

  1. In INSTALLATION DESTINATION select review/modify click Add a disk button,
  2. press Add iSCSI Target button on next screen,
  3. put IP address of machine hosting the prepared iSCSI target and finish the procedure,
  4. ensure the iSCSI disk as well as local hard drive is selected for installation,
  5. select review/modify choice for partitioning,
  6. create / mountpoint, place it on iSCSI target,
  7. create /boot mountpoint, place it on local disk,
  8. create all other necessary partitions,
  9. complete the installation and reboot the system.

Expected Results

  1. iSCSI target is added and used for installation,
  2. mountpoints can be assigned to patitions/logical volumes placed on iSCSI disk,
  3. installation is finished and system starts up,
  4. iSCSI is initialized during boot and all filesystems are mounted,
  5. filesystem layout is in accordance with setup in the installer.

Default LVM with encryption

Setup

  1. Run the installation on bare metal or virtual machine.
    • To start virtual machine, run:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso

Action

  1. In INSTALLATION DESTINATION choose automatic layout with LVM,
  2. select encryption and put passphrase,
  3. complete the installation.

Expected Results

  1. Default partitioning layout is created,
  2. partitions are encrypted,
  3. installer asks for passphrase,
  4. system requests passphrase during boot,
  5. systems starts without issue with passphrase.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Reuse /home on LVM

Setup

Important.png
Preliminary installation required
  • Do an installation with separate /home partition placed on LVM logical volume.
    • To start virtual machine, run:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso
  • start up installed system, store some data in /home
  • change the boot order to boot up again from installation media,
  • start the installation again.

Action

  1. Select review/modify choice partitioning in INSTALLATION DESTINATION,
  2. assign existing home logical volume to /home mount point, do not format partition,
  3. create & assign other required mount points (/, /boot, ...), complete the partitioning,
  4. complete the installation and start up installed system.

Expected Results

  1. Existing home logical volume is visible in installer,
  2. it is possible to assign mount point to this volume,
  3. it is possible to disable formatting,
  4. installation is completed,
  5. systems starts up,
  6. data in /home partition still exist.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

More disks

Setup

Important.png
Multiple hard drives required
You need a machine with more than 1 disks
  1. Run the installation on machine including more than 1 hard drives
    • For testing in virtual machine run:
# virt-install --accelerate -n test-machine101 -r 1024 --disk /var/lib/libvirt/images/test-machine101.img,device=disk,bus=virtio,size=21 --disk /var/lib/libvirt/images/additional-disk101,device=disk,bus=virtio,size=10 -c /var/lib/libvirt/images/Fedora.iso

Action

  1. In INSTALLATION DESTINATION select all available disks,
  2. use partitioning layout which utilizes all the disks, custom partitioning or automatic LVM should work,
  3. complete the installation in setup of own choice.

Expected Results

  1. All disks are visible in installer,
  2. all disks can be selected,
  3. all disks are used for installation,
  4. installation is finished without issue,
  5. system starts up properly,
  6. all filesystems are present with accordance to setup in installer.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Separate mountpoints

Setup

  1. Run the installation on bare metal or virtual machine.
    • To start virtual machine, run:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso

Action

  1. In INSTALLATION DESTINATION choose review/modify choice for partitioning
  2. Create following layout:
    • create /boot,
    • create /, use encryption for it,
    • create /usr,
    • create /home, use encryption for it,
    • create /var,
    • create swap, use encryption for it,
  3. complete the installation and start the system.

Expected Results

  1. Defined disk layout is created,
  2. installer asks for a passphrase,
  3. installation is completed,
  4. installed systems starts and asks for a passphrase to unlock encrypted disks,
  5. login is possible,
  6. disk layout on installed system is in accordance with installation setup, all filesystems are mounted, swap is enabled.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Reuse existing VG

Important.png
Preliminary installation required

Setup

  • Do an installation with custom partitioning layout:
    • create / placed on LVM logical volume,
    • create /boot on raw partition,
    • keep some free space on underlaying hard drive(s),
    • keep some free space in LVM volume group,
    • To start virtual machine, run:
# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso
  • complete the installation,
  • change the boot order to boot up again from installation media,
  • start the installation again.

Action

  1. In INSTALLATION DESTINATION select review/modify choice,
  2. do not format or delete existing LVM logical volumes,
  3. create / as LVM logical volume placed in already existing volume group,
  4. create additional partitions/mount points if necessary (e.g. /boot, /usr),
  5. optionally assign mount point to existing LVM logical volumes,

Expected Results

  1. It is possible to reuse free space in already existing LVM volume group,
  2. installation is finished,
  3. system starts up properly,
  4. filesystem layout is in accordance with setup in installer,
  5. unmodified LVM logical volumes are preserved including the content.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

LVM on top of sw RAID

Setup

Important.png
Multiple hard drives required
You need a machine with more than 1 disks
  1. Run the installation on machine including more than 1 hard drives
    • For testing in virtual machine run:
# virt-install --accelerate -n test-machine101 -r 1024 --disk /var/lib/libvirt/images/test-machine101.img,device=disk,bus=virtio,size=21 --disk /var/lib/libvirt/images/additional-disk101,device=disk,bus=virtio,size=21 -c /var/lib/libvirt/images/Fedora.iso


Action

  1. In INSTALLATION DESTINATION choose review/modify choice for partitioning,
  2. create / which is placed on LVM logical volume,
  3. physical volume of the volume group including / has to be software RAID /dev/md{N} device with level of your own choice with accordance to available hard drives,
  4. create other mountpoints/partitions if necessary (/boot, /usr, ...)
  5. complete the installation and start up the system.

Expected Results

  1. Requested filesystem layout is created,
  2. installation is finished,
  3. systems starts up properly,
  4. filesystem layout of the system is in accordance with setup in installer.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Reuse encrypted partitions

Setup

Important.png
Preliminary installation required
  1. Do an installation with custom partitioning layout:
    • create /, use encryption for it,
    • create /home, use encryption for it,
    • create any other partition/mountpoint if necessary (/boot, /usr ...)
  2. complete the installation, reboot system,
  3. put some data to /home,
  4. reboot the system and change boot order to boot from installation media,
  5. start installation again.

To start virtual machine, run:

# virt-install --accelerate -n test-machine101 -r 1024 -f /var/lib/libvirt/images/test-machine101.img -s 21 -c /var/lib/libvirt/images/Fedora.iso

Action

  1. In INSTALLATION DESTINATION select review/modify choice,
  2. enter correct passphrase if you are asked for it,
  3. reuse partition formerly created as / for new / again, reformat it,
  4. assign /home mountpoint to partition formerly created for /home, do not reformat it,
  5. create any additional mountpoint/partition if necessary (/usr, /boot ...)
  6. finish the installation and reboot the system.

Expected Results

  1. It is possible to reuse encrypted partitions,
  2. installation is finished,
  3. system starts up without issue,
  4. passphrase for encrypted disks is requested during boot,
  5. data in /home are preserved,
  6. filesystem layout is in accordance to setup in installer.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101

Search for specific device

Setup

Action

Expected Results

Cleanup

Select all disks

Setup

Action

Expected Results

Cleanup

Create multiple VGs

Setup

Important.png
Multiple hard drives required
You need a machine with more than 1 disks
  1. Run the installation on machine including more than 1 hard drives
    • For testing in virtual machine run:
# virt-install --accelerate -n test-machine101 -r 1024 --disk /var/lib/libvirt/images/test-machine101.img,device=disk,bus=virtio,size=21 --disk /var/lib/libvirt/images/additional-disk101,device=disk,bus=virtio,size=21 -c /var/lib/libvirt/images/Fedora.iso

Action

  1. In INSTALLATION DESTINATION choose review/modify choice for partitioning, create following partitioning layout:
  2. create / mountpoint
    • it is placed on LVM logical volume,
    • logical volume is part of LVM volume group called System,
    • just one drive is assigned to volume group System,
  3. create /srv mountpoint:
    • it is placed on LVM logical volume,
    • logical volume is part of LVM volume group called Data,
    • the second one hard drive is assigned to volume group Data,
  4. create all other necessary partitions/mountpoints (/boot, /usr, ...),
  5. complete the installation and reboot system.

Expected Results

  1. It is possible to create two volume groups,
  2. it is possible to assign chosen hard drive to volume group,
  3. it is possible to create logical volumes in all volume groups and assign mountpoints,
  4. installation is completed, installed system starts up without issue,
  5. filesystem layout is in accordance with setup in the installer.

Cleanup

  1. To destroy virtual machine run:
# virsh destroy test-machine101
# virsh undefine --remove-all-storage test-machine101