(SIMP-10449) Add HOWTO enable puppetdb (#441)

SIMP-10449 #close

Author: trevor-vaughan

CHANGELOG

@@ -1,4 +1,5 @@
-* Wed Sep 01 2021 Trevor Vaughan <tvaughan@onyxpoint.com>
+* Tue Sep 07 2021 Trevor Vaughan <tvaughan@onyxpoint.com>
+- Add HOWTO for managing PuppetDB
 - Add HOWTO for enabling client reports
 - Removed obsolete references to Travis CI
 

docs/HOWTO/20_Puppet/Enable_Client_Reporting.rst

@@ -43,6 +43,9 @@ back to `store`, set the following in :term:`Hiera`:
 PuppetDB Reports
 ----------------
 
+Prior to proceeding, you should read :ref:`ht-enable-puppetdb`_ if you have not
+already enabled :program:`puppetdb`.
+
 If you want to use a :term:`GUI` application like `Puppetboard`_ to connect to
 :program:`puppetdb` for reports, then you will need to ensure that the reports
 are being sent to :program:`puppetdb` by the server.

docs/HOWTO/20_Puppet/Enable_PuppetDB.rst

@@ -0,0 +1,39 @@
+.. _ht-enable-puppetdb:
+
+HOWTO Enable PuppetDB
+=====================
+
+.. IMPORTANT::
+
+   Do not attempt to manage PuppetDB on Puppet Enterprise hosts!
+
+As of SIMP 6.6.0, :term:`puppetdb` is no longer enabled or managed by default.
+
+Use the following YAML as a guide to the :term:`hiera` settings required to enable the management of :program:`puppetdb`.
+
+.. code-block:: yaml
+
+   ---
+   # Include the puppetdb class
+   simp::server::classes:
+     - simp::puppetdb
+
+   ## SIMP Required Settings
+
+   # Let pupmod::master::base handle this.
+   puppetdb::master::config::restart_puppet: false
+
+   # Set the PuppetDB port
+   puppetdb::master::config::puppetdb_port: 8139
+
+   ## Optional Settings
+
+   # The version of PuppetDB that should be installed
+   puppetdb::globals::version: 'latest'
+
+   # Set up node report storage
+   puppetdb::master::config::manage_report_processor: true
+   puppetdb::master::config::enable_reports: true
+
+See the :pupmod:`puppetlabs/puppetdb` documentation for details on all of the settings that affect
+the configuration of :program:`puppetdb`.