----- "Lucas Meneghel Rodrigues" <l...@redhat.com> wrote: > In order to make it easier to get started with KVM > testing, add a script that helps with setting up > directories, paths and iso files for the default > test configuration (Fedora 12 guest install, boot > test, shutdown). Once the first idea of how things > work is formed, one may start to tinker with > configuration files. > > Added pointers to the online documentation. > > Signed-off-by: Lucas Meneghel Rodrigues <l...@redhat.com> > --- > client/tests/kvm/README | 19 +++++++- > client/tests/kvm/get_started.py | 103 > +++++++++++++++++++++++++++++++++++++++ > 2 files changed, 121 insertions(+), 1 deletions(-) > create mode 100755 client/tests/kvm/get_started.py > > diff --git a/client/tests/kvm/README b/client/tests/kvm/README > index 88d2c15..628f3d9 100644 > --- a/client/tests/kvm/README > +++ b/client/tests/kvm/README > @@ -1,3 +1,20 @@ > -In order to get started, please refer to the online documentation: > +For the impatient: > + > +Execute the get_started.py script located on this directory, > +that will guide you through setting up the default kvm test > +scenario: > + > + * Guest install with Fedora 12 > + * Boot, reboot and shutdown test > + > +The script will help you to create all the directories, and > +even get the OS iso in case you don't have it yet. > + > +For the not so impatient: > + > +You are *strongly* advised to read the online docs: > > http://www.linux-kvm.org/page/KVM-Autotest/Client_Install > + > +So you can have a better idea of how the test is organized > +and how it works. > diff --git a/client/tests/kvm/get_started.py > b/client/tests/kvm/get_started.py > new file mode 100755 > index 0000000..51d98f0 > --- /dev/null > +++ b/client/tests/kvm/get_started.py > @@ -0,0 +1,103 @@ > +#!/usr/bin/python > +""" > +Program to help setup kvm test environment > + > +...@copyright: Red Hat 2010 > +""" > + > +import os, sys, optparse, logging, shutil > +import common, kvm_utils > +from autotest_lib.client.common_lib import logging_manager > +from autotest_lib.client.bin import utils, os_dep > + > + > +if __name__ == "__main__": > + logging_manager.configure_logging(kvm_utils.KvmLoggingConfig(), > + verbose=True) > + logging.info("KVM test config helper") > + > + logging.info("1 - Verifying directories (check if the directory > structure " > + "expected by the default test config is there)") > + base_dir = "/tmp/kvm_autotest_root" > + sub_dir_list = ["images", "isos", "steps_data"] > + for sub_dir in sub_dir_list: > + sub_dir_path = os.path.join(base_dir, sub_dir) > + if not os.path.isdir(sub_dir_path): > + logging.debug("Creating %s", sub_dir_path) > + os.makedirs(sub_dir_path) > + else: > + logging.debug("Dir %s exists, not creating" % > + sub_dir_path) > + logging.info("Do you want to setup NFS mounts for some of those > " > + "dirs? (y/n)") > + setup_nfs = raw_input() > + if setup_nfs == 'y': > + logging.info("Exiting the script so you can setup the NFS > mounts. " > + "When you are done, re-run this script.") > + sys.exit(0) > + > + logging.info("2 - Creating config files from samples (copy the > default " > + "config samples to actual config files)") > + kvm_test_dir = os.path.dirname(sys.modules[__name__].__file__) > + kvm_test_dir = os.path.abspath(kvm_test_dir) > + config_file_list = ["address_pools.cfg", "build.cfg", > "cdkeys.cfg", > + "tests_base.cfg", "tests.cfg"] > + for config_file in config_file_list: > + src_file = os.path.join(kvm_test_dir, "%s.sample" % > config_file) > + dst_file = os.path.join(kvm_test_dir, config_file) > + if not os.path.isfile(dst_file): > + logging.debug("Creating config file %s from sample", > dst_file) > + shutil.copyfile(src_file, dst_file) > + else: > + logging.debug("Config file %s exists, not touching" % > dst_file) > + > + logging.info("3 - Verifying iso (make sure we have the OS iso > needed for " > + "the default test set)") > + base_iso_name = "Fedora-12-x86_64-DVD.iso" > + fedora_dir = "pub/fedora/linux/releases/12/Fedora/x86_64/iso" > + url = os.path.join("http://download.fedoraproject.org/", > fedora_dir, > + base_iso_name) > + md5sum = "6dd31e292cc2eb1140544e9b1ba61c56" > + iso_dir = os.path.join(base_dir, 'images', 'linux') > + if not iso_dir: > + os.makedirs(iso_dir) > + iso_path = os.path.join(iso_dir, base_iso_name) > + if not os.path.isfile(iso_path) or ( > + kvm_utils.hash_file(iso_path, method="md5") != > md5sum): > + logging.warning("%s not found or corrupted", iso_path) > + logging.warning("Would you like to download it? (y/n)") > + iso_download = raw_input() > + if iso_download == 'y': > + kvm_utils.unmap_url_cache(iso_dir, url, md5sum) > + else: > + logging.warning("Missing file %s. Please download it" % > iso_path) > + else: > + logging.debug("%s present, with proper checksum") > + > + logging.info("4 - Checking if qemu is installed (certify qemu and > qemu-kvm " > + "are in the place the default config expects)") > + qemu_default_paths = ['/usr/bin/qemu-kvm', '/usr/bin/qemu-img'] > + for qemu_path in qemu_default_paths: > + if not os.path.isfile(qemu_path): > + logging.warning("No %s found. You might need to install > qemu-kvm.") > + else: > + logging.debug("%s present" % qemu_path) > + > + logging.info("5 - Checking for the KVM module (make sure kvm is > loaded " > + "to accelerate qemu-kvm)") > + if not utils.module_is_loaded("kvm"): > + logging.warning("KVM module is not loaded. You might want to > load it") > + else: > + logging.debug("KVM module loaded") > + > + logging.info("6 - Verify needed packages to get started") > + logging.info("Please take a look at the online documentation " > + > "http://www.linux-kvm.org/page/KVM-Autotest/Client_Install " > + "(session 'Install Prerequisite packages')")
Typo: I think you meant section. Maybe we should also print a message telling users to edit tests.cfg to suit their needs. I'm not sure the online docs say that anywhere. There's a config file tutorial, but it's very general and doesn't discuss tests.cfg. > + > + client_dir = os.path.abspath(os.path.join(kvm_test_dir, "..", > "..")) > + autotest_bin = os.path.join(client_dir, 'bin', 'autotest') > + control_file = os.path.join(kvm_test_dir, 'control') > + logging.info("When you are done fixing eventual warnings found, > " > + "you can run the kvm test using the command line:") > + logging.info("%s --verbose %s", autotest_bin, control_file) > -- > 1.6.6 > > -- > To unsubscribe from this list: send the line "unsubscribe kvm" in > the body of a message to majord...@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html -- To unsubscribe from this list: send the line "unsubscribe kvm" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html