Skip to content

Latest commit

 

History

History
51 lines (40 loc) · 2.34 KB

kvm-quickstart.md

File metadata and controls

51 lines (40 loc) · 2.34 KB
Raw

Quick start instructions for kvm-xfstests

  1. Make sure qemu with kvm support is installed on your system.

    apt-get install qemu-kvm

  2. Run the following commands to install the xfstests-bld repository and download a pre-compiled test appliance image. We use the 32-bit test appliance here since it can support both 32-bit and 64-bit kernels.

    git clone git://git.kernel.org/pub/scm/fs/ext2/xfstests-bld.git fstests
cd fstests/kvm-xfstests
wget -O test_appliance/root_fs.img https://www.kernel.org/pub/linux/kernel/people/tytso/kvm-xfstests/root_fs.img.i386

  3. Build a kernel with all of the necessary drivers for kvm built into the kernel. No modules should be used, since kvm-xfstests will run the kernel directly from the build tree. This means that there is no need to install any modules or create an initrd, which significantly speeds up the edit, compile, test, debug development cycle. There are sample 32-bit and 64-bit kernels in the kernel-configs directory; pick one whose version number is close to the kernel version you wish to build.

  4. In the fstests/kvm-xfstests directory, take a look at the "config" file and either edit that file in place, or (this is preferred) put override values in ~/.config/kvm-xfstests or config.custom. The most common values you will likely need to override is the location of the compiled kernel and the preferred timezone if you wish the log files to display times in your local timezone.

    TZ=America/New_York
KERNEL=/build/ext4/arch/x86/boot/bzImage

  5. In the top-level directory of your checked out xfstests-bld repository, run "make kvm-xfstests.sh" and then copy this generated file to a directory which is your shell's PATH. This allows you to run the kvm-xfstests binary without needing to set the working directory to the kvm-xfstests directory.

    cd fstests
make kvm-xfstests.sh
cp kvm-xfstests.sh ~/bin/kvm-xfstests

  6. Run "kvm-xfstests smoke" to do a quick test. Or "kvm-xfstests -g auto" to do a full test. You can also run specific tests on specific configurations, i.e., "kvm-xfstests -c bigalloc generic/013 generic/127". To run a shell, use "kvm-xfstests shell"

For more information, please see the full kvm-xfstests documentation.