Puppet Server 2.0: Release Notes
This version of Puppet Server is not included in Puppet Enterprise. The latest version of PE includes Puppet Server 2.7. A newer version is available; see the version menu above for details.
Puppet Server 2.0
In keeping with semantic versioning practices, this release of Puppet Server introduces changes that break compatibility with Puppet 3.x agents. Please carefully read these release notes before attempting to upgrade your Puppet installation, as the locations of key files have moved, and changes to the Puppet Server API may require configuration changes.
Puppet Server 2.0 ships for the following supported platforms:
- Enterprise Linux 7
- Enterprise Linux 6
- Ubuntu 14.04
- Ubuntu 12.04
- Debian 7
What’s New in Puppet Server 2.0
Repository Location and Pre-Installation
As with Puppet 4.0, Puppet Server 2.0 is now distributed via the new Puppet Collection repositories. Puppet Server 2.0 is part of Puppet Collection 1.
In order to install Puppet Server 2.0, you’ll need to install a release package appropriate to your operating system. See the Puppet 4 installation guide for information on how to prepare your system for installation, and specific installation instructions.
- SERVER-524 - Set repo-target to PC1 for 2.0 release
Changes to Library and File Locations
Note: These changes affect your ability to upgrade agents. Please consult the Puppet installation layout document for guidance on where to move files before upgrading.
As part of the move to a unified all-in-one configuration layout, the locations of configuration files and directories has changed.
Due to changes in the location of Ruby gems in Puppet Server 2.0, you’ll need to move your SSL certificates and any extensions you’ve installed, as well.
- SERVER-370 - Change ruby-load-path to /opt/puppetlabs/puppet/lib/ruby/vendor_ruby
- SERVER-371 - Change gem_home to /opt/puppetlabs/puppet/cache/jruby-gems
- SERVER-387- Update puppet-server config directory
- SERVER-409 - Plumb confdir, vardir, codedir, logdir, rundir values
As a result of the REST API URL changes between Puppet Server 1.x
and 2.0, Puppet Server 1.x users who have modified their
need to make changes when upgrading to Puppet Server 2.0. See
some additional information.
These auth.conf changes follow the same changes required for any users upgrading from Puppet 3.x to Puppet 4.x.
Puppet Server 2.0 is not backwards compatible with Puppet 3.x agents. Version 2.0 of Puppet Server is only compatible with Puppet 4.x agents. If upgrading all your agents and masters in concert will be a problem for you, please consider waiting until we release Puppet Server 2.1.
Installing gems when Puppet Server is behind a proxy requires manual download of gems
When a Puppet master must access the Internet via a proxy server, it
is not possible to use the
puppetserver gem command to install
gems. To work around this issue until we release a fix:
- Use rubygems.org to search for and download the gem you want to install.
- Run the command
puppetserver gem install --local <PATH to GEM>.
- SERVER-377 -
puppetserver gemcommand doesn’t work from behind a proxy server
Puppet Server now reports when new versions are available.
Due to a mismatch in naming conventions, Puppet Server was unable to report the availability of new versions. We’ve addressed this bug by adopting the increasing preference to eliminate hyphens from assorted project and package names.
- SERVER-520 - Apply artifact-id updates to version checks in master
- SERVER-457 - Get dujour working with Puppet Server 2.0.0 RC
Fix inconsistent behavior around
We’ve fixed a bug in puppetserver where always_cache_features was not always overridden because it could be changed in puppet.conf. The behavior is now explicitly managed in code rather than configuration.
- SERVER-410 -
Fix unreliable puppetserver start behavior
We’ve Fixed a bug where puppetserver was not starting reliably from the service management framework due to the “rundir” not being writable.
- SERVER-414 - Handle rundir creation for puppet and puppetserver in Puppet Server 2.x
Fix misleading silence from
puppetserver foreground command
We’ve fixed a bug where the puppetserver foreground command would not produce any output, making it appear as if the command had not started or was stalled. The foreground command produces debugging output in 2.0.0.
- SERVER-356 - puppetserver foreground produces no output
For a list of all changes in this release, see this JIRA page: