Replace java dependencies in PE with pe-java

PE now has the openjdk built to use with pe-puppetdb, so this commit updates
pe-puppetdb to use pe-java at the expected location. It sets @java_bin, which
overrides the default in puppetdb_defaults, and adds pe-java as a dependency in
both the debian/control and redhat/puppetdb.spec files.
Replace erb conditional with rpm macro conditional.
Use fqdn with fallback to hostname in jetty.ini
Acceptance: stop using deprecated parameter `manage_redhat_firewall`

The acceptance tests were using the deprecated parameter
`manage_redhat_firewall` from the puppetdb module.  This commit
just changes the call to the module so that it uses the new
replacement parameters.
Merge pull request #413 from cprice-puppet/maint/master/stop-using-deprecated-param-from-pdb-mod

Acceptance: stop using deprecated parameter `manage_redhat_firewall`
Rename `documentation` to `documentation.old`

This commit is in preparation for syncing our docs up with the ones
in the `puppet-docs` repo.  Just to make the git history a bit
easier to follow, I've renamed the docs directory to `documentation.old`;
the next commit will add the new docs from the other repo, and then
I'll delete the `old` directory in a final commit.
Copy latest docs from `puppet-docs` repo

We'd like for the docs in the puppetdb repo to always be up-to-date
with the latest code.  However, we also need to keep things in sync
with the documentation team and have a relatively sane way of
publishing the docs to the website.  We'd gotten pretty far out
of sync, so we just went through a process of merging all of the
latest diffs from our docs into the `puppet-docs` repo and reorganizing
things a bit over there.  This commit just copies in the result of that
work into our repo.

Going forward, all docs changes will be made here, and then when we're ready
to publish docs for a new release we'll just copy the whole docs folder
from here to a new, versioned subfolder in the `puppet-docs` repo.
Remove old documentation from repo

Now that we've synced up with the docs in the `puppet-docs` repo,
that version of our docs is the one we'll be maintaining going
forward.  This commit just gets rid of the old version.

Doing this in an isolated commit in hopes of making the git history
a bit easier to follow.
Transform README into more of a table-of-contents

The README had gotten extremely long, and in the docs repo
it had been broken up into several discrete documents.  Now
that we've synced down the docs from that repo, our README
was redundant.  This commit replaces it with basically a
table of contents with links to the rest of the documentation.

This commit also removes CHANGELOG.md, which was duplicated by
`documentation/release_notes.markdown`, and FAQ.md, which is
replaced by `documentation/puppetdb-faq.markdown`.
Fix broken link to install docs
Merge pull request #414 from cprice-puppet/maint/master/puppetdb_docs-there_can_be_only_one

Maint/master/puppetdb docs there can be only one
Docs: Fix broken links in commands page

wire-format vs. wire_format, argh.
(#18879) Remove the environment key from v1 catalogs

In some versions of Puppet, this key may be present. This fixes an issue
where older versions of the terminus (or otherwise perfectly legal v1
catalogs) would submit a catalog with this unexpected, but still not
allowed key. Now we explicitly remove it, so that when we call the v2
parse-catalog function, the catalog is legal.
Merge pull request #416 from nicklewis/allow-environment-key-in-v1

(#18879) Remove the environment key from v1 catalogs
Remove invalid handling of HTTP 404

Prior to this commit, we were catching HTTP 404 Not Found responses
and returning `nil`.  This was masking the fact that the URL for the
facts/find endpoint was invalid; also, the server actually just returns
a 200 with an empty array as the payload if you issue a well-formed
query for a node that puppetdb doesn't know about.
Add acceptance test for fact retrieval / inventory service
Fix url for facts terminus `find` method

The URL got broken in a recent changeset; this commit corrects
it to point to `/v2/nodes/<node_name>` rather than just
`/v2/<node_name>`.  Fixes failing acceptance test.
Merge pull request #417 from cprice-puppet/bug/master/facts_terminus_wrong_url_for_find

Fix the url for the `find` endpoint in the facts terminus
Fix inventory service to return 'nil' when a node is not found

The previous commit had a side effect of causing the facts
terminus' `find` method to return an empty array when the
requested node did not exist.  This commit changes the behavior
back to what it was previously--to return `nil` instead.
Merge pull request #419 from cprice-puppet/but/master/18934-inventory-service-should-return-nil-for-unknown-node

Fix inventory service to return 'nil' when a node is not found