Pacemaker Administration

Managing Pacemaker Clusters

This document has instructions and tips for system administrators who manage high-availability clusters using Pacemaker.

• 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. Installing Cluster Software
• 3. The Cluster Layer
• 4. Client Options
• 5. Configuring Pacemaker
  • 5.1. Configuration Using Higher-level Tools
  • 5.2. Configuration Using Pacemaker’s Command-Line Tools
    • 5.2.1. Working with CIB Properties
    • 5.2.2. Querying and Setting Cluster Options
    • 5.2.3. When Options are Listed More Than Once
  • 5.3. Connecting from a Remote Machine
• 6. Using Pacemaker Command-Line Tools
  • 6.1. Controlling Command Line Output
  • 6.2. Monitor a Cluster with crm_mon
    • 6.2.1. Styling crm_mon HTML output
  • 6.3. Edit the CIB XML with cibadmin
  • 6.4. Batch Configuration Changes with crm_shadow
  • 6.5. Simulate Cluster Activity with crm_simulate
    • 6.5.1. Replaying cluster decision-making logic
    • 6.5.2. Why decisions were made
    • 6.5.3. Visualizing the action sequence
    • 6.5.4. What-if scenarios
  • 6.6. Manage Node Attributes, Cluster Options and Defaults with crm_attribute and attrd_updater
  • 6.7. Other Commonly Used Tools
• 7. Administrative Modes
  • 7.1. Maintenance Mode
  • 7.2. Unmanaged Resources
  • 7.3. Disabled Configuration
  • 7.4. Standby Mode
  • 7.5. Rules
• 8. Moving Resources
  • 8.1. Moving Resources Manually
    • 8.1.1. Standby Mode
    • 8.1.2. Moving One Resource
  • 8.2. Moving Resources Due to Connectivity Changes
    • 8.2.1. Tell Pacemaker to Monitor Connectivity
    • 8.2.2. Tell Pacemaker How to Interpret the Connectivity Data
• 9. Troubleshooting Cluster Problems
  • 9.1. Logging
  • 9.2. Reading the Logs
  • 9.3. Transitions
  • 9.4. Node Failures
  • 9.5. Resource Failures
• 10. Upgrading a Pacemaker Cluster
  • 10.1. Pacemaker Versioning
  • 10.2. Upgrading Cluster Software
    • 10.2.1. Complete Cluster Shutdown
    • 10.2.2. Rolling (node by node)
    • 10.2.3. Detach and Reattach
  • 10.3. Upgrading the Configuration
  • 10.4. What Changed in 2.1
  • 10.5. What Changed in 2.0
  • 10.6. What Changed in 1.0
    • 10.6.1. New
    • 10.6.2. Changed
    • 10.6.3. Removed
• 11. Alert Agents
  • 11.1. Using the Sample Alert Agents
  • 11.2. Writing an Alert Agent
• 12. Resource Agents
  • 12.1. Action Completion
  • 12.2. OCF Resource Agents
    • 12.2.1. Location of Custom Scripts
    • 12.2.2. Actions
    • 12.2.3. How Are OCF Return Codes Interpreted?
    • 12.2.4. OCF Return Codes
    • 12.2.5. Environment Variables
    • 12.2.6. Clone Resource Agent Requirements
  • 12.3. LSB Resource Agents (Init Scripts)
    • 12.3.1. LSB Compliance
• 13. Quick Comparison of pcs and crm shell
  • 13.1. Show Cluster Configuration and Status
  • 13.2. Manage Nodes
  • 13.3. Manage Cluster Properties
  • 13.4. Show Resource Agent Information
  • 13.5. Manage Resources
  • 13.6. Manage Constraints
  • 13.7. Advanced Configuration
    • 13.7.1. Manipulate Configuration Elements by Type
    • 13.7.2. Batch Changes
    • 13.7.3. Template Creation
    • 13.7.4. Log Analysis
    • 13.7.5. Configuration Scripts