User guide needs updating
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Ironic |
Fix Released
|
Medium
|
Chason Chan |
Bug Description
There are a few problems with the user guide right now:
http://
Cosmetically, is not formatted properly for RST. Lines are too long and some have extra non-printing characters.
The diagrams are also misleading, if not incorrect.
http://
Figure 1.3.1 "Deployment Architecture" places ir-cond on the same host as n-cpu, which is not advisable in some situations. It should be made clear that a security-conscious operator should place ir-cond on an isolated host, as it is the *only* service which requires access to both data plane and IPMI control plane. This same diagram suggests placing ir-api on a monolithic "Cloud Controller Node", but does not explain why this unusual choice was made. Lastly, it does not include any depiction of the physical servers which Ironic is going to manage, nor the IPMI network connectivity to them which is required.
http://
Figure 1.3.3 "Bare Metal Deployment Steps" looks like an adaptation of an old diagram of mine, but it is now significantly factually incorrect.
http://
The "Deploy Process" section describes fetching the deploy kernel & ramdisk from the nova flavor; this was done in Icehouse, but is no longer recommended in Juno. There are several references to a "bare metal database" which is misleading, if not incorrect.
Additionally, much of this is overly specific to the pxe_ipmitool driver, which will not be the only driver in the Juno release.
Changed in ironic: | |
status: | New → Triaged |
importance: | Undecided → Medium |
milestone: | none → juno-3 |
Changed in ironic: | |
assignee: | nobody → Ruby Loo (rloo) |
Changed in ironic: | |
milestone: | juno-3 → juno-rc1 |
Changed in ironic: | |
milestone: | juno-rc1 → none |
Changed in ironic: | |
status: | In Progress → Triaged |
Changed in ironic: | |
assignee: | nobody → Chason (chen-xing) |
Fix proposed to branch: master /review. openstack. org/116168
Review: https:/