NAME

Tapper::TestSuite::AutoTest - Tapper - Complete OS testing in a box via autotest

SYNOPSIS

You most likely want to run the frontend cmdline tool like this

• Run an autotest subtest and report results to Tapper:

    $ tapper-testsuite-autotest -t hackbench

• Run multiple autotest subtests and report results to Tapper:

    $ tapper-testsuite-autotest -t hackbench -t hwclock

DESCRIPTION

This module wraps autotest to make its (sub) tests available for Tapper.

The commandline tool simply calls the single steps like this:

    use Tapper::TestSuite::AutoTest;

    my $wrapper = Tapper::TestSuite::AutoTest->new();
    my $args    = $wrapper->parse_args();
    $args       = $wrapper->install($args);
    $args       = $wrapper->run($args);

The reporting evaluates several environment variables:

  TAPPER_REPORT_SERVER
  TAPPER_REPORT_API_PORT
  TAPPER_REPORT_PORT
  TAPPER_TESTRUN
  TAPPER_REPORT_GROUP

with some sensible defaults. They are automatically provided when using Tapper automation.

In case you run it manually the most important variable is TAPPER_REPORT_SERVER pointing to your central Tapper server.

See the Tapper manual for more details.

FUNCTIONS

makedir

Checks whether a given directory exists and creates it if not.

@param string - directory to create

@return success - 0 @return error - error string

$self->log_and_system(@args)

Log and do a multi arg system().

$self->log_and_system_shell(@args)

Log and do a single arg system().

copy_client

Move the client to where it belongs.

@param string - download directory @param string - target directory

@return die() in case of error

install

Install the autotest framework from a given source into a given target

@param hash ref - args

@return hash ref - args

report_away

Send the actual report to reports receiver framework.

@param hash ref - args

@return success - int - report id @return error - die()

upload_files

Upload the stats file to reports framework.

@param int - report id @param hash ref - args

get_machine_name

Return hostname for metainfo in typical Tapper notation, i.e., just the hostname (without FQDN) in host context or host:guest (colon separated) in guest context.

send_results

Send the test results to Tapper.

@param hash ref - args

@return hash ref - args

autotest_meta

Add meta information from files generated by autotest.

@param hash ref - args

@return string - Tapper TAP metainfo headers

print_help

Print help and die.

parse_args

Parse command line arguments and Tapper ENV variables.

@return hash ref - args

run

Run the requested autotest test(s), collect their results and report them.

@param hash ref - args

@return hash ref - args

AUTHOR

AMD OSRC Tapper Team <tapper@amd64.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Advanced Micro Devices, Inc..

This is free software, licensed under:

  The (two-clause) FreeBSD License

cpanm Tapper::TestSuite::AutoTest

perl -MCPAN -e shell
install Tapper::TestSuite::AutoTest