Uploaded image for project: 'PuppetDB'
  1. PuppetDB
  2. PDB-4587

docs: clarify connect Puppet master page

    Details

    • Type: Bug
    • Status: Open
    • Priority: Normal
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: DOCS
    • Labels:
    • Environment:
    • Template:
    • Acceptance Criteria:
      Hide

      Instructions should be able to be followed without winging it and assuming that 'puppetdb-termini' should read as 'puppet-terminus-puppetdb'

      Show
      Instructions should be able to be followed without winging it and assuming that 'puppetdb-termini' should read as 'puppet-terminus-puppetdb'
    • Team:
      PuppetDB
    • Method Found:
      Needs Assessment
    • QA Risk Assessment:
      Needs Assessment

      Description

      Problem:

       The document at https://puppet.com/docs/puppetdb/latest/connect_puppet_master.html which from it's title is the 'latest' version document refers to installing the 'puppetdb-termini' package. With Puppet Server prepackaged for Debian Buster (Debian 10) - puppetserver6.7.1-1buster - there is no puppet-termini package available. Should this instead reference the puppet-terminus-puppetdb package which is in the repo? Or is there a package missing from the repo? The Ubuntu Bionic repo has a 'puppetdb-termini package' but not a 'puppet-terminus-puppetdb' package, the Debian Buster repo has a 'puppet-terminus-puppetdb' package but not a 'puppetdb-termini' package. It looks like it should be one or the other that get installed, not sure if this is a change in packaging as both bionic and buster install puppetdb 6.7.1-1

      Suggested improvement:

      https://puppet.com/docs/puppetdb/latest/connect_puppet_master.html

      Current text :

      On platforms with packages

      Enable the Puppet Collection repo and then install the puppetdb-termini package:

       
       
       

      $ sudo puppet resource package puppetdb-termini ensure=latest.

      Suggested improvement:

      On platforms with packages

      Enable the Puppet Collection repo and then install the puppet-terminus-puppetdb or puppetdb-termini package depending on the repository used:

       
       
       

      $ sudo puppet resource package [puppet-terminus-puppetdb|puppetdb-termini] ensure=latest

      Summary:

       Either this is a change in packaging (implied a change in documentation for 'latest' or it's an error in packaging for Debian Buster.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              matthew.lowy Matthew Lowy
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:

                Zendesk Support