Hiera 3: Release Notes

Included in Puppet Enterprise 2015.3. A newer version is available; see the version menu above for details.

###Note: We’ve released a major update to Hiera called Hiera 5.

It’s built into Puppet 4.9 and higher, and includes features like per-environment hierarchies, module data, simplified custom backends, improved debugging with puppet lookup --explain, and more.

As part of this update, we’ve moved Hiera’s documentation into the Puppet reference manual. Once you’ve upgraded to Puppet 4.9 or higher, see the following pages for more info about the new Hiera:

Hiera 3.0.6

Released January 25, 2016.

Shipped in puppet-agent version 1.3.4.

Hiera 3.0.6 has no functional changes from 3.0.5, but has an increase in version number for testing and packaging purposes with puppet-agent 1.3.3.

Hiera 3.0.5

Released November 17, 2015.

Shipped in puppet-agent version 1.3.0.

Hiera 3.0.5 has no functional changes from 3.0.4, but has an increase in version number for testing and packaging purposes with puppet-agent 1.3.0.

Hiera 3.0.4

Released October 29, 2015.

Shipped in puppet-agent version 1.2.7.

Hiera 3.0.2 and 3.0.3

Hiera 3.0.3 has no functional differences from 3.0.1, but we needed to increase the version number for testing and packaging purposes.

Hiera 3.0.2 was never released.

Hiera 3.0.1

Released June 24, 2015.

Shipped in puppet-agent version 1.2.0.

Hiera 3.0 changes the default values for the :hierarchy and :datadir settings. It contains no new features and no other changes, but because there was a small chance of changed behavior for existing installations, it received a new semver major version.

BREAK: New Default :hierarchy

Previously, if you didn’t specify a value for the :hierarchy setting in hiera.yaml, your hierarchy would only contain one static data source ("common"). Now, the first level of the hierarchy will be linked to each Puppet node’s verified certname. Hiera will still fall back to "common" if there isn’t a data source for a given node.

The new default hierarchy is:

:hierarchy:
  - "nodes/%{::trusted.certname}"
  - "common"

This should make Hiera more useful out of the box.

BREAK: New Default :datadir

The YAML and JSON backends both have a :datadir setting which controls where the data files are stored.

Previously, if you didn’t specify a :datadir value for either of these backends, Hiera would use $codedir/hieradata (more on Puppet’s codedir), with a single data directory for all environments. Now, if :datadir is unspecified, Hiera will use a different data directory for each environment, using Puppet’s default environments directory. You can find each environment’s Hiera data at $codedir/environments/<ENVIRONMENT>/hieradata.

The new default data directory is:

:yaml:
  # on *nix:
  :datadir: "/etc/puppetlabs/code/environments/%{environment}/hieradata"
  # on Windows:
  :datadir: "C:\ProgramData\PuppetLabs\code\environments\%{environment}\hieradata"

Hiera 3.0.0

Hiera 3.0.0 was never released; we discovered a release-blocking oversight after the release had been tagged but before packages had been built.

↑ Back to top