Skip to content

Latest commit

 

History

History
301 lines (188 loc) · 9.23 KB

File metadata and controls

301 lines (188 loc) · 9.23 KB

tapper

Tool for accessing testrun database, scheduler, queues, hosts, etc.

delete: Delete a testrun

Usage

tapper testrun-delete [ --verbose | --force | --id=s@ ]

        --verbose    some more informational output
        --really     really execute the command
        --id         delete particular testruns

Synopsis

--really --id=12345

deleteprecondition: Delete a precondition

Usage

tapper precondition-delete [ --verbose | --force | --id=s@ ]

        --verbose    some more informational output
        --really     really execute the command
        --id         delete particular precondition

Synopsis

deletequeue: Delete an existing queue

Usage

tapper precondition-list [ --verbose|v | --name=s ]

        -v --verbose   some more informational output
        --name         TEXT; name of the queue to be changed
        --really       really execute the command

Synopsis

list: List testruns

Usage

tapper testrun-list [ --verbose|v | --running|r |
                                    --host=s@ | --schedule|s |
                                    --id|i=i | --queue=s@ |
                                    --finished|f | --prepare|p ]

        -v --verbose    print all output, without only print ids
        -r --running    list running testruns, OR combined with other state filters
        --host          list testruns assigned to this queue, OR combined with other hosts,
                       AND combined with other filters
        -s --schedule   list scheduled testruns, OR combined with other state filters
        -i --id         list particular testruns
        --queue         list testruns assigned to this queue, OR combined with other queues,
                       AND combined with other filters
        -f --finished   list finished testruns, OR combined with other state filters

Synopsis

listhost: List hosts

Usage

tapper host-list --verbose|v | --free | --name=s | --active | --queue=s@

        -v --verbose   show all available information; without only show names
        --free         list free hosts
        --name         find host by name, implies verbose
        --active       list active hosts
        --queue        list hosts bound to this queue

Synopsis

listprecondition: List preconditions

Usage

tapper precondition-list [ --quotevalues|q | --verbose|v |
                                    --testrun=i@ | --nonewlines |
                                    --id|i=i@ ]

        -q --quotevalues   put quotes around the values
        -v --verbose       Show all information of preconditions, otherwise only show ids
        --testrun          assigned to given testrun id
        --nonewlines       escape newlines in values to avoid multilines
        -i --id            list particular precondition

Synopsis

listqueue: List queues

Usage

tapper queue-list --minprio=s | --verbose|v | --maxprio=s

        --minprio      INT; queues with at least this priority level
        -v --verbose   show all available information; without only show names
        --maxprio      INT; queues with at most this priority level

Synopsis

new: Create a new testrun

Usage

tapper testrun-new [ --requested_host=s@ | --requested_feature=s@ |
                       --topic=s | --queue=s | --notes=s |
                       --shortname=s | --owner=s | --wait_after_tests=s |
                       --macroprecond=s | -Dkey=val | --auto_rerun]*

        --priority                Boolean; This is a very important testrun that
                                 should bypass scheduling and not wait for others
        --shortname               TEXT; shortname
        --verbose                 some more informational output
        --earliest                STRING, default=now; don't start testrun before
                                 this time (format: YYYY-MM-DD hh:mm:ss or now)
        --requested_feature       String; description of one requested feature of a
                                 matching host for this testrequest;
                                  multiple requested features are AND evaluated,
                                 i.e. each must fit; not evaluated if a matching
                                 requested host is found already
        --rerun_on_error          INT, retry this testrun this many times if an error occurs
        --precondition            assigned precondition ids
        --requested_host          String; name one possible host for this testrequest;
                                  multiple requested hosts are OR evaluated,
                                 i.e. each is appropriate
        --topic                   STRING, default=Misc; one of:
                                 Kernel, Xen, KVM, Hardware, Distribution,
                                 Benchmark, Software, Misc
        --owner                   STRING, default=$USER; user login name
        --macroprecond            STRING, use this macro precondition file
        --wait_after_tests        BOOL, default=0; wait after testrun for human investigation
        --notes                   TEXT; notes
        -D                        Define a key=value pair used in macro preconditions
        --auto_rerun              BOOL, default=0; put this testrun into db again when
                                 it is chosen by scheduler
        --queue                   STRING, default=AdHoc

