__slots__ attribute for this class.
"""
+ slots = self._all_slots()
for key in kwargs:
- if key not in self.__slots__:
+ if key not in slots:
raise TypeError("Object %s doesn't support the parameter '%s'" %
(self.__class__.__name__, key))
setattr(self, key, kwargs[key])
"""
state = {}
- for name in self.__slots__:
+ for name in self._all_slots():
if hasattr(self, name):
state[name] = getattr(self, name)
return state
raise ValueError("Invalid data to __setstate__: expected dict, got %s" %
type(state))
- for name in self.__slots__:
- if name not in state:
+ for name in self._all_slots():
+ if name not in state and hasattr(self, name):
delattr(self, name)
for name in state:
setattr(self, name, state[name])
+ @classmethod
+ def _all_slots(cls):
+ """Compute the list of all declared slots for a class.
+
+ """
+ slots = []
+ for parent in cls.__mro__:
+ slots.extend(getattr(parent, "__slots__", []))
+ return slots
+
class OpCode(BaseOpCode):
"""Abstract OpCode.
from this class should override OP_ID.
@cvar OP_ID: The ID of this opcode. This should be unique amongst all
- childre of this class.
+ children of this class.
+ @ivar dry_run: Whether the LU should be run in dry-run mode, i.e. just
+ the check steps
"""
OP_ID = "OP_ABSTRACT"
- __slots__ = []
+ __slots__ = ["dry_run", "debug_level"]
def __getstate__(self):
"""Specialized getstate for opcodes.
raise ValueError("Invalid data to LoadOpcode, missing OP_ID")
op_id = data["OP_ID"]
op_class = None
- for item in globals().values():
- if (isinstance(item, type) and
- issubclass(item, cls) and
- hasattr(item, "OP_ID") and
- getattr(item, "OP_ID") == op_id):
- op_class = item
- break
- if op_class is None:
+ if op_id in OP_MAPPING:
+ op_class = OP_MAPPING[op_id]
+ else:
raise ValueError("Invalid data to LoadOpCode: OP_ID %s unsupported" %
op_id)
op = op_class()
op.__setstate__(new_data)
return op
+ def Summary(self):
+ """Generates a summary description of this opcode.
+
+ """
+ # all OP_ID start with OP_, we remove that
+ txt = self.OP_ID[3:]
+ field_name = getattr(self, "OP_DSC_FIELD", None)
+ if field_name:
+ field_value = getattr(self, field_name, None)
+ txt = "%s(%s)" % (txt, field_value)
+ return txt
+
+
+# cluster opcodes
+
+class OpPostInitCluster(OpCode):
+ """Post cluster initialization.
+
+ This opcode does not touch the cluster at all. Its purpose is to run hooks
+ after the cluster has been initialized.
+
+ """
+ OP_ID = "OP_CLUSTER_POST_INIT"
+ __slots__ = []
+
class OpDestroyCluster(OpCode):
"""Destroy the cluster.
"""
OP_ID = "OP_CLUSTER_VERIFY"
- __slots__ = ["skip_checks"]
+ __slots__ = ["skip_checks", "verbose", "error_codes",
+ "debug_simulate_errors"]
class OpVerifyDisks(OpCode):
Parameters: none
- Result: two lists:
+ Result: a tuple of four elements:
- list of node names with bad data returned (unreachable, etc.)
- dict of node names with broken volume groups (values: error msg)
- list of instances with degraded disks (that should be activated)
__slots__ = []
-class OpDumpClusterConfig(OpCode):
- """Dump the cluster configuration."""
- OP_ID = "OP_CLUSTER_DUMPCONFIG"
- __slots__ = []
+class OpRepairDiskSizes(OpCode):
+ """Verify the disk sizes of the instances and fixes configuration
+ mimatches.
+
+ Parameters: optional instances list, in case we want to restrict the
+ checks to only a subset of the instances.
+
+ Result: a list of tuples, (instance, disk, new-size) for changed
+ configurations.
+
+ In normal operation, the list should be empty.
+
+ @type instances: list
+ @ivar instances: the list of instances to check, or empty for all instances
+
+ """
+ OP_ID = "OP_CLUSTER_REPAIR_DISK_SIZES"
+ __slots__ = ["instances"]
+
+
+class OpQueryConfigValues(OpCode):
+ """Query cluster configuration values."""
+ OP_ID = "OP_CLUSTER_CONFIG_QUERY"
+ __slots__ = ["output_fields"]
class OpRenameCluster(OpCode):
"""
OP_ID = "OP_CLUSTER_RENAME"
+ OP_DSC_FIELD = "name"
__slots__ = ["name"]
"""
OP_ID = "OP_CLUSTER_SET_PARAMS"
- __slots__ = ["vg_name"]
+ __slots__ = [
+ "vg_name",
+ "enabled_hypervisors",
+ "hvparams",
+ "os_hvp",
+ "beparams",
+ "nicparams",
+ "candidate_pool_size",
+ "maintain_node_health",
+ "uid_pool",
+ "add_uids",
+ "remove_uids",
+ ]
+
+class OpRedistributeConfig(OpCode):
+ """Force a full push of the cluster configuration.
+
+ """
+ OP_ID = "OP_CLUSTER_REDIST_CONF"
+ __slots__ = []
# node opcodes
"""
OP_ID = "OP_NODE_REMOVE"
+ OP_DSC_FIELD = "node_name"
__slots__ = ["node_name"]
"""
OP_ID = "OP_NODE_ADD"
+ OP_DSC_FIELD = "node_name"
__slots__ = ["node_name", "primary_ip", "secondary_ip", "readd"]
class OpQueryNodes(OpCode):
"""Compute the list of nodes."""
OP_ID = "OP_NODE_QUERY"
- __slots__ = ["output_fields", "names"]
+ __slots__ = ["output_fields", "names", "use_locking"]
class OpQueryNodeVolumes(OpCode):
__slots__ = ["nodes", "output_fields"]
+class OpQueryNodeStorage(OpCode):
+ """Get information on storage for node(s)."""
+ OP_ID = "OP_NODE_QUERY_STORAGE"
+ __slots__ = [
+ "nodes",
+ "storage_type",
+ "name",
+ "output_fields",
+ ]
+
+
+class OpModifyNodeStorage(OpCode):
+ """Modifies the properies of a storage unit"""
+ OP_ID = "OP_NODE_MODIFY_STORAGE"
+ __slots__ = [
+ "node_name",
+ "storage_type",
+ "name",
+ "changes",
+ ]
+
+
+class OpRepairNodeStorage(OpCode):
+ """Repairs the volume group on a node."""
+ OP_ID = "OP_REPAIR_NODE_STORAGE"
+ OP_DSC_FIELD = "node_name"
+ __slots__ = [
+ "node_name",
+ "storage_type",
+ "name",
+ "ignore_consistency",
+ ]
+
+
+class OpSetNodeParams(OpCode):
+ """Change the parameters of a node."""
+ OP_ID = "OP_NODE_SET_PARAMS"
+ OP_DSC_FIELD = "node_name"
+ __slots__ = [
+ "node_name",
+ "force",
+ "master_candidate",
+ "offline",
+ "drained",
+ "auto_promote",
+ ]
+
+
+class OpPowercycleNode(OpCode):
+ """Tries to powercycle a node."""
+ OP_ID = "OP_NODE_POWERCYCLE"
+ OP_DSC_FIELD = "node_name"
+ __slots__ = [
+ "node_name",
+ "force",
+ ]
+
+
+class OpEvacuateNode(OpCode):
+ """Relocate secondary instances from a node."""
+ OP_ID = "OP_NODE_EVACUATE"
+ OP_DSC_FIELD = "node_name"
+ __slots__ = [
+ "node_name", "remote_node", "iallocator", "early_release",
+ ]
+
+
+class OpMigrateNode(OpCode):
+ """Migrate all instances from a node."""
+ OP_ID = "OP_NODE_MIGRATE"
+ OP_DSC_FIELD = "node_name"
+ __slots__ = [
+ "node_name",
+ "live",
+ ]
+
+
+class OpNodeEvacuationStrategy(OpCode):
+ """Compute the evacuation strategy for a list of nodes."""
+ OP_ID = "OP_NODE_EVAC_STRATEGY"
+ OP_DSC_FIELD = "nodes"
+ __slots__ = ["nodes", "iallocator", "remote_node"]
+
+
# instance opcodes
class OpCreateInstance(OpCode):
"""Create an instance."""
OP_ID = "OP_INSTANCE_CREATE"
+ OP_DSC_FIELD = "instance_name"
__slots__ = [
- "instance_name", "mem_size", "disk_size", "os_type", "pnode",
- "disk_template", "snode", "swap_size", "mode",
- "vcpus", "ip", "bridge", "src_node", "src_path", "start",
- "wait_for_sync", "ip_check", "mac",
- "kernel_path", "initrd_path", "hvm_boot_order", "hvm_acpi",
- "hvm_pae", "hvm_cdrom_image_path", "vnc_bind_address",
+ "instance_name",
+ "os_type", "force_variant", "no_install",
+ "pnode", "disk_template", "snode", "mode",
+ "disks", "nics",
+ "src_node", "src_path", "start", "identify_defaults",
+ "wait_for_sync", "ip_check", "name_check",
"file_storage_dir", "file_driver",
- "iallocator", "hvm_nic_type", "hvm_disk_type",
+ "iallocator",
+ "hypervisor", "hvparams", "beparams",
+ "dry_run",
]
class OpReinstallInstance(OpCode):
"""Reinstall an instance's OS."""
OP_ID = "OP_INSTANCE_REINSTALL"
- __slots__ = ["instance_name", "os_type"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = ["instance_name", "os_type", "force_variant"]
class OpRemoveInstance(OpCode):
"""Remove an instance."""
OP_ID = "OP_INSTANCE_REMOVE"
- __slots__ = ["instance_name", "ignore_failures"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name",
+ "ignore_failures",
+ "shutdown_timeout",
+ ]
class OpRenameInstance(OpCode):
"""Rename an instance."""
OP_ID = "OP_INSTANCE_RENAME"
- __slots__ = ["instance_name", "ignore_ip", "new_name"]
+ __slots__ = [
+ "instance_name", "ignore_ip", "new_name",
+ ]
class OpStartupInstance(OpCode):
"""Startup an instance."""
OP_ID = "OP_INSTANCE_STARTUP"
- __slots__ = ["instance_name", "force", "extra_args"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "force", "hvparams", "beparams",
+ ]
class OpShutdownInstance(OpCode):
"""Shutdown an instance."""
OP_ID = "OP_INSTANCE_SHUTDOWN"
- __slots__ = ["instance_name"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = ["instance_name", "timeout"]
class OpRebootInstance(OpCode):
"""Reboot an instance."""
OP_ID = "OP_INSTANCE_REBOOT"
- __slots__ = ["instance_name", "reboot_type", "extra_args",
- "ignore_secondaries" ]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "reboot_type", "ignore_secondaries", "shutdown_timeout",
+ ]
class OpReplaceDisks(OpCode):
"""Replace the disks of an instance."""
OP_ID = "OP_INSTANCE_REPLACE_DISKS"
- __slots__ = ["instance_name", "remote_node", "mode", "disks", "iallocator"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "remote_node", "mode", "disks", "iallocator",
+ "early_release",
+ ]
class OpFailoverInstance(OpCode):
"""Failover an instance."""
OP_ID = "OP_INSTANCE_FAILOVER"
- __slots__ = ["instance_name", "ignore_consistency"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "ignore_consistency", "shutdown_timeout",
+ ]
+
+
+class OpMigrateInstance(OpCode):
+ """Migrate an instance.
+
+ This migrates (without shutting down an instance) to its secondary
+ node.
+
+ @ivar instance_name: the name of the instance
+
+ """
+ OP_ID = "OP_INSTANCE_MIGRATE"
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = ["instance_name", "live", "cleanup"]
+
+
+class OpMoveInstance(OpCode):
+ """Move an instance.
+
+ This move (with shutting down an instance and data copying) to an
+ arbitrary node.
+
+ @ivar instance_name: the name of the instance
+ @ivar target_node: the destination node
+
+ """
+ OP_ID = "OP_INSTANCE_MOVE"
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "target_node", "shutdown_timeout",
+ ]
class OpConnectConsole(OpCode):
"""Connect to an instance's console."""
OP_ID = "OP_INSTANCE_CONSOLE"
+ OP_DSC_FIELD = "instance_name"
__slots__ = ["instance_name"]
class OpActivateInstanceDisks(OpCode):
"""Activate an instance's disks."""
OP_ID = "OP_INSTANCE_ACTIVATE_DISKS"
- __slots__ = ["instance_name"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = ["instance_name", "ignore_size"]
class OpDeactivateInstanceDisks(OpCode):
"""Deactivate an instance's disks."""
OP_ID = "OP_INSTANCE_DEACTIVATE_DISKS"
+ OP_DSC_FIELD = "instance_name"
__slots__ = ["instance_name"]
+class OpRecreateInstanceDisks(OpCode):
+ """Deactivate an instance's disks."""
+ OP_ID = "OP_INSTANCE_RECREATE_DISKS"
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = ["instance_name", "disks"]
+
+
class OpQueryInstances(OpCode):
"""Compute the list of instances."""
OP_ID = "OP_INSTANCE_QUERY"
- __slots__ = ["output_fields", "names"]
+ __slots__ = ["output_fields", "names", "use_locking"]
class OpQueryInstanceData(OpCode):
"""Compute the run-time status of instances."""
OP_ID = "OP_INSTANCE_QUERY_DATA"
- __slots__ = ["instances"]
+ __slots__ = ["instances", "static"]
class OpSetInstanceParams(OpCode):
"""Change the parameters of an instance."""
OP_ID = "OP_INSTANCE_SET_PARAMS"
+ OP_DSC_FIELD = "instance_name"
__slots__ = [
- "instance_name", "mem", "vcpus", "ip", "bridge", "mac",
- "kernel_path", "initrd_path", "hvm_boot_order", "hvm_acpi",
- "hvm_pae", "hvm_cdrom_image_path", "vnc_bind_address",
- "hvm_nic_type", "hvm_disk_type"
+ "instance_name",
+ "hvparams", "beparams", "force",
+ "nics", "disks", "disk_template",
+ "remote_node", "os_name", "force_variant",
]
class OpGrowDisk(OpCode):
"""Grow a disk of an instance."""
OP_ID = "OP_INSTANCE_GROW_DISK"
- __slots__ = ["instance_name", "disk", "amount"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "disk", "amount", "wait_for_sync",
+ ]
# OS opcodes
class OpQueryExports(OpCode):
"""Compute the list of exported images."""
OP_ID = "OP_BACKUP_QUERY"
- __slots__ = ["nodes"]
+ __slots__ = ["nodes", "use_locking"]
class OpExportInstance(OpCode):
"""Export an instance."""
OP_ID = "OP_BACKUP_EXPORT"
- __slots__ = ["instance_name", "target_node", "shutdown"]
+ OP_DSC_FIELD = "instance_name"
+ __slots__ = [
+ "instance_name", "target_node", "shutdown", "shutdown_timeout",
+ ]
class OpRemoveExport(OpCode):
"""Remove an instance's export."""
OP_ID = "OP_BACKUP_REMOVE"
+ OP_DSC_FIELD = "instance_name"
__slots__ = ["instance_name"]
class OpGetTags(OpCode):
"""Returns the tags of the given object."""
OP_ID = "OP_TAGS_GET"
+ OP_DSC_FIELD = "name"
__slots__ = ["kind", "name"]
class OpSearchTags(OpCode):
"""Searches the tags in the cluster for a given pattern."""
OP_ID = "OP_TAGS_SEARCH"
+ OP_DSC_FIELD = "pattern"
__slots__ = ["pattern"]
"""
OP_ID = "OP_TEST_DELAY"
+ OP_DSC_FIELD = "duration"
__slots__ = ["duration", "on_master", "on_nodes"]
"""
OP_ID = "OP_TEST_ALLOCATOR"
+ OP_DSC_FIELD = "allocator"
__slots__ = [
"direction", "mode", "allocator", "name",
"mem_size", "disks", "disk_template",
- "os", "tags", "nics", "vcpus",
+ "os", "tags", "nics", "vcpus", "hypervisor",
+ "evac_nodes",
]
+
+
+OP_MAPPING = dict([(v.OP_ID, v) for v in globals().values()
+ if (isinstance(v, type) and issubclass(v, OpCode) and
+ hasattr(v, "OP_ID"))])