As far as i know, the "best" way to install puppetdb is via the module.
The package and source installs are complex. In my experience very difficult to succeed. maybe they should be footnotes, at best?
the current puppetdb docs are a bit vague about what is the easy and complete way to install puppetdb given a few circumstances.
There is a lot of mentions of what to do given PE>3.0, which might confuse FOSS users.
the packages doc goes on to say:
If you are just getting started with Puppet and don’t yet know how to assign Puppet classes to nodes, this is the guide for you.
If you are already familiar with Puppet and have a working Puppet deployment, we recommend that you use the puppetlabs-puppetdb module instead. See the “Install via Module” page for more details.
which i find backwards, actually.
We might need some input from AJ Roetker on the current best practices.