QA:Testcase Kickstart File Path Ks Cfg

From FedoraProject

Jump to: navigation, search
Associated release criterion
This test case is associated with the Fedora_24_Beta_Release_Criteria#kickstart-delivery release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.



This test will verify that anaconda can load a kickstart file from a file:// path. This is a typical case for when the kickstart file is located in the initrd.img.


  1. Prepare a valid kickstart file.
    • You can use an example kickstart available from QA:Testcase Kickstart Http Server Ks Cfg.
    • If you want to create your own kickstart, you can examine the file /root/anaconda-ks.cfg on a previously installed system. This file contains the kickstart instructions used to install that system. For additional guidance on kickstart syntax, see Anaconda/Kickstart.

How to test

  1. You need to place your kickstart file inside the ramdisk. You can either use --initrd-inject option of Package-x-generic-16.pngvirt-install tool, or do that manually:
    • Option #1 - using virt-install: Use --initrd-inject <kickstart> and --extra-args "inst.ks=file:/<kickstart>" command line arguments. An example command would look like this (you need to change the location at least):
      virt-install --name FedoraTest --ram 1500 --disk pool=default,size=10 --location --initrd-inject ks.cfg --extra-args "inst.ks=file:/ks.cfg"
    • Option #2 - modifying ramdisk manually:
      1. Download the installer initial ramdisk. The ramdisk is typically called images/pxeboot/initrd.img
      2. Place the kickstart file into the root directory of the installer initial ramdisk using the cpio command.
        echo ks.cfg | cpio -c -o >> initrd.img
      3. Boot into the installer kernel (vmlinuz) and the modified initial ramdisk (initrd.img) using any available means (PXE, virt-install, virt-manager, etc)
      4. At the bootloader prompt, provide a location for the kickstart file at the boot prompt. Using the example above:

        You also need to provide stage2= boot option for Anaconda to start correctly.

Expected Results

  1. The ks.cfg should be appended to the initrd. The file presence is not shown by lsinitrd (it can't display concatenated images). If you need to debug whether the file was included, boot the machine with rd.break=cmdline kernel command line argument and use shell to confirm the presence of ks.cfg.
  2. The installer successfully initiates a kickstart install in accordance with the instructions supplied by the ks.cfg file included in the initial ramdisk. To ensure the kickstart file is properly loaded, inspect the anaconda.log for a lines similar to the following:
    INFO anaconda: Parsing kickstart: /run/install/ks.cfg
    /run/install/ks.cfg should contain your kickstart file
  3. The installer should honor the kickstart commands provided in the ks.cfg file
  4. If sufficient commands are provided to fully automate an installation, the installer must not prompt for user input.