From KVM

Contents 1 Adding New Step Files 1.1 Example using Fedora 8 i386 version 1.2 Install options 1.3 Other Notes

Adding New Step Files

This is a general outline for creating step files on KVM autotest. Note that the preferred default guest install method is unattended install.

• Add a section to your kvm_tests.cfg file for the new guest. See the test configuration file format for additional details on setup of the kvm_tests.cfg file.
• Get a new iso OS install image for your new guest.
• generate an md5sum and md5sum_1m value for the iso image using standard md5sum command and the cdhash.py script in the kvm test dir
• Add the line 'type=stepmaker' to the install section of your tests_base.cfg entry
• Add the line 'only <your guest heading>' to the end of the tests_base.cfg.
• Comment out any other 'only' options
• Run your control file normally
• This should spawn the stepmaker UI. Execute the install using stepmaker. For details on stepmaker, see Working with Step Files
• Install should run go through initial install options, installing OS, and first boot options. Final step captured should be shutdown of the VM.
• After install, remove the 'type=stepmaker' line from the kvm_tests.cfg file.
• Adjust your 'only' settings so that your selection of tests will run. See the test configuration file format for details on selecting tests.

Example using Fedora 8 i386 version

• This already exists in the kvm_tests.cfg.sample file:

         variants:
           - Fedora:
               no setup
               ssh_prompt = "\[root@.{0,50}][\#\$] "

               variants:
                   - 8.32:
                       no setup
                       image_name = fc8-32
                       install:
                           steps = Fedora-8-i386.steps
                           cdrom = linux/Fedora-8-i386-DVD.iso
                           md5sum = dd6c79fddfff36d409d02242e7b10189
                           md5sum_1m = dabae451bb69fbbad0e505b25144b1f9

• If you were creating the steps file yourself, you add this:

         variants:
           - Fedora:
               no setup
               ssh_prompt = "\[root@.{0,50}][\#\$] "

               variants:
                   - 8.32:
                       no setup
                       image_name = fc8-32
                       install:
                           type = steps
                           steps = Fedora-8-i386.steps
                           cdrom = linux/Fedora-8-i386-DVD.iso
                           md5sum = dd6c79fddfff36d409d02242e7b10189
                           md5sum_1m = dabae451bb69fbbad0e505b25144b1f9

• At the end of the file, add

 only Fedora.8.32

• After your recording is complete, remove the 'type = steps' line and 'only Fedora.8.32' line.

• You should now have a <kvm>/steps/Fedora-8-i386.steps file.

Install options

• type = stepmaker: tells kvm-autotest to create the steps file
• steps = <filename>: defines the name of the steps file to be created/used when running this guest
• cdrom = <iso>: location of the iso image for this guest
• md5sum = <value>: value of md5sum <iso>
• md5sum_1m = <value>: value of md5sum of first 1 MB of iso image. This is caluculated using the calc_md5sum_1m.py script.
• name = value: define a variable to be used in the steps file. This can be used for things like CD Keys. Accessed using $name in stepmaker. See Working with Step Files for details

Other Notes

• ISO Images: Some OS's don't come in one handy DVD iso. RHEL 3 is an example of this. There is a handy script for Red Hat like distributions.

           RHEL ISO Instructions