Puppet is an open-source tool that helps you manage and automate the configuration of servers.

All of the data generated by Puppet (for example facts, catalogs, reports) is stored in PuppetDB.

Creating a Certificate in Puppet #

Before configuring the Puppet connector in Lucidum, you must first create a certificate. Lucidum will use the certificate to access Puppet.

It is recommended to create a dedicated certificate for the Puppet connector. The name used for the certificate must be unique and not currently in use. Please follow the steps below to generate a certificate in Puppet and provide the needed files to Lucidum:

  1. Connect to the Puppet master instance with SSH.

  2. Run the following command to remove any previous instances of the certificate:
    sudo /opt/puppetlabs/bin/puppet cert clean lucidum

  3. Run the following command to create the certificate:
    sudo /opt/puppetlabs/bin/puppet cert generate lucidum

  4. Copy the following files to your workstation:

    • CA cert: /etc/puppetlabs/puppet/ssl/certs/ca.pem

    • Public key cert: /etc/puppetlabs/puppet/ssl/certs/lucidum.pem

    • Private key file: /etc/puppetlabs/puppet/ssl/private_keys/lucidum.pem (you will need to chmod the private key file to copy it)

Configuring the Connector for Puppet #

To configure Lucidum to ingest data from Puppet:

  1. Log in to Lucidum.

  2. In the left pane, click Connector.

  3. In the Connector page, click Add Connector.

  4. Scroll until you find the Connector you want to configure. Click Connect. The Settings page appears.

  5. In the Settings page, enter the following:

    •  Server Name (required). The hostname or IP address of the Puppet server.

    • Port. Port for the puppet server. Default is 8080.

    • CA File (required). The Certificate Authority file for the Puppet instance.

    • Certificate File (required). The certificate file for the Puppet instance.

    • Private Key File (required). The private key file for the Puppet instance.

  6. To test the configuration, click Test.

    • If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.

    • If the connector is not configured correctly, Lucidum displays an error message.

API Documentation #

https://www.puppet.com/docs/puppetdb/7/api/overview.html