Table of Contents

  1. Pacemaker Explained
  2. Introduction
    1. The Scope of this Document
    2. What Is Pacemaker?
      1. Cluster Architecture
      2. Pacemaker Architecture
      3. Node Redundancy Designs
  3. Host-Local Configuration
    1. Configuration Value Types
      1. Scores
    2. Local Options
  4. Cluster-Wide Configuration
    1. Configuration Layout
    2. CIB Properties
    3. Cluster Options
  5. Cluster Nodes
    1. Defining a Cluster Node
      1. Where Pacemaker Gets the Node Name
    2. Node Attributes
      1. Setting and querying node attributes
      2. Special node attributes
    3. Tracking Node Health
      1. Node Health Attributes
      2. Node Health Strategy
      3. Exempting a Resource from Health Restrictions
      4. Configuring Node Health Agents
  6. Cluster Resources
    1. What is a Cluster Resource?
    2. Resource Standards
      1. Open Cluster Framework
      2. Systemd
      3. Linux Standard Base
      4. System Services
      5. STONITH
      6. Nagios Plugins
      7. Upstart
    3. Resource Properties
    4. Resource Options
      1. Resource Meta-Attributes
      2. Setting Global Defaults for Resource Meta-Attributes
      3. Resource Instance Attributes
  7. Resource Operations
    1. Operation Properties
    2. Monitoring Resources for Failure
    3. Setting Global Defaults for Operations
    4. When Implicit Operations Take a Long Time
    5. Multiple Monitor Operations
    6. Disabling a Monitor Operation
    7. Specifying When Recurring Actions are Performed
    8. Handling Resource Failure
      1. Failure Counts
      2. Failure Response
    9. Reloading an Agent After a Definition Change
    10. Migrating Resources
  8. Resource Constraints
    1. Deciding Which Nodes a Resource Can Run On
      1. Location Properties
      2. Asymmetrical “Opt-In” Clusters
      3. Symmetrical “Opt-Out” Clusters
      4. What if Two Nodes Have the Same Score
      5. Specifying locations using pattern matching
    2. Specifying the Order in which Resources Should Start/Stop
      1. Ordering Properties
      2. Optional and mandatory ordering
      3. Symmetric and asymmetric ordering
    3. Placing Resources Relative to other Resources
      1. Colocation Properties
      2. Mandatory Placement
      3. Advisory Placement
      4. Colocation by Node Attribute
      5. Colocation Influence
    4. Resource Sets
    5. Ordering Sets of Resources
      1. Ordered Set
      2. Ordering Multiple Sets
      3. Resource Set OR Logic
    6. Colocating Sets of Resources
    7. External Resource Dependencies
  9. Fencing
    1. What Is Fencing?
    2. Why Is Fencing Necessary?
    3. Fence Devices
    4. Fence Agents
    5. When a Fence Device Can Be Used
    6. Limitations of Fencing Resources
    7. Special Meta-Attributes for Fencing Resources
    8. Special Instance Attributes for Fencing Resources
    9. Default Check Type
    10. Unfencing
    11. Fencing and Quorum
    12. Fencing Timeouts
    13. Fence Devices Dependent on Other Resources
    14. Configuring Fencing
      1. Example Fencing Configuration
    15. Fencing Topologies
      1. Example Dual-Layer, Dual-Device Fencing Topologies
    16. Remapping Reboots
  10. Alerts
    1. Alert Agents
    2. Alert Recipients
    3. Alert Meta-Attributes
    4. Alert Instance Attributes
    5. Alert Filters
  11. Rules
    1. Rule Options
    2. Rule Conditions and Contexts
    3. Date/Time Expressions
      1. Date Specifications
      2. Durations
      3. Example Date/Time Expressions
    4. Node Attribute Expressions
    5. Resource Type Expressions
      1. Example Resource Type Expressions
    6. Operation Type Expressions
      1. Example Operation Type Expressions
    7. Using Rules to Determine Resource Location
      1. Location Rules Based on Other Node Properties
      2. Using score-attribute Instead of score
      3. Specifying location scores using pattern submatches
    8. Using Rules to Define Options
      1. Using Rules to Control Resource Options
      2. Using Rules to Control Resource Defaults
      3. Using Rules to Control Cluster Options
  12. Collective Resources
    1. Groups - A Syntactic Shortcut
      1. Group Properties
      2. Group Options
      3. Group Instance Attributes
      4. Group Contents
      5. Group Constraints
      6. Group Stickiness
    2. Clones - Resources That Can Have Multiple Active Instances
      1. Anonymous versus Unique Clones
      2. Promotable clones
      3. Clone Properties
      4. Clone Options
      5. Clone Contents
      6. Clone Instance Attribute
      7. Clone Constraints
      8. Clone Stickiness
      9. Monitoring Promotable Clone Resources
      10. Determining Which Instance is Promoted
    3. Bundles - Containerized Resources
      1. Bundle Prerequisites
      2. Bundle Properties
      3. Bundle Container Properties
      4. Bundle Network Properties
      5. Bundle Storage Properties
      6. Bundle Primitive
      7. Bundle Node Attributes
      8. Bundle Meta-Attributes
      9. Limitations of Bundles
  13. Reusing Parts of the Configuration
    1. Reusing Resource Definitions
      1. Configuring Resources with Templates
      2. Using Templates in Constraints
      3. Using Templates in Resource Sets
    2. Reusing Rules, Options and Sets of Operations
    3. Tagging Configuration Elements
      1. Configuring Tags
      2. Using Tags in Constraints and Resource Sets
      3. Filtering With Tags
  14. Utilization and Placement Strategy
    1. Utilization attributes
    2. Placement Strategy
    3. How Multiple Capacities Combine
    4. Order of Resource Assignment
    5. Limitations
  15. Access Control Lists (ACLs)
    1. ACL Prerequisites
    2. ACL Configuration
    3. ACL Roles
    4. ACL Targets and Groups
    5. ACL Examples
    6. ACL Limitations
      1. Actions performed via IPC rather than the CIB
      2. ACLs and Pacemaker Remote
  16. Status
    1. Node State
    2. Transient Node Attributes
    3. Node History
      1. Resource History
      2. Action History
      3. Simple Operation History Example
      4. Complex Operation History Example
  17. Multi-Site Clusters and Tickets
    1. Challenges for Multi-Site Clusters
    2. Conceptual Overview
      1. Ticket
      2. Dead Man Dependency
      3. Cluster Ticket Registry
      4. Configuration Replication
    3. Configuring Ticket Dependencies
    4. Managing Multi-Site Clusters
      1. Granting and Revoking Tickets Manually
      2. Granting and Revoking Tickets via a Cluster Ticket Registry
      3. General Management of Tickets
    5. For more information
  18. Sample Configurations
    1. Empty
    2. Simple
    3. Advanced Configuration