Adds a node to the cluster.
:directory: node-add
-:env. vars: NODE_NAME, NODE_PIP, NODE_SIP
+:env. vars: NODE_NAME, NODE_PIP, NODE_SIP, MASTER_CAPABLE, VM_CAPABLE
:pre-execution: all existing nodes
:post-execution: all nodes plus the new node
Changes a node's parameters.
:directory: node-modify
-:env. vars: MASTER_CANDIDATE, OFFLINE, DRAINED
+:env. vars: MASTER_CANDIDATE, OFFLINE, DRAINED, MASTER_CAPABLE, VM_CAPABLE
:pre-execution: master node, the target node
:post-execution: master node, the target node
:pre-execution: master node
:post-execution: master node
+OP_GROUP_SET_PARAMS
++++++++++++++++++++
+
+Changes a node group's parameters.
+
+:directory: group-modify
+:env. vars: GROUP_NAME, NEW_ALLOC_POLICY
+:pre-execution: master node
+:post-execution: master node
+
+OP_REMOVE_GROUP
++++++++++++++++
+
+Removes a node group from the cluster. Since the node group must be
+empty for removal to succeed, the concept of "nodes in the group" does
+not exist, and the hook is only executed in the master node.
+
+:directory: group-remove
+:env. vars: GROUP_NAME
+:pre-execution: master node
+:post-execution: master node
+
+OP_RENAME_GROUP
++++++++++++++++
+
+Renames a node group.
+
+:directory: group-rename
+:env. vars: OLD_NAME, NEW_NAME
+:pre-execution: master node and all nodes in the group
+:post-execution: master node and all nodes in the group
+
Instance operations
~~~~~~~~~~~~~~~~~~~
All instance operations take at least the following variables:
-INSTANCE_NAME, INSTANCE_PRIMARY, INSTANCE_SECONDARIES,
+INSTANCE_NAME, INSTANCE_PRIMARY, INSTANCE_SECONDARY,
INSTANCE_OS_TYPE, INSTANCE_DISK_TEMPLATE, INSTANCE_MEMORY,
INSTANCE_DISK_SIZES, INSTANCE_VCPUS, INSTANCE_NIC_COUNT,
INSTANCE_NICn_IP, INSTANCE_NICn_BRIDGE, INSTANCE_NICn_MAC,
Exports the instance.
:directory: instance-export
-:env. vars: EXPORT_NODE, EXPORT_DO_SHUTDOWN
+:env. vars: EXPORT_MODE, EXPORT_NODE, EXPORT_DO_SHUTDOWN, REMOVE_INSTANCE
:pre-execution: master node, primary and secondary nodes
:post-execution: master node, primary and secondary nodes
-OP_INSTANCE_START
-+++++++++++++++++
+OP_INSTANCE_STARTUP
++++++++++++++++++++
Starts an instance.
Stops an instance.
:directory: instance-stop
-:env. vars: only the standard instance vars
+:env. vars: TIMEOUT
:pre-execution: master node, primary and secondary nodes
:post-execution: master node, primary and secondary nodes
Reboots an instance.
:directory: instance-reboot
-:env. vars: IGNORE_SECONDARIES, REBOOT_TYPE
+:env. vars: IGNORE_SECONDARIES, REBOOT_TYPE, SHUTDOWN_TIMEOUT
:pre-execution: master node, primary and secondary nodes
:post-execution: master node, primary and secondary nodes
-OP_INSTANCE_MODIFY
-++++++++++++++++++
+OP_INSTANCE_SET_PARAMS
+++++++++++++++++++++++
Modifies the instance parameters.
:directory: instance-modify
-:env. vars: only the standard instance vars
+:env. vars: NEW_DISK_TEMPLATE
:pre-execution: master node, primary and secondary nodes
:post-execution: master node, primary and secondary nodes
++++++++++++++++++++
Failovers an instance. In the post phase INSTANCE_PRIMARY and
-INSTANCE_SECONDARIES refer to the nodes that were repectively primary
+INSTANCE_SECONDARY refer to the nodes that were repectively primary
and secondary before failover.
:directory: instance-failover
-:env. vars: IGNORE_CONSISTENCY, OLD_SECONDARY, OLD_PRIMARY, NEW_SECONDARY, NEW_PRIMARY
+:env. vars: IGNORE_CONSISTENCY, SHUTDOWN_TIMEOUT, OLD_PRIMARY, OLD_SECONDARY, NEW_PRIMARY, NEW_SECONDARY
:pre-execution: master node, secondary node
:post-execution: master node, primary and secondary nodes
++++++++++++++++++++
Migrates an instance. In the post phase INSTANCE_PRIMARY and
-INSTANCE_SECONDARIES refer to the nodes that were repectively primary
+INSTANCE_SECONDARY refer to the nodes that were repectively primary
and secondary before migration.
:directory: instance-migrate
-:env. vars: MIGRATE_LIVE, MIGRATE_CLEANUP, OLD_SECONDARY, OLD_PRIMARY, NEW_SECONDARY, NEW_PRIMARY
+:env. vars: MIGRATE_LIVE, MIGRATE_CLEANUP, OLD_PRIMARY, OLD_SECONDARY, NEW_PRIMARY, NEW_SECONDARY
:pre-execution: master node, secondary node
:post-execution: master node, primary and secondary nodes
Remove an instance.
:directory: instance-remove
-:env. vars: only the standard instance vars
+:env. vars: SHUTDOWN_TIMEOUT
:pre-execution: master node
:post-execution: master node, primary and secondary nodes
Move an instance by data-copying.
:directory: instance-move
-:env. vars: TARGET_NODE
+:env. vars: TARGET_NODE, SHUTDOWN_TIMEOUT
:pre-execution: master node, primary and target nodes
:post-execution: master node, primary and target nodes
INSTANCE_NAME
The name of the instance which is the target of the operation.
+INSTANCE_BE_x,y,z,...
+ Instance BE params. There is one variable per BE param. For instance, GANETI_INSTANCE_BE_auto_balance
+
INSTANCE_DISK_TEMPLATE
The disk type for the instance.
+NEW_DISK_TEMPLATE
+ The new disk type for the instance.
+
INSTANCE_DISK_COUNT
The number of disks for the instance.
INSTANCE_DISKn_MODE
Either *rw* for a read-write disk or *ro* for a read-only one.
+INSTANCE_HV_x,y,z,...
+ Instance hypervisor options. There is one variable per option. For instance, GANETI_INSTANCE_HV_use_bootloader
+
+INSTANCE_HYPERVISOR
+ The instance hypervisor.
+
INSTANCE_NIC_COUNT
The number of NICs for the instance.
INSTANCE_NICn_MAC
The MAC address of the *n* -th NIC of the instance.
+INSTANCE_NICn_MODE
+ The mode of the *n* -th NIC of the instance.
+
INSTANCE_OS_TYPE
The name of the instance OS.
the nodes change during the exectution, but on the
OLD_PRIMARY/NEW_PRIMARY values.
-INSTANCE_SECONDARIES
+INSTANCE_SECONDARY
Space-separated list of secondary nodes for the instance. Note that
for migrations/failovers, you shouldn't rely on this variable since
the nodes change during the exectution, but on the
INSTANCE_STATUS
The run status of the instance.
+MASTER_CAPABLE
+ Whether a node is capable of being promoted to master.
+
+VM_CAPABLE
+ Whether the node can host instances.
+
NODE_NAME
The target node of this operation (not the node on which the hook
runs).
For migrations/failovers, the old and respectively new primary
nodes. These two mirror the NEW_SECONDARY/OLD_SECONDARY variables
+EXPORT_MODE
+ The instance export mode. Either "remote" or "local".
+
EXPORT_NODE
The node on which the exported image of the instance was done.
the filesystem would need a check (journal replay or full fsck) in
order to guarantee consistency.
+REMOVE_INSTANCE
+ Whether the instance was removed from the node.
+
+SHUTDOWN_TIMEOUT
+ Amount of time to wait for the instance to shutdown.
+
+TIMEOUT
+ Amount of time to wait before aborting the op.
+
+OLD_NAME, NEW_NAME
+ Old/new name of the node group.
+
+GROUP_NAME
+ The name of the node group.
+
+NEW_ALLOC_POLICY
+ The new allocation policy for the node group.
+
CLUSTER_TAGS
The list of cluster tags, space separated.
GANETI_INSTANCE_NIC_COUNT=1
GANETI_INSTANCE_OS_TYPE=debootstrap
GANETI_INSTANCE_PRIMARY=node3.example.com
- GANETI_INSTANCE_SECONDARIES=node5.example.com
+ GANETI_INSTANCE_SECONDARY=node5.example.com
GANETI_INSTANCE_STATUS=down
GANETI_INSTANCE_VCPUS=1
GANETI_MASTER=node1.example.com
projects / ganeti-local / blobdiff