Documentation

1. Bcfg2 Architecture

• Goals
• The Bcfg2 Client
  • Architecture Abstraction
• The Bcfg2 Server
  • The Configuration Specification Construction Process
• The Literal Configuration Specification
  • The Structure of Specifications
• Design Considerations
  • System Metadata
  • Package Management

2. Installing Bcfg2?
   • Pre-requisites
   • Obtaining bcfg2
   • Server Installation
   • Bcfg2 Initial Setup and Testing
   • Daemon Configuration
     • SSL Certificate Generation
     • Client Communication Setup
   • Client Installation

3. Writing Bcfg2 Specifications
   • Interacting with Client Groups in Bcfg2 (Metadata)
     • Usage of Groups in Metadata
       • Clients
         • Attributes
         • Examples
       • Groups
         • Attributes
         • Examples
   • Adding to the Abstract Configuration (Structures)
     • Configuration Entity Types
       • Package
         • Attributes
         • Examples
       • ConfigFile?
         • Attributes
         • Examples
       • Service
         • Attributes
         • Examples
       • Directory
         • Attributes
         • Examples
       • Symlink
         • Attributes
         • Examples
       • Permissions
         • Attributes
         • Examples
       • Actions
         • Attributes
         • Examples
   • Usage of Groups in Base and Bundles
     • Writing Bundles
     • Using Base

• Adding to the Literal Configuration (Generators)
  • Usage of Groups in Generators
    • Attributes
    • Examples
  • Each of the plugins are described in the plugins page?.
• Checking Group-External Clients for Unintended Changes
• Validating the Bcfg2 Repository
• Annotated Configuration Examples
  • Configuring /etc/motd on all hosts
  • Configuring NTP for a network

4. Probes?

5. DynamicGroups?

6. Client Tool Drivers?
   • Driver Selection
   • Action
   • Entries handled
   • What it does

7. Deploying Bcfg2
   • Simple Deployments
   • A Near-Literal Deployment
   • An Abstract Deployment
   • Bcfg2 Server Administration
   • An example application of bcfg2

8. Developing for Bcfg2
   • Bcfg2 Plugins
   • Writing Bcfg2 Plugins
     • An Example Plugin

9. BCFG2 Reports
   • How it works
   • Report Types
   • Configuration
   • Reporting Quick Start

10. Demo Repository

11. Troubleshooting?

12. Manual Pages
    • bcfg2
    • bcfg2-admin
    • bcfg2-build-reports
    • bcfg2-info
    • bcfg2-ping-sweep
    • bcfg2-query
    • bcfg2-repo-validate
    • bcfg2-server