4 # Copyright (C) 2006, 2007, 2010, 2011 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
21 """Cluster related commands"""
23 # pylint: disable-msg=W0401,W0613,W0614,C0103
24 # W0401: Wildcard import ganeti.cli
25 # W0613: Unused argument, since all functions follow the same API
26 # W0614: Unused import %s from wildcard import (since we need cli)
27 # C0103: Invalid name gnt-cluster
33 from ganeti.cli import *
34 from ganeti import opcodes
35 from ganeti import constants
36 from ganeti import errors
37 from ganeti import utils
38 from ganeti import bootstrap
39 from ganeti import ssh
40 from ganeti import objects
41 from ganeti import uidpool
42 from ganeti import compat
46 def InitCluster(opts, args):
47 """Initialize the cluster.
49 @param opts: the command line options selected by the user
51 @param args: should contain only one element, the desired
54 @return: the desired exit code
57 if not opts.lvm_storage and opts.vg_name:
58 ToStderr("Options --no-lvm-storage and --vg-name conflict.")
61 vg_name = opts.vg_name
62 if opts.lvm_storage and not opts.vg_name:
63 vg_name = constants.DEFAULT_VG
65 if not opts.drbd_storage and opts.drbd_helper:
66 ToStderr("Options --no-drbd-storage and --drbd-usermode-helper conflict.")
69 drbd_helper = opts.drbd_helper
70 if opts.drbd_storage and not opts.drbd_helper:
71 drbd_helper = constants.DEFAULT_DRBD_HELPER
73 master_netdev = opts.master_netdev
74 if master_netdev is None:
75 master_netdev = constants.DEFAULT_BRIDGE
77 hvlist = opts.enabled_hypervisors
79 hvlist = constants.DEFAULT_ENABLED_HYPERVISOR
80 hvlist = hvlist.split(",")
82 hvparams = dict(opts.hvparams)
83 beparams = opts.beparams
84 nicparams = opts.nicparams
86 # prepare beparams dict
87 beparams = objects.FillDict(constants.BEC_DEFAULTS, beparams)
88 utils.ForceDictType(beparams, constants.BES_PARAMETER_TYPES)
90 # prepare nicparams dict
91 nicparams = objects.FillDict(constants.NICC_DEFAULTS, nicparams)
92 utils.ForceDictType(nicparams, constants.NICS_PARAMETER_TYPES)
94 # prepare ndparams dict
95 if opts.ndparams is None:
96 ndparams = dict(constants.NDC_DEFAULTS)
98 ndparams = objects.FillDict(constants.NDC_DEFAULTS, opts.ndparams)
99 utils.ForceDictType(ndparams, constants.NDS_PARAMETER_TYPES)
101 # prepare hvparams dict
102 for hv in constants.HYPER_TYPES:
103 if hv not in hvparams:
105 hvparams[hv] = objects.FillDict(constants.HVC_DEFAULTS[hv], hvparams[hv])
106 utils.ForceDictType(hvparams[hv], constants.HVS_PARAMETER_TYPES)
108 if opts.candidate_pool_size is None:
109 opts.candidate_pool_size = constants.MASTER_POOL_SIZE_DEFAULT
111 if opts.mac_prefix is None:
112 opts.mac_prefix = constants.DEFAULT_MAC_PREFIX
114 uid_pool = opts.uid_pool
115 if uid_pool is not None:
116 uid_pool = uidpool.ParseUidPool(uid_pool)
118 if opts.prealloc_wipe_disks is None:
119 opts.prealloc_wipe_disks = False
122 primary_ip_version = int(opts.primary_ip_version)
123 except (ValueError, TypeError), err:
124 ToStderr("Invalid primary ip version value: %s" % str(err))
127 bootstrap.InitCluster(cluster_name=args[0],
128 secondary_ip=opts.secondary_ip,
130 mac_prefix=opts.mac_prefix,
131 master_netdev=master_netdev,
132 file_storage_dir=opts.file_storage_dir,
133 enabled_hypervisors=hvlist,
138 candidate_pool_size=opts.candidate_pool_size,
139 modify_etc_hosts=opts.modify_etc_hosts,
140 modify_ssh_setup=opts.modify_ssh_setup,
141 maintain_node_health=opts.maintain_node_health,
142 drbd_helper=drbd_helper,
144 default_iallocator=opts.default_iallocator,
145 primary_ip_version=primary_ip_version,
146 prealloc_wipe_disks=opts.prealloc_wipe_disks,
148 op = opcodes.OpClusterPostInit()
149 SubmitOpCode(op, opts=opts)
154 def DestroyCluster(opts, args):
155 """Destroy the cluster.
157 @param opts: the command line options selected by the user
159 @param args: should be an empty list
161 @return: the desired exit code
164 if not opts.yes_do_it:
165 ToStderr("Destroying a cluster is irreversible. If you really want"
166 " destroy this cluster, supply the --yes-do-it option.")
169 op = opcodes.OpClusterDestroy()
170 master = SubmitOpCode(op, opts=opts)
171 # if we reached this, the opcode didn't fail; we can proceed to
172 # shutdown all the daemons
173 bootstrap.FinalizeClusterDestroy(master)
177 def RenameCluster(opts, args):
178 """Rename the cluster.
180 @param opts: the command line options selected by the user
182 @param args: should contain only one element, the new cluster name
184 @return: the desired exit code
189 (cluster_name, ) = cl.QueryConfigValues(["cluster_name"])
193 usertext = ("This will rename the cluster from '%s' to '%s'. If you are"
194 " connected over the network to the cluster name, the"
195 " operation is very dangerous as the IP address will be"
196 " removed from the node and the change may not go through."
197 " Continue?") % (cluster_name, new_name)
198 if not AskUser(usertext):
201 op = opcodes.OpClusterRename(name=new_name)
202 result = SubmitOpCode(op, opts=opts, cl=cl)
205 ToStdout("Cluster renamed from '%s' to '%s'", cluster_name, result)
210 def RedistributeConfig(opts, args):
211 """Forces push of the cluster configuration.
213 @param opts: the command line options selected by the user
215 @param args: empty list
217 @return: the desired exit code
220 op = opcodes.OpClusterRedistConf()
221 SubmitOrSend(op, opts)
225 def ShowClusterVersion(opts, args):
226 """Write version of ganeti software to the standard output.
228 @param opts: the command line options selected by the user
230 @param args: should be an empty list
232 @return: the desired exit code
236 result = cl.QueryClusterInfo()
237 ToStdout("Software version: %s", result["software_version"])
238 ToStdout("Internode protocol: %s", result["protocol_version"])
239 ToStdout("Configuration format: %s", result["config_version"])
240 ToStdout("OS api version: %s", result["os_api_version"])
241 ToStdout("Export interface: %s", result["export_version"])
245 def ShowClusterMaster(opts, args):
246 """Write name of master node to the standard output.
248 @param opts: the command line options selected by the user
250 @param args: should be an empty list
252 @return: the desired exit code
255 master = bootstrap.GetMaster()
260 def _PrintGroupedParams(paramsdict, level=1, roman=False):
261 """Print Grouped parameters (be, nic, disk) by group.
263 @type paramsdict: dict of dicts
264 @param paramsdict: {group: {param: value, ...}, ...}
266 @param level: Level of indention
270 for item, val in sorted(paramsdict.items()):
271 if isinstance(val, dict):
272 ToStdout("%s- %s:", indent, item)
273 _PrintGroupedParams(val, level=level + 1, roman=roman)
274 elif roman and isinstance(val, int):
275 ToStdout("%s %s: %s", indent, item, compat.TryToRoman(val))
277 ToStdout("%s %s: %s", indent, item, val)
280 def ShowClusterConfig(opts, args):
281 """Shows cluster information.
283 @param opts: the command line options selected by the user
285 @param args: should be an empty list
287 @return: the desired exit code
291 result = cl.QueryClusterInfo()
293 ToStdout("Cluster name: %s", result["name"])
294 ToStdout("Cluster UUID: %s", result["uuid"])
296 ToStdout("Creation time: %s", utils.FormatTime(result["ctime"]))
297 ToStdout("Modification time: %s", utils.FormatTime(result["mtime"]))
299 ToStdout("Master node: %s", result["master"])
301 ToStdout("Architecture (this node): %s (%s)",
302 result["architecture"][0], result["architecture"][1])
305 tags = utils.CommaJoin(utils.NiceSort(result["tags"]))
309 ToStdout("Tags: %s", tags)
311 ToStdout("Default hypervisor: %s", result["default_hypervisor"])
312 ToStdout("Enabled hypervisors: %s",
313 utils.CommaJoin(result["enabled_hypervisors"]))
315 ToStdout("Hypervisor parameters:")
316 _PrintGroupedParams(result["hvparams"])
318 ToStdout("OS-specific hypervisor parameters:")
319 _PrintGroupedParams(result["os_hvp"])
321 ToStdout("OS parameters:")
322 _PrintGroupedParams(result["osparams"])
324 ToStdout("Hidden OSes: %s", utils.CommaJoin(result["hidden_os"]))
325 ToStdout("Blacklisted OSes: %s", utils.CommaJoin(result["blacklisted_os"]))
327 ToStdout("Cluster parameters:")
328 ToStdout(" - candidate pool size: %s",
329 compat.TryToRoman(result["candidate_pool_size"],
330 convert=opts.roman_integers))
331 ToStdout(" - master netdev: %s", result["master_netdev"])
332 ToStdout(" - lvm volume group: %s", result["volume_group_name"])
333 if result["reserved_lvs"]:
334 reserved_lvs = utils.CommaJoin(result["reserved_lvs"])
336 reserved_lvs = "(none)"
337 ToStdout(" - lvm reserved volumes: %s", reserved_lvs)
338 ToStdout(" - drbd usermode helper: %s", result["drbd_usermode_helper"])
339 ToStdout(" - file storage path: %s", result["file_storage_dir"])
340 ToStdout(" - maintenance of node health: %s",
341 result["maintain_node_health"])
342 ToStdout(" - uid pool: %s",
343 uidpool.FormatUidPool(result["uid_pool"],
344 roman=opts.roman_integers))
345 ToStdout(" - default instance allocator: %s", result["default_iallocator"])
346 ToStdout(" - primary ip version: %d", result["primary_ip_version"])
347 ToStdout(" - preallocation wipe disks: %s", result["prealloc_wipe_disks"])
349 ToStdout("Default node parameters:")
350 _PrintGroupedParams(result["ndparams"], roman=opts.roman_integers)
352 ToStdout("Default instance parameters:")
353 _PrintGroupedParams(result["beparams"], roman=opts.roman_integers)
355 ToStdout("Default nic parameters:")
356 _PrintGroupedParams(result["nicparams"], roman=opts.roman_integers)
361 def ClusterCopyFile(opts, args):
362 """Copy a file from master to some nodes.
364 @param opts: the command line options selected by the user
366 @param args: should contain only one element, the path of
367 the file to be copied
369 @return: the desired exit code
373 if not os.path.exists(filename):
374 raise errors.OpPrereqError("No such filename '%s'" % filename,
379 cluster_name = cl.QueryConfigValues(["cluster_name"])[0]
381 results = GetOnlineNodes(nodes=opts.nodes, cl=cl, filter_master=True,
382 secondary_ips=opts.use_replication_network)
384 srun = ssh.SshRunner(cluster_name=cluster_name)
386 if not srun.CopyFileToNode(node, filename):
387 ToStderr("Copy of file %s to node %s failed", filename, node)
392 def RunClusterCommand(opts, args):
393 """Run a command on some nodes.
395 @param opts: the command line options selected by the user
397 @param args: should contain the command to be run and its arguments
399 @return: the desired exit code
404 command = " ".join(args)
406 nodes = GetOnlineNodes(nodes=opts.nodes, cl=cl)
408 cluster_name, master_node = cl.QueryConfigValues(["cluster_name",
411 srun = ssh.SshRunner(cluster_name=cluster_name)
413 # Make sure master node is at list end
414 if master_node in nodes:
415 nodes.remove(master_node)
416 nodes.append(master_node)
419 result = srun.Run(name, "root", command)
420 ToStdout("------------------------------------------------")
421 ToStdout("node: %s", name)
422 ToStdout("%s", result.output)
423 ToStdout("return code = %s", result.exit_code)
428 def VerifyCluster(opts, args):
429 """Verify integrity of cluster, performing various test on nodes.
431 @param opts: the command line options selected by the user
433 @param args: should be an empty list
435 @return: the desired exit code
439 if opts.skip_nplusone_mem:
440 skip_checks.append(constants.VERIFY_NPLUSONE_MEM)
441 op = opcodes.OpClusterVerify(skip_checks=skip_checks,
442 verbose=opts.verbose,
443 error_codes=opts.error_codes,
444 debug_simulate_errors=opts.simulate_errors)
445 if SubmitOpCode(op, opts=opts):
451 def VerifyDisks(opts, args):
452 """Verify integrity of cluster disks.
454 @param opts: the command line options selected by the user
456 @param args: should be an empty list
458 @return: the desired exit code
463 op = opcodes.OpClusterVerifyDisks()
464 result = SubmitOpCode(op, opts=opts, cl=cl)
465 if not isinstance(result, (list, tuple)) or len(result) != 3:
466 raise errors.ProgrammerError("Unknown result type for OpClusterVerifyDisks")
468 bad_nodes, instances, missing = result
470 retcode = constants.EXIT_SUCCESS
473 for node, text in bad_nodes.items():
474 ToStdout("Error gathering data on node %s: %s",
475 node, utils.SafeEncode(text[-400:]))
477 ToStdout("You need to fix these nodes first before fixing instances")
480 for iname in instances:
483 op = opcodes.OpInstanceActivateDisks(instance_name=iname)
485 ToStdout("Activating disks for instance '%s'", iname)
486 SubmitOpCode(op, opts=opts, cl=cl)
487 except errors.GenericError, err:
488 nret, msg = FormatError(err)
490 ToStderr("Error activating disks for instance %s: %s", iname, msg)
493 for iname, ival in missing.iteritems():
494 all_missing = compat.all(x[0] in bad_nodes for x in ival)
496 ToStdout("Instance %s cannot be verified as it lives on"
497 " broken nodes", iname)
499 ToStdout("Instance %s has missing logical volumes:", iname)
501 for node, vol in ival:
502 if node in bad_nodes:
503 ToStdout("\tbroken node %s /dev/%s", node, vol)
505 ToStdout("\t%s /dev/%s", node, vol)
507 ToStdout("You need to run replace_disks for all the above"
508 " instances, if this message persist after fixing nodes.")
514 def RepairDiskSizes(opts, args):
515 """Verify sizes of cluster disks.
517 @param opts: the command line options selected by the user
519 @param args: optional list of instances to restrict check to
521 @return: the desired exit code
524 op = opcodes.OpClusterRepairDiskSizes(instances=args)
525 SubmitOpCode(op, opts=opts)
529 def MasterFailover(opts, args):
530 """Failover the master node.
532 This command, when run on a non-master node, will cause the current
533 master to cease being master, and the non-master to become new
536 @param opts: the command line options selected by the user
538 @param args: should be an empty list
540 @return: the desired exit code
544 usertext = ("This will perform the failover even if most other nodes"
545 " are down, or if this node is outdated. This is dangerous"
546 " as it can lead to a non-consistent cluster. Check the"
547 " gnt-cluster(8) man page before proceeding. Continue?")
548 if not AskUser(usertext):
551 return bootstrap.MasterFailover(no_voting=opts.no_voting)
554 def MasterPing(opts, args):
555 """Checks if the master is alive.
557 @param opts: the command line options selected by the user
559 @param args: should be an empty list
561 @return: the desired exit code
566 cl.QueryClusterInfo()
568 except Exception: # pylint: disable-msg=W0703
572 def SearchTags(opts, args):
573 """Searches the tags on all the cluster.
575 @param opts: the command line options selected by the user
577 @param args: should contain only one element, the tag pattern
579 @return: the desired exit code
582 op = opcodes.OpTagsSearch(pattern=args[0])
583 result = SubmitOpCode(op, opts=opts)
586 result = list(result)
588 for path, tag in result:
589 ToStdout("%s %s", path, tag)
592 def _RenewCrypto(new_cluster_cert, new_rapi_cert, rapi_cert_filename,
593 new_confd_hmac_key, new_cds, cds_filename,
595 """Renews cluster certificates, keys and secrets.
597 @type new_cluster_cert: bool
598 @param new_cluster_cert: Whether to generate a new cluster certificate
599 @type new_rapi_cert: bool
600 @param new_rapi_cert: Whether to generate a new RAPI certificate
601 @type rapi_cert_filename: string
602 @param rapi_cert_filename: Path to file containing new RAPI certificate
603 @type new_confd_hmac_key: bool
604 @param new_confd_hmac_key: Whether to generate a new HMAC key
606 @param new_cds: Whether to generate a new cluster domain secret
607 @type cds_filename: string
608 @param cds_filename: Path to file containing new cluster domain secret
610 @param force: Whether to ask user for confirmation
613 if new_rapi_cert and rapi_cert_filename:
614 ToStderr("Only one of the --new-rapi-certficate and --rapi-certificate"
615 " options can be specified at the same time.")
618 if new_cds and cds_filename:
619 ToStderr("Only one of the --new-cluster-domain-secret and"
620 " --cluster-domain-secret options can be specified at"
624 if rapi_cert_filename:
625 # Read and verify new certificate
627 rapi_cert_pem = utils.ReadFile(rapi_cert_filename)
629 OpenSSL.crypto.load_certificate(OpenSSL.crypto.FILETYPE_PEM,
631 except Exception, err: # pylint: disable-msg=W0703
632 ToStderr("Can't load new RAPI certificate from %s: %s" %
633 (rapi_cert_filename, str(err)))
637 OpenSSL.crypto.load_privatekey(OpenSSL.crypto.FILETYPE_PEM, rapi_cert_pem)
638 except Exception, err: # pylint: disable-msg=W0703
639 ToStderr("Can't load new RAPI private key from %s: %s" %
640 (rapi_cert_filename, str(err)))
648 cds = utils.ReadFile(cds_filename)
649 except Exception, err: # pylint: disable-msg=W0703
650 ToStderr("Can't load new cluster domain secret from %s: %s" %
651 (cds_filename, str(err)))
657 usertext = ("This requires all daemons on all nodes to be restarted and"
658 " may take some time. Continue?")
659 if not AskUser(usertext):
662 def _RenewCryptoInner(ctx):
663 ctx.feedback_fn("Updating certificates and keys")
664 bootstrap.GenerateClusterCrypto(new_cluster_cert, new_rapi_cert,
667 rapi_cert_pem=rapi_cert_pem,
673 files_to_copy.append(constants.NODED_CERT_FILE)
675 if new_rapi_cert or rapi_cert_pem:
676 files_to_copy.append(constants.RAPI_CERT_FILE)
678 if new_confd_hmac_key:
679 files_to_copy.append(constants.CONFD_HMAC_KEY)
682 files_to_copy.append(constants.CLUSTER_DOMAIN_SECRET_FILE)
685 for node_name in ctx.nonmaster_nodes:
686 ctx.feedback_fn("Copying %s to %s" %
687 (", ".join(files_to_copy), node_name))
688 for file_name in files_to_copy:
689 ctx.ssh.CopyFileToNode(node_name, file_name)
691 RunWhileClusterStopped(ToStdout, _RenewCryptoInner)
693 ToStdout("All requested certificates and keys have been replaced."
694 " Running \"gnt-cluster verify\" now is recommended.")
699 def RenewCrypto(opts, args):
700 """Renews cluster certificates, keys and secrets.
703 return _RenewCrypto(opts.new_cluster_cert,
706 opts.new_confd_hmac_key,
707 opts.new_cluster_domain_secret,
708 opts.cluster_domain_secret,
712 def SetClusterParams(opts, args):
713 """Modify the cluster.
715 @param opts: the command line options selected by the user
717 @param args: should be an empty list
719 @return: the desired exit code
722 if not (not opts.lvm_storage or opts.vg_name or
723 not opts.drbd_storage or opts.drbd_helper or
724 opts.enabled_hypervisors or opts.hvparams or
725 opts.beparams or opts.nicparams or opts.ndparams or
726 opts.candidate_pool_size is not None or
727 opts.uid_pool is not None or
728 opts.maintain_node_health is not None or
729 opts.add_uids is not None or
730 opts.remove_uids is not None or
731 opts.default_iallocator is not None or
732 opts.reserved_lvs is not None or
733 opts.master_netdev is not None or
734 opts.prealloc_wipe_disks is not None):
735 ToStderr("Please give at least one of the parameters.")
738 vg_name = opts.vg_name
739 if not opts.lvm_storage and opts.vg_name:
740 ToStderr("Options --no-lvm-storage and --vg-name conflict.")
743 if not opts.lvm_storage:
746 drbd_helper = opts.drbd_helper
747 if not opts.drbd_storage and opts.drbd_helper:
748 ToStderr("Options --no-drbd-storage and --drbd-usermode-helper conflict.")
751 if not opts.drbd_storage:
754 hvlist = opts.enabled_hypervisors
755 if hvlist is not None:
756 hvlist = hvlist.split(",")
758 # a list of (name, dict) we can pass directly to dict() (or [])
759 hvparams = dict(opts.hvparams)
760 for hv_params in hvparams.values():
761 utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
763 beparams = opts.beparams
764 utils.ForceDictType(beparams, constants.BES_PARAMETER_TYPES)
766 nicparams = opts.nicparams
767 utils.ForceDictType(nicparams, constants.NICS_PARAMETER_TYPES)
769 ndparams = opts.ndparams
770 if ndparams is not None:
771 utils.ForceDictType(ndparams, constants.NDS_PARAMETER_TYPES)
773 mnh = opts.maintain_node_health
775 uid_pool = opts.uid_pool
776 if uid_pool is not None:
777 uid_pool = uidpool.ParseUidPool(uid_pool)
779 add_uids = opts.add_uids
780 if add_uids is not None:
781 add_uids = uidpool.ParseUidPool(add_uids)
783 remove_uids = opts.remove_uids
784 if remove_uids is not None:
785 remove_uids = uidpool.ParseUidPool(remove_uids)
787 if opts.reserved_lvs is not None:
788 if opts.reserved_lvs == "":
789 opts.reserved_lvs = []
791 opts.reserved_lvs = utils.UnescapeAndSplit(opts.reserved_lvs, sep=",")
793 op = opcodes.OpClusterSetParams(vg_name=vg_name,
794 drbd_helper=drbd_helper,
795 enabled_hypervisors=hvlist,
801 candidate_pool_size=opts.candidate_pool_size,
802 maintain_node_health=mnh,
805 remove_uids=remove_uids,
806 default_iallocator=opts.default_iallocator,
807 prealloc_wipe_disks=opts.prealloc_wipe_disks,
808 master_netdev=opts.master_netdev,
809 reserved_lvs=opts.reserved_lvs)
810 SubmitOpCode(op, opts=opts)
814 def QueueOps(opts, args):
817 @param opts: the command line options selected by the user
819 @param args: should contain only one element, the subcommand
821 @return: the desired exit code
826 if command in ("drain", "undrain"):
827 drain_flag = command == "drain"
828 client.SetQueueDrainFlag(drain_flag)
829 elif command == "info":
830 result = client.QueryConfigValues(["drain_flag"])
835 ToStdout("The drain flag is %s" % val)
837 raise errors.OpPrereqError("Command '%s' is not valid." % command,
843 def _ShowWatcherPause(until):
844 if until is None or until < time.time():
845 ToStdout("The watcher is not paused.")
847 ToStdout("The watcher is paused until %s.", time.ctime(until))
850 def WatcherOps(opts, args):
851 """Watcher operations.
853 @param opts: the command line options selected by the user
855 @param args: should contain only one element, the subcommand
857 @return: the desired exit code
863 if command == "continue":
864 client.SetWatcherPause(None)
865 ToStdout("The watcher is no longer paused.")
867 elif command == "pause":
869 raise errors.OpPrereqError("Missing pause duration", errors.ECODE_INVAL)
871 result = client.SetWatcherPause(time.time() + ParseTimespec(args[1]))
872 _ShowWatcherPause(result)
874 elif command == "info":
875 result = client.QueryConfigValues(["watcher_pause"])
876 _ShowWatcherPause(result[0])
879 raise errors.OpPrereqError("Command '%s' is not valid." % command,
887 InitCluster, [ArgHost(min=1, max=1)],
888 [BACKEND_OPT, CP_SIZE_OPT, ENABLED_HV_OPT, GLOBAL_FILEDIR_OPT,
889 HVLIST_OPT, MAC_PREFIX_OPT, MASTER_NETDEV_OPT, NIC_PARAMS_OPT,
890 NOLVM_STORAGE_OPT, NOMODIFY_ETCHOSTS_OPT, NOMODIFY_SSH_SETUP_OPT,
891 SECONDARY_IP_OPT, VG_NAME_OPT, MAINTAIN_NODE_HEALTH_OPT,
892 UIDPOOL_OPT, DRBD_HELPER_OPT, NODRBD_STORAGE_OPT,
893 DEFAULT_IALLOCATOR_OPT, PRIMARY_IP_VERSION_OPT, PREALLOC_WIPE_DISKS_OPT,
895 "[opts...] <cluster_name>", "Initialises a new cluster configuration"),
897 DestroyCluster, ARGS_NONE, [YES_DOIT_OPT],
898 "", "Destroy cluster"),
900 RenameCluster, [ArgHost(min=1, max=1)],
901 [FORCE_OPT, DRY_RUN_OPT],
903 "Renames the cluster"),
905 RedistributeConfig, ARGS_NONE, [SUBMIT_OPT, DRY_RUN_OPT, PRIORITY_OPT],
906 "", "Forces a push of the configuration file and ssconf files"
907 " to the nodes in the cluster"),
909 VerifyCluster, ARGS_NONE,
910 [VERBOSE_OPT, DEBUG_SIMERR_OPT, ERROR_CODES_OPT, NONPLUS1_OPT,
911 DRY_RUN_OPT, PRIORITY_OPT],
912 "", "Does a check on the cluster configuration"),
914 VerifyDisks, ARGS_NONE, [PRIORITY_OPT],
915 "", "Does a check on the cluster disk status"),
916 'repair-disk-sizes': (
917 RepairDiskSizes, ARGS_MANY_INSTANCES, [DRY_RUN_OPT, PRIORITY_OPT],
918 "", "Updates mismatches in recorded disk sizes"),
920 MasterFailover, ARGS_NONE, [NOVOTING_OPT],
921 "", "Makes the current node the master"),
923 MasterPing, ARGS_NONE, [],
924 "", "Checks if the master is alive"),
926 ShowClusterVersion, ARGS_NONE, [],
927 "", "Shows the cluster version"),
929 ShowClusterMaster, ARGS_NONE, [],
930 "", "Shows the cluster master"),
932 ClusterCopyFile, [ArgFile(min=1, max=1)],
933 [NODE_LIST_OPT, USE_REPL_NET_OPT],
934 "[-n node...] <filename>", "Copies a file to all (or only some) nodes"),
936 RunClusterCommand, [ArgCommand(min=1)],
938 "[-n node...] <command>", "Runs a command on all (or only some) nodes"),
940 ShowClusterConfig, ARGS_NONE, [ROMAN_OPT],
941 "[--roman]", "Show cluster configuration"),
943 ListTags, ARGS_NONE, [], "", "List the tags of the cluster"),
945 AddTags, [ArgUnknown()], [TAG_SRC_OPT, PRIORITY_OPT],
946 "tag...", "Add tags to the cluster"),
948 RemoveTags, [ArgUnknown()], [TAG_SRC_OPT, PRIORITY_OPT],
949 "tag...", "Remove tags from the cluster"),
951 SearchTags, [ArgUnknown(min=1, max=1)], [PRIORITY_OPT], "",
952 "Searches the tags on all objects on"
953 " the cluster for a given pattern (regex)"),
956 [ArgChoice(min=1, max=1, choices=["drain", "undrain", "info"])],
957 [], "drain|undrain|info", "Change queue properties"),
960 [ArgChoice(min=1, max=1, choices=["pause", "continue", "info"]),
961 ArgSuggest(min=0, max=1, choices=["30m", "1h", "4h"])],
963 "{pause <timespec>|continue|info}", "Change watcher properties"),
965 SetClusterParams, ARGS_NONE,
966 [BACKEND_OPT, CP_SIZE_OPT, ENABLED_HV_OPT, HVLIST_OPT, MASTER_NETDEV_OPT,
967 NIC_PARAMS_OPT, NOLVM_STORAGE_OPT, VG_NAME_OPT, MAINTAIN_NODE_HEALTH_OPT,
968 UIDPOOL_OPT, ADD_UIDS_OPT, REMOVE_UIDS_OPT, DRBD_HELPER_OPT,
969 NODRBD_STORAGE_OPT, DEFAULT_IALLOCATOR_OPT, RESERVED_LVS_OPT,
970 DRY_RUN_OPT, PRIORITY_OPT, PREALLOC_WIPE_DISKS_OPT, NODE_PARAMS_OPT],
972 "Alters the parameters of the cluster"),
974 RenewCrypto, ARGS_NONE,
975 [NEW_CLUSTER_CERT_OPT, NEW_RAPI_CERT_OPT, RAPI_CERT_OPT,
976 NEW_CONFD_HMAC_KEY_OPT, FORCE_OPT,
977 NEW_CLUSTER_DOMAIN_SECRET_OPT, CLUSTER_DOMAIN_SECRET_OPT],
979 "Renews cluster certificates, keys and secrets"),
983 #: dictionary with aliases for commands
985 'masterfailover': 'master-failover',
990 return GenericMain(commands, override={"tag_type": constants.TAG_CLUSTER},