Pacemaker Explained

Configuring Pacemaker Clusters

Abstract

This document definitively explains Pacemaker’s features and capabilities, particularly the XML syntax used in Pacemaker’s Cluster Information Base (CIB).

Table of Contents

• 1. Introduction
  • 1.1. The Scope of this Document
  • 1.2. What Is Pacemaker?
    • 1.2.1. Cluster Architecture
    • 1.2.2. Pacemaker Architecture
    • 1.2.3. Node Redundancy Designs
• 2. Host-Local Configuration
  • 2.1. Configuration Value Types
    • 2.1.1. Scores
  • 2.2. Local Options
• 3. Cluster-Wide Configuration
  • 3.1. Configuration Layout
  • 3.2. CIB Properties
  • 3.3. Cluster Options
• 4. Cluster Nodes
  • 4.1. Defining a Cluster Node
    • 4.1.1. Where Pacemaker Gets the Node Name
  • 4.2. Node Attributes
    • 4.2.1. Setting and querying node attributes
    • 4.2.2. Special node attributes
  • 4.3. Tracking Node Health
    • 4.3.1. Node Health Attributes
    • 4.3.2. Node Health Strategy
    • 4.3.3. Exempting a Resource from Health Restrictions
    • 4.3.4. Configuring Node Health Agents
• 5. Cluster Resources
  • 5.1. What is a Cluster Resource?
  • 5.2. Resource Standards
    • 5.2.1. Open Cluster Framework
    • 5.2.2. Systemd
    • 5.2.3. Linux Standard Base
    • 5.2.4. System Services
    • 5.2.5. STONITH
    • 5.2.6. Nagios Plugins
    • 5.2.7. Upstart
  • 5.3. Resource Properties
  • 5.4. Resource Options
    • 5.4.1. Resource Meta-Attributes
    • 5.4.2. Setting Global Defaults for Resource Meta-Attributes
    • 5.4.3. Resource Instance Attributes
• 6. Resource Operations
  • 6.1. Operation Properties
  • 6.2. Monitoring Resources for Failure
  • 6.3. Setting Global Defaults for Operations
  • 6.4. When Implicit Operations Take a Long Time
  • 6.5. Multiple Monitor Operations
  • 6.6. Disabling a Monitor Operation
  • 6.7. Specifying When Recurring Actions are Performed
  • 6.8. Handling Resource Failure
    • 6.8.1. Failure Counts
    • 6.8.2. Failure Response
  • 6.9. Reloading an Agent After a Definition Change
  • 6.10. Migrating Resources
• 7. Resource Constraints
  • 7.1. Deciding Which Nodes a Resource Can Run On
    • 7.1.1. Location Properties
    • 7.1.2. Asymmetrical “Opt-In” Clusters
    • 7.1.3. Symmetrical “Opt-Out” Clusters
    • 7.1.4. What if Two Nodes Have the Same Score
    • 7.1.5. Specifying locations using pattern matching
  • 7.2. Specifying the Order in which Resources Should Start/Stop
    • 7.2.1. Ordering Properties
    • 7.2.2. Optional and mandatory ordering
    • 7.2.3. Symmetric and asymmetric ordering
  • 7.3. Placing Resources Relative to other Resources
    • 7.3.1. Colocation Properties
    • 7.3.2. Mandatory Placement
    • 7.3.3. Advisory Placement
    • 7.3.4. Colocation by Node Attribute
    • 7.3.5. Colocation Influence
  • 7.4. Resource Sets
  • 7.5. Ordering Sets of Resources
    • 7.5.1. Ordered Set
    • 7.5.2. Ordering Multiple Sets
    • 7.5.3. Resource Set OR Logic
  • 7.6. Colocating Sets of Resources
  • 7.7. External Resource Dependencies
• 8. Fencing
  • 8.1. What Is Fencing?
  • 8.2. Why Is Fencing Necessary?
  • 8.3. Fence Devices
  • 8.4. Fence Agents
  • 8.5. When a Fence Device Can Be Used
  • 8.6. Limitations of Fencing Resources
  • 8.7. Special Meta-Attributes for Fencing Resources
  • 8.8. Special Instance Attributes for Fencing Resources
  • 8.9. Default Check Type
  • 8.10. Unfencing
  • 8.11. Fencing and Quorum
  • 8.12. Fencing Timeouts
  • 8.13. Fence Devices Dependent on Other Resources
  • 8.14. Configuring Fencing
    • 8.14.1. Example Fencing Configuration
  • 8.15. Fencing Topologies
    • 8.15.1. Example Dual-Layer, Dual-Device Fencing Topologies
  • 8.16. Remapping Reboots
