PuppetDB 1.4 » Using PuppetDB
This version of PuppetDB is not included in Puppet Enterprise. The latest version of PE includes PuppetDB 4.0. A newer version is available; see the version menu above for details.
Currently, the main use for PuppetDB is to enable advanced features in Puppet. We expect additional applications to be built on PuppetDB as it becomes more widespread.
If you wish to build applications on PuppetDB, see the navigation sidebar for links to the API spec.
Checking Node Status
The PuppetDB plugins installed on your puppet master(s) include a
status action for the
node face. On your puppet master, run:
$ sudo puppet node status <node>
<node> is the name of the node you wish to investigate. This will tell you whether the node is active, when its last catalog was submitted, and when its last facts were submitted.
Using Exported Resources
PuppetDB lets you use exported resources, which allows your nodes to publish information for use by other nodes.
Using the Inventory Service
PuppetDB provides better performance for Puppet’s inventory service.
See here for more about using the inventory service and building applications on it. If you are using Puppet Enterprise’s console, or Puppet Dashboard with inventory support turned on, you will not need to change your configuration — PuppetDB will become the source of inventory information as soon as the puppet master is connected to it.