Class HooksMaster

Base class for hooks masters.

This class invokes the execution of hooks according to the behaviour specified by its parameters.

Parameters:

• opcode (string) - opcode of the operation to which the hooks are tied
• hooks_path (string) - prefix of the hooks directories
• nodes (2-tuple of lists) - 2-tuple of lists containing nodes on which pre-hooks must be run and nodes on which post-hooks must be run
• hooks_execution_fn (function that accepts the following parameters: (node_list, hooks_path, phase, environment)) - function that will execute the hooks; can be None, indicating that no conversion is necessary.
• hooks_results_adapt_fn (function) - function that will adapt the return value of hooks_execution_fn to the format expected by RunPhase
• build_env_fn (function that returns a dictionary having strings as keys) - function that builds the environment for the hooks
• prepare_post_nodes_fn (function that take a list of node UUIDs and returns a list of node UUIDs) - function that is invoked right before executing post hooks and can change the list of node UUIDs to run the post hooks on
• log_fn (function that accepts a string) - logging function
• htype (string or None) - None or one of constants.HTYPE_CLUSTER, constants.HTYPE_NODE, constants.HTYPE_INSTANCE
• cluster_name (string) - name of the cluster
• master_name (string) - name of the master

Overrides: object.__init__

Run all the scripts for a phase.

This is the main function of the HookMaster. It executes self.hooks_execution_fn, and after running self.hooks_results_adapt_fn on its results it expects them to be in the form {node_name: (fail_msg, [(script, result, output), ...]}).

Parameters:

• phase - one of constants.HOOKS_PHASE_POST or constants.HOOKS_PHASE_PRE; it denotes the hooks phase
• node_names - overrides the predefined list of nodes for the given phase

Returns:

the processed results of the hooks multi-node rpc call

Raises:

• errors.HooksFailure - on communication failure to the nodes
• errors.HooksAbort - on failure of one of the hooks

Run the special configuration update hook

This is a special hook that runs only on the master after each top-level LI if the configuration has been updated.