• 9. Alerts
  • 9.1. Alert Agents
  • 9.2. Alert Recipients
  • 9.3. Alert Meta-Attributes
  • 9.4. Alert Instance Attributes
  • 9.5. Alert Filters
• 10. Rules
  • 10.1. Rule Options
  • 10.2. Rule Conditions and Contexts
  • 10.3. Date/Time Expressions
    • 10.3.1. Date Specifications
    • 10.3.2. Durations
    • 10.3.3. Example Date/Time Expressions
  • 10.4. Node Attribute Expressions
  • 10.5. Resource Type Expressions
    • 10.5.1. Example Resource Type Expressions
  • 10.6. Operation Type Expressions
    • 10.6.1. Example Operation Type Expressions
  • 10.7. Using Rules to Determine Resource Location
    • 10.7.1. Location Rules Based on Other Node Properties
    • 10.7.2. Using score-attribute Instead of score
    • 10.7.3. Specifying location scores using pattern submatches
  • 10.8. Using Rules to Define Options
    • 10.8.1. Using Rules to Control Resource Options
    • 10.8.2. Using Rules to Control Resource Defaults
    • 10.8.3. Using Rules to Control Cluster Options
• 11. Collective Resources
  • 11.1. Groups - A Syntactic Shortcut
    • 11.1.1. Group Properties
    • 11.1.2. Group Options
    • 11.1.3. Group Instance Attributes
    • 11.1.4. Group Contents
    • 11.1.5. Group Constraints
    • 11.1.6. Group Stickiness
  • 11.2. Clones - Resources That Can Have Multiple Active Instances
    • 11.2.1. Anonymous versus Unique Clones
    • 11.2.2. Promotable clones
    • 11.2.3. Clone Properties
    • 11.2.4. Clone Options
    • 11.2.5. Clone Contents
    • 11.2.6. Clone Instance Attribute
    • 11.2.7. Clone Constraints
    • 11.2.8. Clone Stickiness
    • 11.2.9. Monitoring Promotable Clone Resources
    • 11.2.10. Determining Which Instance is Promoted
  • 11.3. Bundles - Containerized Resources
    • 11.3.1. Bundle Prerequisites
    • 11.3.2. Bundle Properties
    • 11.3.3. Bundle Container Properties
    • 11.3.4. Bundle Network Properties
    • 11.3.5. Bundle Storage Properties
    • 11.3.6. Bundle Primitive
    • 11.3.7. Bundle Node Attributes
    • 11.3.8. Bundle Meta-Attributes
    • 11.3.9. Limitations of Bundles
• 12. Reusing Parts of the Configuration
  • 12.1. Reusing Resource Definitions
    • 12.1.1. Configuring Resources with Templates
    • 12.1.2. Using Templates in Constraints
    • 12.1.3. Using Templates in Resource Sets
  • 12.2. Reusing Rules, Options and Sets of Operations
  • 12.3. Tagging Configuration Elements
    • 12.3.1. Configuring Tags
    • 12.3.2. Using Tags in Constraints and Resource Sets
    • 12.3.3. Filtering With Tags
• 13. Utilization and Placement Strategy
  • 13.1. Utilization attributes
  • 13.2. Placement Strategy
  • 13.3. How Multiple Capacities Combine
  • 13.4. Order of Resource Assignment
  • 13.5. Limitations
• 14. Access Control Lists (ACLs)
  • 14.1. ACL Prerequisites
  • 14.2. ACL Configuration
  • 14.3. ACL Roles
  • 14.4. ACL Targets and Groups
  • 14.5. ACL Examples
  • 14.6. ACL Limitations
    • 14.6.1. Actions performed via IPC rather than the CIB
    • 14.6.2. ACLs and Pacemaker Remote
• 15. Status
  • 15.1. Node State
  • 15.2. Transient Node Attributes
  • 15.3. Node History
    • 15.3.1. Resource History
    • 15.3.2. Action History
    • 15.3.3. Simple Operation History Example
    • 15.3.4. Complex Operation History Example
• 16. Multi-Site Clusters and Tickets
  • 16.1. Challenges for Multi-Site Clusters
  • 16.2. Conceptual Overview
    • 16.2.1. Ticket
    • 16.2.2. Dead Man Dependency
    • 16.2.3. Cluster Ticket Registry
    • 16.2.4. Configuration Replication
  • 16.3. Configuring Ticket Dependencies
  • 16.4. Managing Multi-Site Clusters
    • 16.4.1. Granting and Revoking Tickets Manually
    • 16.4.2. Granting and Revoking Tickets via a Cluster Ticket Registry
    • 16.4.3. General Management of Tickets
  • 16.5. For more information
• 17. Sample Configurations
  • 17.1. Empty
  • 17.2. Simple
  • 17.3. Advanced Configuration

Index

• Index
• Search Page