Synopsis

newhost: Create a new host

Usage

tapper queue-new --name=s [ --active --verbose ]*

        --verbose     some more informational output
        --active      MCP can use this host, default 0
        --name        TEXT; name

Synopsis

newprecondition: Create a new precondition

Usage

tapper precondition-new ( --condition=s | --condition_file=s )
                                [ --shortname=s ] [ --timeout=n ] [ --precondition=n ]*

        --verbose             some more informational output
        --timeout             INT; stop trying to fullfill this precondition after timeout second
        --condition           TEXT; condition description in YAML format (see Spec)
        --condition_file      STRING; filename from where to read condition,
                             use - to read from STDIN
        --shortname           TEXT; shortname that overrides the one in the yaml
        --precondition        INT; assigned pre-precondition ids

Synopsis

newqueue: Create a new queue

Usage

tapper queue-new --name=s --priority=s [ --verbose ]

        --priority      INT; priority
        --verbose       some more informational output
        --active        set active flag to this value, prepend with no to unset
        --name          TEXT; name

Synopsis

newscenario: Create a new testrun

Usage

tapper scenario-new --file=s

        --verbose    some more informational output
        -D           Define a key=value pair used in macro preconditions
        --file       String; use macro scenario file

Synopsis

rerun: Create a new testrun based on existing one

Usage

tapper testrun-rerun --id=i [ --notes=s ]?

        --verbose      some more informational output
        --notes        TEXT; notes
        --id           INT, testrun to start again

Synopsis

update: Update a testrun

Usage

tapper testrun-update --id=s [ --hostname=s | --topic=s | --auto-rerun | --no-auto-rerun | --status=s --verbose ]*
        --verbose               some more informational output
        --topic                 STRING, default=Misc; one of: Kernel, Xen, KVM,
                               Hardware, Distribution, Benchmark, Software, Misc
        --id                    INT; the testrun id to change
   --status                Set testrun to given status, can be one of 'prepare', 'schedule', 'finished'.";
   --auto-rerun            Activate auto-rerun on testrun. ";
   --no-auto-rerun         Activate auto-rerun on testrun";

Synopsis

updateprecondition: Update an existing precondition

Usage

tapper precondition-update --id=s [ --shortname=s |
                                            --condition=s |
                                            --condition_file=s )

        -v --verbose          some more informational output
        --shortname           TEXT; shortname
        --timeout             INT; stop trying to fullfill this precondition after timeout second
        --condition           TEXT; condition description in YAML format (see Spec)
        --condition_file      STRING; filename from where to read condition,
                             use - to read from STDIN
        --precondition        INT; assigned pre-precondition ids
        --id                  INT; the precondition id to change

Synopsis

updatequeue: Update an existing queue

Usage

tapper queue-update --name=s --priority=s [ --verbose ]

        -p --priority     INT; priority
        -v --verbose      some more informational output
        --active          set active flag to this value, prepend with no to unset

Synopsis

tapper-api

upload: Upload and attach a file to a report

Usage

tapper-api upload --reportid=s --file=s [ --contenttype=s ]

        --verbose           some more informational output
        --reportid          INT; the testrun id to change
        --file              STRING; the file to upload, use '-' for STDIN
        --filename          STRING; alternate file name, especially when reading from STDIN
        --reportserver      STRING; use this host for upload
        --reportport        STRING; use this port for upload
        --contenttype       STRING; content-type, default 'plain',
                           use 'application/octed-stream' for binaries

Synopsis