From 917e06b8e26c607fdd02f879b3407da9d0f14581 Mon Sep 17 00:00:00 2001 From: Nathan Cutler Date: Tue, 15 Mar 2016 14:10:42 +0100 Subject: [PATCH] doc/dev: add section on interrupting a running suite This commit adds a new section, entitled "Interrupt a running suite", to the "Testing in the cloud" chapter. Signed-off-by: Nathan Cutler --- doc/dev/index.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/dev/index.rst b/doc/dev/index.rst index 0bd9e2ef0c8db..ca90c097d1504 100644 --- a/doc/dev/index.rst +++ b/doc/dev/index.rst @@ -1097,6 +1097,29 @@ have to be built, first. Again, the packages so built are cached and `ceph-workbench ceph-qa-suite`_ will not build identical packages a second time. +Interrupt a running suite +------------------------- + +Teuthology suites take time to run. From time to time one may wish to +interrupt a running suite. One obvious way to do this is:: + + ceph-workbench ceph-qa-suite --teardown + +This destroys all VMs created by `ceph-workbench ceph-qa-suite`_ and +returns the OpenStack tenant to a "clean slate". + +Sometimes you may wish to interrupt the running suite, but keep the logs, +the teuthology VM, the packages-repository VM, etc. To do this, you can +``ssh`` to the teuthology VM (using the ``ssh access`` command reported +when you triggered the suite -- see `Run the dummy suite`_) and, once +there:: + + sudo /etc/init.d/teuthology restart + +This will keep the teuthology machine, the logs and the packages-repository +instance but nuke everything else. + + .. WIP .. === .. -- 2.39.5