Bug #11172

PE Installer should describe "certname" more clearly

Added by Jeff McCune 6 months ago. Updated 3 months ago.

Status:Merged - Pending Release Start date:12/05/2011
Priority:Normal Due date:
Assignee:Jeff McCune % Done:

0%

Category:installer
Target version:Commercial edition - PE 2.0.3
Keywords:empathy Affected URL:
Branch: Affected PE version:
Votes: 0

Description

Overview

As part of project empathy I notice the installer does not describe “certname” very well. The prompt makes a lot of assumptions about the end user and the knowledge they possess about x.509 certificates and how they’re employed in the Puppet ecosystem.

The prompt is:

Puppet master's unique "certname"? [Default: pe-centos5.localdomain]

I’d expect the installer to specifically mention “certificate” and assume I do not know what a certificate is. In this way, I’d expect the installer to explain how it determined the value it automatically supplies as the suggested default. Finally, I’d expect a brief explanation of how Puppet uses this value for authentication and authorization.


Related issues

related to Puppet Enterprise (Public) - Bug #11173: PE installer does not explain "valid DNS names" prompt Merged - Pending Release 12/05/2011
related to Puppet Enterprise (Public) - Bug #11175: PE mysql password should be clarified Merged - Pending Release 12/05/2011

History

Updated by Jeff McCune 6 months ago

  • Keywords set to empathy

Updated by Matthaus Litteken 3 months ago

  • Status changed from Unreviewed to Investigating
  • Assignee set to Nick Fagerlund
  • Target version set to PE 2.0.x

Updated by Matthaus Litteken 3 months ago

  • Status changed from Investigating to Needs Decision

Updated by Nick Fagerlund 3 months ago

I’d expect the installer to specifically mention “certificate” and assume I do not know what a certificate is. In this way, I’d expect the installer to explain how it determined the value it automatically supplies as the suggested default. Finally, I’d expect a brief explanation of how Puppet uses this value for authentication and authorization.

That’s… a LOT to ask, without turning the installer into a wall of text. I am for-real struggling with this, and do not believe I can give you all of it without sacrificing usability. I’ll try.

Updated by Nick Fagerlund 3 months ago

To speak the unspoken requirement I’m trying to balance this with: You should be able to tell what question you’re looking at without reading the whole thing. I think that stops being possible at about 20 words.

Updated by Jeff McCune 3 months ago

This seems a lot less important in retrospect. Maybe:

I can’t come up with a good way to cram all this info in.

Maybe we just close this and keep an eye out for confusion around this question?

-Jeff

Updated by Nick Fagerlund 3 months ago

  • Status changed from Needs Decision to In Topic Branch Pending Review
  • Assignee changed from Nick Fagerlund to Jeff McCune

I think I’ve got a minor improvement, of this and the SSL questions. (pull request)

Assigning this and the related two to you for review. Cool?

Updated by Jeff McCune 3 months ago

  • Status changed from In Topic Branch Pending Review to Merged - Pending Release
  • Target version changed from PE 2.0.x to PE 2.0.3

Also available in: Atom PDF