All documentation provided in README.md Implements blueprint fencing-in-puppet-manifests * Use Fuel corosync from 5.1.1 * Add cluster-recheck-interval 3 min setting * Add parser functions and facts from Fuel library * Add pre-build hook for dependencies: * puppetlabs/stdlib v 4.5.0 * Fuel corosync v 5.1.1 * Add examples of YAML for fence_virsh, fence_ipmilan, fence_apc_snmp and fence topology Change-Id: I15dc9ff747957f7d22ca3ccd12628423c3c5c8cc Signed-off-by: Bogdan Dobrelya <bdobrelia@mirantis.com>
2.6 KiB
pcs_fencing
Table of Contents
- Overview - What is the pcs_fencing module?
- Module Description - What does the module do?
- Setup - The basics of getting started with pcs_fencing
- Implementation - An under-the-hood peek at what the module is doing
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- Contributors - Those with commits
- Release Notes - Notes on the most recent updates to the module
Overview
TODO(bogdando) provide a link to Fuel plugin repo then ready. The pcs_fencing module is a part of Fencing plugin for Fuel and have no a separate code repository. The module itself is used to configure fencing primitives in Pacemaker and combine them into the Fencing topology.
Module Description
The pcs_fencing module is intended to provide STONITH based HA fencing of the failed nodes in Corosync & Pacemaker cluster. This module cannot be used separately from Fuel Fencing plugin. Pcs_fencing module operates the data structures which are tight to the ones in Fuel YAML configuration file and has no its own parameters. This module also installs fence-agents package and assumes there is the one avaiable in the OS repositories.
Setup
Installing pcs_fencing
This module is being installed automatically as a part of Fuel Fencing plugin. The module's rspec tests could be run only after the plugin is built as its pre build hook will download required Fuel custom puppet module for corosync and puppetlabs/stdlib module.
Beginning with pcs_fencing
Instructions for beginning with pcs_fencing will be added later.
Implementation
pcs_fencing
pcs_fencing is a combination of Puppet manifest and ruby code to delivery configuration and extra functionality through custom types, providers, parser functions and facts from Fuel library of puppet manifests. Note that it requires a custom module for corosync and includes a custom provider for fencing topology.
Limitations
Limitations will be added as they are discovered.
Development
Developer documentation for the entire Fuel project.
Contributors
Will be added later
Versioning
This module is being versioned as well as Fuel Fencing plugin.
Release Notes
This module has no a separate release notes. See the release notes for Fuel Fencing plugin.