Doc review of config chap

Bug #1608516 reported by Alexandra Settle
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
osic-ref-impl
New
Undecided
Unassigned

Bug Description

The following are a list of questions/issues with the content. All sourced from here: https://github.com/osic/ref-impl/blob/master/documents/osic-deploy/osic-configure.rst

Section: Configuring the LXC container
1. Step 2, the step is "If you changed the IP address in a previous step..." - there is no previous step with editing the IP address. What does this refer to?

2. Step 3 - could we have an example config of reconfigured DHCP settings? What are we reconfiguring?

3. At the end of the section, it states: "...a CSV file must be created." Can we link to the below section? If so, can we rename the section? It is confusing.

Section: PXE boot the servers
1. Explanation on why we need MAC addresses?

2. Step 3 - "Use the information from your onboarding email to create the CSV." If this is to go into the greater community, this has to be removed and enabled to be accessed by all.

3. "...it is used to create another CSV file used as input for many different steps in the build process." - What type of steps? Where are these steps? Should we be linking to them?

Section: Assigning a cobbler profile
1. Cobbler is included without much context - could we have an overview section on the addition of cobbler? Is it cobbler or Cobbler?

Section: Bootstrapping the servers
1. It is a bit confusing having the information for OSA servers, and non-OSA servers within the same section. Could we separate into two different sections please?

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.