Skip to content

chapter-commandline.pod

Latest commit

 

History

History
173 lines (116 loc) · 4.06 KB

chapter-commandline.pod

File metadata and controls

173 lines (116 loc) · 4.06 KB

Command line interface

Commandline Synopsis

  • Get host usage/scheduling overview

  • Create hosts

  • Create queues

  • Create hosts/queue bindings

Scheduling

Create new queue and new host and bind both together

  • Show existing queues with priorities

    $ tapper queue-list -v
        10 |              AdHoc |  1000
        11 |      kernel_reboot |   100
         4 | xen-3.3-testing-32 |   100
         5 | xen-3.3-testing-64 |   100
         7 | xen-3.4-testing-32 |   100
         6 | xen-3.4-testing-64 |   100
         9 |    xen-unstable-32 |   100
         8 |    xen-unstable-64 |   100

  • Create new queue oprofile

    $ tapper queue-new --name=oprofile \
                          --priority=200
12

  • Create new host bullock and bind it to queue oprofile

    $ tapper host-new --name=bullock \
                         --queue=oprofile
10

  • Show existing hosts

    Note that the new host bullock is initially deactivated.

    $ tapper host-list -v
         8 |  amarok | deactivated |   free
         1 |  athene |      active | in use
         9 |   azael | deactivated |   free
        10 | bullock | deactivated |   free | oprofile
         4 |    cook | deactivated |   free
         6 | incubus | deactivated |   free
         2 |  kobold |      active | in use
         5 |  lemure |      active | in use
         3 |   satyr |      active | in use
         7 |    uruk | deactivated |   free

  • Activate host bullock

    Note that this command is ID based (bullock has id 10) because you can rename hosts.

    $ tapper host-update --id=10 --active
10 | bullock | active | free | oprofile

  • Again, show existing hosts

    Host bullock is now activated.

    $ tapper host-list -v
         8 |  amarok | deactivated |   free
         1 |  athene |      active | in use
         9 |   azael | deactivated |   free
        10 | bullock |      active |   free | oprofile
         4 |    cook | deactivated |   free
         6 | incubus | deactivated |   free
         2 |  kobold |      active | in use
         5 |  lemure |      active | in use
         3 |   satyr |      active | in use
         7 |    uruk | deactivated |   free

Done.

Change queue priority

  • List existing queues

    $ tapper queue-list -v
        10 |              AdHoc |  1000
        11 |      kernel_reboot |   100
        12 |           oprofile |   200 | bullock
         4 | xen-3.3-testing-32 |   100
         5 | xen-3.3-testing-64 |   100
         7 | xen-3.4-testing-32 |   100
         6 | xen-3.4-testing-64 |   100
         9 |    xen-unstable-32 |   100
         8 |    xen-unstable-64 |   100

  • Update queue

    $ tapper queue-update --name=oprofile \
                             --priority=1000
12

  • Again, list existing queues

    $ tapper queue-list -v
        10 |              AdHoc |  1000
        11 |      kernel_reboot |   100
        12 |           oprofile |  1000 | bullock
         4 | xen-3.3-testing-32 |   100
         5 | xen-3.3-testing-64 |   100
         7 | xen-3.4-testing-32 |   100
         6 | xen-3.4-testing-64 |   100
         9 |    xen-unstable-32 |   100
         8 |    xen-unstable-64 |   100

    Done.

requested features

Hosts for testruns can be choosen based on requested features. Supported features are:

  • hostname

  • mem

  • vendor

  • family

  • model

  • stepping

  • revision

  • socket

  • cores

  • clock

  • l2cache

  • l3cache

Cancel current testrun on host

Freeing a host need the config for the currently running testrun. Thus, the command is only tested on bancroft and may not work on other machines.

$ tapper host-free \
                 --name=bullock\
                 --desc='I need this host right now'