Puppet Server Configuration Files: global.conf

Puppet 4.9 reference manual

Introduction
Quick start guides
- Quick start intro for *nix users
- Essential configuration tasks
Puppet 4.9 release notes
Puppet agent release notes
Puppet Server 2.7 release notes
puppet-agent: What is it, what’s in it?
Where did everything go?
Deprecated features
- About deprecations in this version
- Web servers
- Operating systems
- Language features
- Extension points and APIs
- Settings
Installing and upgrading
- Overview of Puppet’s architecture
- System requirements
- Pre-install tasks
- Puppet Collection repositories
- Install: Puppet Server
- Install: Puppet agent
- Install: PuppetDB
- Upgrade: From Puppet 4.x
- Upgrade: From Puppet 3.x
Configuration
- About Puppet’s settings
- Short list of important settings
- Config files
- Configuring Puppet Server
- Checking values of settings
- Editing settings on the command line
- Complete list of settings (configuration reference)
- Settings that differ under Puppet Server
Important directories and files
- Code and data directory (codedir)
- Config directory (confdir)
- The main manifest(s)
- The modulepath
- The SSLdir
- Cache directory (vardir)
Environments
- About environments
- Configuring environments
- Creating environments
- Assigning environments to nodes
- Suggestions for use
- Limitations of environments
- Environment isolation
- Environments and Puppet’s HTTPS interface
Modules
- Fundamentals
- Beginner’s guide to writing modules
- Plugins in modules
- Installing modules
- Publishing modules on the Puppet Forge
- Module metadata and metadata.json
- Documenting modules
- Smoke testing modules
Puppet’s services and tools
- Puppet’s commands
- Running Puppet commands on Windows
- Puppet master
- Puppet agent on *nix
- Puppet agent on Windows
- Puppet apply
Puppet Server
- Index
- About Puppet Server
- Release notes
- Deprecated features
- Notable differences vs. the Apache/Passenger stack
- Installation
- Differing behavior in puppet.conf
- Using Ruby gems
- Subcommands
- Backwards compatibility with Puppet 3 agents
- Using an external CA
- External SSL termination
- Tuning guide
- Restarting Puppet Server
- Known issues and workarounds
  - Known issues
  - SSL problems with load-balanced PuppetDB servers (“server certificate change” error)
- Administrative API
  - Environment cache
  - JRuby pool
- Puppet API
  - Environment classes
  - Static file content
- Status API
  - Services
- Developer info
The Puppet language
- Updating 3.x manifests for Puppet 4.x
- Visual index
- Basics
- Handling file paths on Windows
- Variables
- Resources
- Resources (advanced)
- Relationships and ordering
- Classes
- Defined resource types
- Type aliases
- Expressions and operators
- Conditional statements and expressions
- Function calls
- Docs for built-in functions
- Node definitions
- Comments
- Facts and built-in variables
- Reserved words and acceptable names
- Puppet language style guide
- Writing functions (Puppet language)
- Custom types
- Provider development
- Values and data types
  - About values and data types
  - Strings
  - Numbers
  - Booleans
  - Arrays
  - Hashes
  - Regular expressions
  - Sensitive
  - Undef
  - Resource references
  - Resource types
  - Default
  - Data type syntax
  - Abstract data types
- Templates
  - Using templates
  - Embedded Puppet (EPP) template syntax
  - Embedded Ruby (ERB) template syntax
- Advanced constructs
  - Iteration and loops
  - Lambdas (code blocks)
  - Resource defaults
  - Resource collectors
  - Virtual resources
  - Exported resources
  - Tags
  - Run stages
- Details of complex behaviors
  - Containment of resources
  - Scope
  - Namespaces and autoloading
Writing custom functions
- Introduction to writing functions
- Writing functions (Puppet language)
- Writing functions (modern Ruby API)
- Writing functions (legacy Ruby API — avoid)
Hiera: using configuration data
- What is Hiera?
- Quick start guide
- How hierarchies work
- How the three config layers work
- Upgrading to Hiera 5
- Configuring Hiera (the hiera.yaml file)
- Looking up data
- Creating and editing data
  - Merging data from multiple sources
  - Interpolating variables and functions
- Writing new data backends
Resource types
- All resource types (single-page reference)
- Optional resource types for Windows
- augeas
- Augeas tips and examples
- computer
- cron
- exec
- Exec tips and examples for Windows
- file
- File tips and examples for Windows
- filebucket
- group
- User and group tips and examples for Windows
- host
- index
- interface
- k5login
- macauthorization
- mailalias
- maillist
- mcx
- mount
- nagios_command
- nagios_contact
- nagios_contactgroup
- nagios_host
- nagios_hostdependency
- nagios_hostescalation
- nagios_hostextinfo
- nagios_hostgroup
- nagios_service
- nagios_servicedependency
- nagios_serviceescalation
- nagios_serviceextinfo
- nagios_servicegroup
- nagios_timeperiod
- notify
- package
- Package tips and examples for Windows
- resources
- router
- schedule
- scheduled_task
- Scheduled task tips and examples
- selboolean
- selmodule
- service
- Service tips and examples
- ssh_authorized_key
- sshkey
- stage
- tidy
- user
- User and group tips and examples for Windows
- vlan
- yumrepo
- zfs
- zone
- zpool
Reports: Tracking Puppet’s activity
- About reporting
- Built-in report processors
- Writing custom report processors
- Puppet::Transaction::Report object format
Extensions for assigning classes to nodes
- External node classifiers
- The LDAP node classifier
Misc. references (settings, functions, etc.)
- Settings (configuration reference)
- Functions
- Metaparameters
- Built-in report processors
- Indirections and termini
- Ruby API for developing extensions
Man pages
- Index
- Core tools
- Occasionally useful
- Niche
HTTP API
- Index
- PSON
- Puppet v3 API
- CA v1 API
- Schemas (JSON files)
SSL and certificates
- Using an external CA
- Using an external CA with Puppet Server
- External SSL termination with Puppet Server
- Configuring autosigning
- CSR attributes and certificate extensions
- Regenerating all certificates in a deployment
Adding file server mount points
Details about Puppet’s internals
- Agent/master HTTPS communications
- Catalog compilation
Experimental features
- Overview
- Msgpack support

Example

The global.conf file contains global configuration settings for Puppet Server. For an overview, see Puppet Server Configuration.

You shouldn’t typically need to make changes to this file. However, you can change the logging-config path for the logback logging configuration file if necessary. For more information about the logback file, see http://logback.qos.ch/manual/configuration.html.

Example

global: {
    logging-config: /etc/puppetlabs/puppetserver/logback.xml
}