Puppet 5.4 known issues

Open source Puppet documentation

Welcome to Puppet documentation
Puppet 5 Platform
- Puppet 5.5 release notes
- Puppet known issues
- System requirements
- Component versions in puppet-agent
- Puppet agent release notes
- Puppet Server 5.3 release notes
- Facter release notes
Quick start guides
- Essential configuration tasks
Deprecated features
- About deprecations in this version
- Web servers
- Upcoming operating system deprecations
- Language features
- Extension points and APIs
- Settings
Installing and upgrading
- Overview of Puppet's architecture
- Pre-install tasks
- Puppet Platform repositories
- Install: Puppet Server
- Install: Puppet agent
- Install: PuppetDB
- Major upgrade from Puppet 3.8.x
- Minor upgrades: From Puppet 4 and within Puppet 5.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)
- Main manifest directory
- The modulepath
- SSL directory (ssldir)
- Cache directory (vardir)
Environments
- About environments
- Creating environments
- Environment isolation
Modules
- Module fundamentals
- Plug-ins in modules
- Module cheat sheet
- Installing and managing modules from the command line
- Beginner's guide to writing modules
- Module metadata
- Documenting modules
- Documenting modules with Puppet Strings
- Puppet Strings style guide
- Publishing modules
- Contributing to Puppet modules
Puppet services and tools
- Puppet commands
- Running Puppet commands on Windows
- Puppet master
- Puppet agent on *nix systems
- Puppet agent on Windows
- Puppet apply
- Puppet device
Puppet Server
- Index
- About Puppet Server
- Release notes
- Deprecated features
- Notable differences vs. the Apache/Passenger stack
- Compatibility with Puppet agent
- Installing Puppet Server
- Configuring Puppet Server
- Differing behavior in puppet.conf
- Using and extending Puppet Server
- Known issues and workarounds
  - Known issues
  - SSL problems with load-balanced PuppetDB servers (“Server Certificate Change” error)
- Administrative API endpoints
  - Environment cache
  - JRuby pool
- Server-specific Puppet API endpoints
- Status API endpoints
  - Status services
- Metrics API endpoints
  - v1 metrics
  - v2 (Jolokia) metrics
- Developer information
The Puppet language
- Visual index
- Basics
- The Puppet language style guide
- 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
- 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
  - Resource default statements
  - 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
- About Hiera
- Getting started with Hiera
- Configuring Hiera
- Creating and editing data
- Looking up data with Hiera
- Writing new data backends
- Upgrading to Hiera 5
Facter
- Facter release notes
- Core facts
- Custom fact overview/reference
- Custom fact walkthrough
- External facts
- Configuring Facter with facter.conf
Resource types
- All resource types (single-page reference)
- Core types cheat sheet
- 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)
SSL and certificates
- Configuring external certificate authority
- Using an external CA with Puppet Server
- External SSL termination with Puppet Server
- Autosigning certificate requests
- CSR attributes and certificate extensions
- Regenerating all certificates in a Puppet deployment
Adding file server mount points
Puppet's internals
- Agent-master HTTPS communications
- Catalog compilation
Experimental features
- Overview
- Msgpack support

As known issues are discovered in Puppet 5.4 and its patch releases, they’ll be added here. Once a known issue is resolved, it is listed as a resolved issue in the release notes for that release, and removed from this list.

Puppet runs generate an autosign warning, indicating that autosign is deprecated. We’re un-deprecating autosign in a future release and you can ignore this warning.
In Puppet 5.4.0 on macOS, the puppet master command might not work correctly. To resolve this issue, set bindaddress if you want Puppet to listen on an IPv4 network interface, or to “0.0.0.0” to listen on an IPv6 interface.
PUP-8009: Puppet 5.1.0 introduced support for internationalized strings in Puppet modules. However, this feature can cause significant performance regressions if environment caching is disabled, for instance by setting environment_timeout==0, even if the module doesn’t include internationalized content. Puppet 5.3.2 introduces an optional disable_i18n setting in puppet.conf to avoid using localized strings and restore degraded performance.