The few that know me here know that I am a little OCD about documentation, so I have some suggestions and questions regarding “Install and configure Chef server using your hardware or cloud provider” (https://learn.chef.io/install-and-manage-your-own-chef-server/linux/install-chef-server/install-chef-server-using-your-hardware ):
Suggestion: - Tell the user to make sure that the node in which they will install the Chef server has enough resources (I tried in AWS with a t2.micro and it complained of lack of memory; it worked fine with a t2.large; it seems it will work with a t2.medium, as that’s the one I used for the Chef server from the AWS marketplace).
Suggestion: - Tell the user that when running sudo chef-manage-ctl reconfigure, the installer will ask them to read a license, and that you exit from it with the “q” key and then you need to write “yes”.
Question: It says “You always create the initial user account directly from the Chef server on the command line. Later, you can add additional users from the command line or through the management console.”. Are you sure? If the management console is installed, the first user can be created with it (at least that’s what I did when I installed my Chef Server from the AWS marketplace).
Suggestion: Document this: When creating the organization with the chef-server-ctl command: the ORG_SHORT_NAME has to be all-lowercase otherwise it will complain:
$ sudo chef-server-ctl org-create mayitoOrg “MayitoO” --association_user mrincodi
ERROR: The data in your request was invalid
Response: Field ‘name’ invalid
$ sudo chef-server-ctl org-create mayito “Mayito Org, Inc.” --association_user mrincodi
-----BEGIN RSA PRIVATE KEY-----
This looks like a cosmetic bug to me: at least specify in the Response the constraints of this field.
Suggestion: Of course, another cosmetic suggestion is this one: Do not to generate nor display the RSA private key that chef-server-ctl org-create writes to the console in the chef-server-ctl org-create command (I imagine this will be done eventually).
Question: It says ” During the bootstrap process, knife copies the [Chef Server] certificate from your workstation to the node.” To the node? What for? Are you sure this is OK?