4 # Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013 Google Inc.
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 2 of the License, or
9 # (at your option) any later version.
11 # This program is distributed in the hope that it will be useful, but
12 # WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 # General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with this program; if not, write to the Free Software
18 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
22 """Script for doing QA on Ganeti.
26 # pylint: disable=C0103
48 from ganeti import utils
49 from ganeti import rapi # pylint: disable=W0611
50 from ganeti import constants
52 import ganeti.rapi.client # pylint: disable=W0611
53 from ganeti.rapi.client import UsesRapiClient
56 def _FormatHeader(line, end=72):
57 """Fill a line up to the end column.
60 line = "---- " + line + " "
61 line += "-" * (end - len(line))
66 def _DescriptionOf(fn):
67 """Computes the description of an item.
71 desc = fn.__doc__.splitlines()[0].strip()
75 return desc.rstrip(".")
78 def RunTest(fn, *args, **kwargs):
79 """Runs a test after printing a header.
83 tstart = datetime.datetime.now()
85 desc = _DescriptionOf(fn)
88 print _FormatHeader("%s start %s" % (tstart, desc))
91 retval = fn(*args, **kwargs)
94 tstop = datetime.datetime.now()
95 tdelta = tstop - tstart
96 print _FormatHeader("%s time=%s %s" % (tstop, tdelta, desc))
99 def RunTestIf(testnames, fn, *args, **kwargs):
100 """Runs a test conditionally.
102 @param testnames: either a single test name in the configuration
103 file, or a list of testnames (which will be AND-ed together)
106 if qa_config.TestEnabled(testnames):
107 RunTest(fn, *args, **kwargs)
109 tstart = datetime.datetime.now()
110 desc = _DescriptionOf(fn)
111 print _FormatHeader("%s skipping %s, test(s) %s disabled" %
112 (tstart, desc, testnames))
116 """Run several environment tests.
119 RunTestIf("env", qa_env.TestSshConnection)
120 RunTestIf("env", qa_env.TestIcmpPing)
121 RunTestIf("env", qa_env.TestGanetiCommands)
124 def SetupCluster(rapi_user, rapi_secret):
125 """Initializes the cluster.
127 @param rapi_user: Login user for RAPI
128 @param rapi_secret: Login secret for RAPI
131 RunTestIf("create-cluster", qa_cluster.TestClusterInit,
132 rapi_user, rapi_secret)
133 if not qa_config.TestEnabled("create-cluster"):
134 # If the cluster is already in place, we assume that exclusive-storage is
135 # already set according to the configuration
136 qa_config.SetExclusiveStorage(qa_config.get("exclusive-storage", False))
138 # Test on empty cluster
139 RunTestIf("node-list", qa_node.TestNodeList)
140 RunTestIf("instance-list", qa_instance.TestInstanceList)
141 RunTestIf("job-list", qa_job.TestJobList)
143 RunTestIf("create-cluster", qa_node.TestNodeAddAll)
144 if not qa_config.TestEnabled("create-cluster"):
145 # consider the nodes are already there
146 qa_node.MarkNodeAddedAll()
148 RunTestIf("test-jobqueue", qa_cluster.TestJobqueue)
150 # enable the watcher (unconditionally)
151 RunTest(qa_daemon.TestResumeWatcher)
153 RunTestIf("node-list", qa_node.TestNodeList)
155 # Test listing fields
156 RunTestIf("node-list", qa_node.TestNodeListFields)
157 RunTestIf("instance-list", qa_instance.TestInstanceListFields)
158 RunTestIf("job-list", qa_job.TestJobListFields)
159 RunTestIf("instance-export", qa_instance.TestBackupListFields)
161 RunTestIf("node-info", qa_node.TestNodeInfo)
164 def RunClusterTests():
165 """Runs tests related to gnt-cluster.
169 ("create-cluster", qa_cluster.TestClusterInitDisk),
170 ("cluster-renew-crypto", qa_cluster.TestClusterRenewCrypto),
171 ("cluster-verify", qa_cluster.TestClusterVerify),
172 ("cluster-reserved-lvs", qa_cluster.TestClusterReservedLvs),
173 # TODO: add more cluster modify tests
174 ("cluster-modify", qa_cluster.TestClusterModifyEmpty),
175 ("cluster-modify", qa_cluster.TestClusterModifyBe),
176 ("cluster-modify", qa_cluster.TestClusterModifyDisk),
177 ("cluster-rename", qa_cluster.TestClusterRename),
178 ("cluster-info", qa_cluster.TestClusterVersion),
179 ("cluster-info", qa_cluster.TestClusterInfo),
180 ("cluster-info", qa_cluster.TestClusterGetmaster),
181 ("cluster-redist-conf", qa_cluster.TestClusterRedistConf),
182 ("cluster-copyfile", qa_cluster.TestClusterCopyfile),
183 ("cluster-command", qa_cluster.TestClusterCommand),
184 ("cluster-burnin", qa_cluster.TestClusterBurnin),
185 ("cluster-master-failover", qa_cluster.TestClusterMasterFailover),
186 ("cluster-master-failover",
187 qa_cluster.TestClusterMasterFailoverWithDrainedQueue),
188 ("cluster-oob", qa_cluster.TestClusterOob),
189 ("rapi", qa_rapi.TestVersion),
190 ("rapi", qa_rapi.TestEmptyCluster),
191 ("rapi", qa_rapi.TestRapiQuery),
196 def RunRepairDiskSizes():
197 """Run the repair disk-sizes test.
200 RunTestIf("cluster-repair-disk-sizes", qa_cluster.TestClusterRepairDiskSizes)
204 """Runs all tests related to gnt-os.
207 if qa_config.TestEnabled("rapi"):
208 rapi_getos = qa_rapi.GetOperatingSystems
214 qa_os.TestOsDiagnose,
221 qa_os.TestOsPartiallyValid,
223 RunTestIf("os", fn, rapi_getos)
226 qa_os.TestOsModifyValid,
227 qa_os.TestOsModifyInvalid,
228 qa_os.TestOsStatesNonExisting,
233 def RunCommonInstanceTests(instance):
234 """Runs a few tests that are common to all disk types.
237 RunTestIf("instance-shutdown", qa_instance.TestInstanceShutdown, instance)
238 RunTestIf(["instance-shutdown", "instance-console", "rapi"],
239 qa_rapi.TestRapiStoppedInstanceConsole, instance)
240 RunTestIf(["instance-shutdown", "instance-modify"],
241 qa_instance.TestInstanceStoppedModify, instance)
242 RunTestIf("instance-shutdown", qa_instance.TestInstanceStartup, instance)
244 # Test shutdown/start via RAPI
245 RunTestIf(["instance-shutdown", "rapi"],
246 qa_rapi.TestRapiInstanceShutdown, instance)
247 RunTestIf(["instance-shutdown", "rapi"],
248 qa_rapi.TestRapiInstanceStartup, instance)
250 RunTestIf("instance-list", qa_instance.TestInstanceList)
252 RunTestIf("instance-info", qa_instance.TestInstanceInfo, instance)
254 RunTestIf("instance-modify", qa_instance.TestInstanceModify, instance)
255 RunTestIf(["instance-modify", "rapi"],
256 qa_rapi.TestRapiInstanceModify, instance)
258 RunTestIf("instance-console", qa_instance.TestInstanceConsole, instance)
259 RunTestIf(["instance-console", "rapi"],
260 qa_rapi.TestRapiInstanceConsole, instance)
262 DOWN_TESTS = qa_config.Either([
263 "instance-reinstall",
265 "instance-grow-disk",
268 # shutdown instance for any 'down' tests
269 RunTestIf(DOWN_TESTS, qa_instance.TestInstanceShutdown, instance)
271 # now run the 'down' state tests
272 RunTestIf("instance-reinstall", qa_instance.TestInstanceReinstall, instance)
273 RunTestIf(["instance-reinstall", "rapi"],
274 qa_rapi.TestRapiInstanceReinstall, instance)
276 if qa_config.TestEnabled("instance-rename"):
277 tgt_instance = qa_config.AcquireInstance()
279 rename_source = instance.name
280 rename_target = tgt_instance.name
281 # perform instance rename to the same name
282 RunTest(qa_instance.TestInstanceRenameAndBack,
283 rename_source, rename_source)
284 RunTestIf("rapi", qa_rapi.TestRapiInstanceRenameAndBack,
285 rename_source, rename_source)
286 if rename_target is not None:
287 # perform instance rename to a different name, if we have one configured
288 RunTest(qa_instance.TestInstanceRenameAndBack,
289 rename_source, rename_target)
290 RunTestIf("rapi", qa_rapi.TestRapiInstanceRenameAndBack,
291 rename_source, rename_target)
293 tgt_instance.Release()
295 RunTestIf(["instance-grow-disk"], qa_instance.TestInstanceGrowDisk, instance)
297 # and now start the instance again
298 RunTestIf(DOWN_TESTS, qa_instance.TestInstanceStartup, instance)
300 RunTestIf("instance-reboot", qa_instance.TestInstanceReboot, instance)
302 RunTestIf("tags", qa_tags.TestInstanceTags, instance)
304 RunTestIf("cluster-verify", qa_cluster.TestClusterVerify)
306 RunTestIf("rapi", qa_rapi.TestInstance, instance)
308 # Lists instances, too
309 RunTestIf("node-list", qa_node.TestNodeList)
311 # Some jobs have been run, let's test listing them
312 RunTestIf("job-list", qa_job.TestJobList)
315 def RunCommonNodeTests():
316 """Run a few common node tests.
319 RunTestIf("node-volumes", qa_node.TestNodeVolumes)
320 RunTestIf("node-storage", qa_node.TestNodeStorage)
321 RunTestIf("node-oob", qa_node.TestOutOfBand)
324 def RunGroupListTests():
325 """Run tests for listing node groups.
328 RunTestIf("group-list", qa_group.TestGroupList)
329 RunTestIf("group-list", qa_group.TestGroupListFields)
332 def RunNetworkTests():
333 """Run tests for network management.
336 RunTestIf("network", qa_network.TestNetworkAddRemove)
337 RunTestIf("network", qa_network.TestNetworkConnect)
340 def RunGroupRwTests():
341 """Run tests for adding/removing/renaming groups.
344 RunTestIf("group-rwops", qa_group.TestGroupAddRemoveRename)
345 RunTestIf("group-rwops", qa_group.TestGroupAddWithOptions)
346 RunTestIf("group-rwops", qa_group.TestGroupModify)
347 RunTestIf(["group-rwops", "rapi"], qa_rapi.TestRapiNodeGroups)
348 RunTestIf(["group-rwops", "tags"], qa_tags.TestGroupTags,
349 qa_group.GetDefaultGroup())
352 def RunExportImportTests(instance, inodes):
353 """Tries to export and import the instance.
355 @type inodes: list of nodes
356 @param inodes: current nodes of the instance
359 if qa_config.TestEnabled("instance-export"):
360 RunTest(qa_instance.TestInstanceExportNoTarget, instance)
363 expnode = qa_config.AcquireNode(exclude=pnode)
365 name = RunTest(qa_instance.TestInstanceExport, instance, expnode)
367 RunTest(qa_instance.TestBackupList, expnode)
369 if qa_config.TestEnabled("instance-import"):
370 newinst = qa_config.AcquireInstance()
372 RunTest(qa_instance.TestInstanceImport, newinst, pnode,
374 # Check if starting the instance works
375 RunTest(qa_instance.TestInstanceStartup, newinst)
376 RunTest(qa_instance.TestInstanceRemove, newinst)
382 if qa_config.TestEnabled(["rapi", "inter-cluster-instance-move"]):
383 newinst = qa_config.AcquireInstance()
385 tnode = qa_config.AcquireNode(exclude=inodes)
387 RunTest(qa_rapi.TestInterClusterInstanceMove, instance, newinst,
395 def RunDaemonTests(instance):
396 """Test the ganeti-watcher script.
399 RunTest(qa_daemon.TestPauseWatcher)
401 RunTestIf("instance-automatic-restart",
402 qa_daemon.TestInstanceAutomaticRestart, instance)
403 RunTestIf("instance-consecutive-failures",
404 qa_daemon.TestInstanceConsecutiveFailures, instance)
406 RunTest(qa_daemon.TestResumeWatcher)
409 def RunHardwareFailureTests(instance, inodes):
410 """Test cluster internal hardware failure recovery.
413 RunTestIf("instance-failover", qa_instance.TestInstanceFailover, instance)
414 RunTestIf(["instance-failover", "rapi"],
415 qa_rapi.TestRapiInstanceFailover, instance)
417 RunTestIf("instance-migrate", qa_instance.TestInstanceMigrate, instance)
418 RunTestIf(["instance-migrate", "rapi"],
419 qa_rapi.TestRapiInstanceMigrate, instance)
421 if qa_config.TestEnabled("instance-replace-disks"):
422 # We just need alternative secondary nodes, hence "- 1"
423 othernodes = qa_config.AcquireManyNodes(len(inodes) - 1, exclude=inodes)
425 RunTestIf("rapi", qa_rapi.TestRapiInstanceReplaceDisks, instance)
426 RunTest(qa_instance.TestReplaceDisks,
427 instance, inodes, othernodes)
429 qa_config.ReleaseManyNodes(othernodes)
432 if qa_config.TestEnabled("instance-recreate-disks"):
434 acquirednodes = qa_config.AcquireManyNodes(len(inodes), exclude=inodes)
435 othernodes = acquirednodes
436 except qa_error.OutOfNodesError:
438 # If the cluster is not big enough, let's reuse some of the nodes, but
439 # with different roles. In this way, we can test a DRBD instance even on
441 acquirednodes = [qa_config.AcquireNode(exclude=inodes)]
442 othernodes = acquirednodes + inodes[:-1]
446 RunTest(qa_instance.TestRecreateDisks,
447 instance, inodes, othernodes)
449 qa_config.ReleaseManyNodes(acquirednodes)
452 RunTestIf("node-evacuate", qa_node.TestNodeEvacuate, inodes[0], inodes[1])
453 RunTestIf("node-failover", qa_node.TestNodeFailover, inodes[0], inodes[1])
456 def RunExclusiveStorageTests():
457 """Test exclusive storage."""
458 if not qa_config.TestEnabled("cluster-exclusive-storage"):
461 node = qa_config.AcquireNode()
463 old_es = qa_cluster.TestSetExclStorCluster(False)
464 qa_node.TestExclStorSingleNode(node)
466 qa_cluster.TestSetExclStorCluster(True)
467 qa_cluster.TestExclStorSharedPv(node)
469 if qa_config.TestEnabled("instance-add-plain-disk"):
470 # Make sure that the cluster doesn't have any pre-existing problem
471 qa_cluster.AssertClusterVerify()
473 # Create and allocate instances
474 instance1 = qa_instance.TestInstanceAddWithPlainDisk([node])
476 instance2 = qa_instance.TestInstanceAddWithPlainDisk([node])
478 # cluster-verify checks that disks are allocated correctly
479 qa_cluster.AssertClusterVerify()
482 qa_instance.TestInstanceRemove(instance2)
483 qa_instance.TestInstanceRemove(instance1)
489 if qa_config.TestEnabled("instance-add-drbd-disk"):
490 snode = qa_config.AcquireNode()
492 qa_cluster.TestSetExclStorCluster(False)
493 instance = qa_instance.TestInstanceAddWithDrbdDisk([node, snode])
495 qa_cluster.TestSetExclStorCluster(True)
496 exp_err = [constants.CV_EINSTANCEUNSUITABLENODE]
497 qa_cluster.AssertClusterVerify(fail=True, errors=exp_err)
498 qa_instance.TestInstanceRemove(instance)
503 qa_cluster.TestSetExclStorCluster(old_es)
508 def RunInstanceTests():
509 """Create and exercise instances."""
511 ("instance-add-plain-disk", constants.DT_PLAIN,
512 qa_instance.TestInstanceAddWithPlainDisk, 1),
513 ("instance-add-drbd-disk", constants.DT_DRBD8,
514 qa_instance.TestInstanceAddWithDrbdDisk, 2),
517 for (test_name, templ, create_fun, num_nodes) in instance_tests:
518 if (qa_config.TestEnabled(test_name) and
519 qa_config.IsTemplateSupported(templ)):
520 inodes = qa_config.AcquireManyNodes(num_nodes)
522 instance = RunTest(create_fun, inodes)
524 RunTestIf("cluster-epo", qa_cluster.TestClusterEpo)
525 RunDaemonTests(instance)
527 RunTestIf("haskell-confd", qa_node.TestNodeListDrbd, node)
529 RunTestIf("group-rwops", qa_group.TestAssignNodesIncludingSplit,
530 constants.INITIAL_NODE_GROUP_NAME,
531 inodes[0].primary, inodes[1].primary)
532 if qa_config.TestEnabled("instance-convert-disk"):
533 RunTest(qa_instance.TestInstanceShutdown, instance)
534 RunTest(qa_instance.TestInstanceConvertDiskToPlain,
536 RunTest(qa_instance.TestInstanceStartup, instance)
537 RunCommonInstanceTests(instance)
539 RunExportImportTests(instance, inodes)
540 RunHardwareFailureTests(instance, inodes)
542 RunTest(qa_instance.TestInstanceRemove, instance)
547 qa_config.ReleaseManyNodes(inodes)
548 qa_cluster.AssertClusterVerify()
555 rapi_user = "ganeti-qa"
556 rapi_secret = utils.GenerateSecret()
559 SetupCluster(rapi_user, rapi_secret)
561 # Load RAPI certificate
562 qa_rapi.Setup(rapi_user, rapi_secret)
567 RunTestIf("tags", qa_tags.TestClusterTags)
574 # The master shouldn't be readded or put offline; "delay" needs a non-master
576 pnode = qa_config.AcquireNode(exclude=qa_config.GetMasterNode())
578 RunTestIf("node-readd", qa_node.TestNodeReadd, pnode)
579 RunTestIf("node-modify", qa_node.TestNodeModify, pnode)
580 RunTestIf("delay", qa_cluster.TestDelay, pnode)
584 # Make sure the cluster is clean before running instance tests
585 qa_cluster.AssertClusterVerify()
587 pnode = qa_config.AcquireNode()
589 RunTestIf("tags", qa_tags.TestNodeTags, pnode)
591 if qa_rapi.Enabled():
592 RunTest(qa_rapi.TestNode, pnode)
594 if qa_config.TestEnabled("instance-add-plain-disk"):
595 for use_client in [True, False]:
596 rapi_instance = RunTest(qa_rapi.TestRapiInstanceAdd, pnode,
599 if qa_config.TestEnabled("instance-plain-rapi-common-tests"):
600 RunCommonInstanceTests(rapi_instance)
601 RunTest(qa_rapi.TestRapiInstanceRemove, rapi_instance, use_client)
603 rapi_instance.Release()
610 ("default-instance-tests", lambda: None, lambda _: None),
611 ("exclusive-storage-instance-tests",
612 lambda: qa_cluster.TestSetExclStorCluster(True),
613 qa_cluster.TestSetExclStorCluster),
615 for (conf_name, setup_conf_f, restore_conf_f) in config_list:
616 if qa_config.TestEnabled(conf_name):
617 oldconf = setup_conf_f()
619 restore_conf_f(oldconf)
621 pnode = qa_config.AcquireNode()
623 if qa_config.TestEnabled(["instance-add-plain-disk", "instance-export"]):
624 for shutdown in [False, True]:
625 instance = RunTest(qa_instance.TestInstanceAddWithPlainDisk, [pnode])
627 expnode = qa_config.AcquireNode(exclude=pnode)
630 # Stop instance before exporting and removing it
631 RunTest(qa_instance.TestInstanceShutdown, instance)
632 RunTest(qa_instance.TestInstanceExportWithRemove, instance, expnode)
633 RunTest(qa_instance.TestBackupList, expnode)
640 qa_cluster.AssertClusterVerify()
645 RunExclusiveStorageTests()
647 # Test removing instance with offline drbd secondary
648 if qa_config.TestEnabled("instance-remove-drbd-offline"):
649 # Make sure the master is not put offline
650 snode = qa_config.AcquireNode(exclude=qa_config.GetMasterNode())
652 pnode = qa_config.AcquireNode(exclude=snode)
654 instance = qa_instance.TestInstanceAddWithDrbdDisk([pnode, snode])
655 set_offline = lambda node: qa_node.MakeNodeOffline(node, "yes")
656 set_online = lambda node: qa_node.MakeNodeOffline(node, "no")
657 RunTest(qa_instance.TestRemoveInstanceOfflineNode, instance, snode,
658 set_offline, set_online)
663 qa_cluster.AssertClusterVerify()
665 RunTestIf("create-cluster", qa_node.TestNodeRemoveAll)
667 RunTestIf("cluster-destroy", qa_cluster.TestClusterDestroy)
675 parser = optparse.OptionParser(usage="%prog [options] <config-file>")
676 parser.add_option("--yes-do-it", dest="yes_do_it",
678 help="Really execute the tests")
679 (opts, args) = parser.parse_args()
682 (config_file, ) = args
684 parser.error("Wrong number of arguments.")
686 if not opts.yes_do_it:
687 print ("Executing this script irreversibly destroys any Ganeti\n"
688 "configuration on all nodes involved. If you really want\n"
689 "to start testing, supply the --yes-do-it option.")
692 qa_config.Load(config_file)
694 primary = qa_config.GetMasterNode().primary
695 qa_utils.StartMultiplexer(primary)
696 print ("SSH command for primary node: %s" %
697 utils.ShellQuoteArgs(qa_utils.GetSSHCommand(primary, "")))
698 print ("SSH command for other nodes: %s" %
699 utils.ShellQuoteArgs(qa_utils.GetSSHCommand("NODE", "")))
703 qa_utils.CloseMultiplexers()
705 if __name__ == "__main__":