Puppet 4.9 reference manual
- Introduction
- Quick start guides
- 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
- 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
- puppet.conf: The main config file
- environment.conf: Per-environment settings
- auth.conf (LEGACY): HTTPS authorization
- fileserver.conf: Custom fileserver mount points
- puppetdb.conf: PuppetDB server locations
- hiera.yaml: Data lookup configuration
- autosign.conf: Basic certificate autosigning
- csr_attributes.yaml: Certificate extensions
- custom_trusted_oid_mapping.yaml: Short names for cert extension OIDs
- device.conf: Network hardware access
- routes.yaml: Advanced plugin routing
- Configuring Puppet Server
- Puppet Server’s config files
- puppetserver.conf: Main config file
- auth.conf: Access control
- webserver.conf: Jetty web server config
- web-routes.conf: Mount points for component services
- global.conf: Trapperkeeper settings
- ca.conf: CA service access control (deprecated)
- master.conf: Authorization by HTTP header (deprecated)
- product.conf: Configuring Product-level Interactions (optional)
- logback.xml: Logging level and location
- Advanced logging configuration
- Bootstrap upgrade notes
- 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
- Environments
- Modules
- Puppet’s services and tools
- 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
- Administrative API
- Puppet API
- Status API
- 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
- Templates
- Advanced constructs
- Details of complex behaviors
- Writing custom functions
- 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
- 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
- Extensions for assigning classes to nodes
- Misc. references (settings, functions, etc.)
- Man pages
- Index
- Core tools
- Occasionally useful
- Niche
- HTTP API
- SSL and certificates
- Adding file server mount points
- Details about Puppet’s internals
- Experimental features
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
}