Bug 1303730
| Summary: | [Docs] [Director] Bullet Point About External Network Connections Not Right For Compute Nodes. | ||
|---|---|---|---|
| Product: | Red Hat OpenStack | Reporter: | Bernie Hoefer <bhoefer> |
| Component: | documentation | Assignee: | Dan Macpherson <dmacpher> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | RHOS Documentation Team <rhos-docs> |
| Severity: | low | Docs Contact: | |
| Priority: | high | ||
| Version: | 7.0 (Kilo) | CC: | adahms, bhoefer, srevivo |
| Target Milestone: | ga | Keywords: | Documentation |
| Target Release: | 9.0 (Mitaka) | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2016-08-16 16:50:12 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
Assigning to Dan for review. I think this was a miscommunication on my behalf. I'll check with Dan on the proper way to word this. Hi Bernie, I think has been resolved: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html-single/Director_Installation_and_Usage/index.html#sect-Scenario_2_Using_the_CLI_to_Create_a_Basic_Overcloud The line now says: "One network connection for our External network. All Controller nodes must connect to this network. For this example, we use 10.1.1.0/24 for the External network." How does this sound to you? Sorry for the delay. I took a look and yes, that looks good! Thank you, Dan! One more thought: section 6.1 deals with a simple, 3 server deployment. (A director, a controller and a compute node.) The requirements listed refer back to Section 2.4.1 & 2.4.2. Those sections state: + the compute node needs at least 1x 1Gbps NIC + the controller node needs at least 2x 1Gbps NICs Since a picture is worth a thousand words. What about replacing Table 6.2 with a network diagram showing: + the director connected to the Provisioning network; + one of the controller's NICs connected to the Provisioning network and the other NIC connected to the External network; + the compute node connected to the Provisioning network; and + the labels listed in Table 6.2, including the External network's "10.1.1.0/24" (which is not in Table 6.2). If this sound doable and desired, I'll open another BZ for it. Hi Bernie, We've got a diagram like that that's used as an example in the planning section: https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/paged/director-installation-and-usage/32-planning-networks It's a more complex version with full network isolation, but it pretty much provides the same level of detail. The table however is serving a different purpose: it's more to act as a reference for the IPs. I've seen some system admins use this tables to document their own environments and IP listings (Red Hat's own Chris Long was my test user case and he did this when he was setting up his environment, so I kind of included a similar methodology). (In reply to Dan Macpherson from comment #7) === > We've got a diagram like that that's used as an example in the planning > section: > > https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/ > paged/director-installation-and-usage/32-planning-networks === Ah, OK. Thanks! Having not gone through the whole document, I missed that network diagram. It should be good, then. No worries. If there's nothing else required, I'll close this BZ. Thanks for your input on the docs! |
Description of problem: Chapter 6.2 of the _Director Installation and Usage_ guide ("Scenario 2: Using the CLI to Create a Basic Overcloud") contains this bullet point: "One network connection for our External network. All nodes must connect to this network." Thus, users conclude even compute nodes need a connection to the external network. A peer in SBR-Stack confirmed that the compute node does not need connected to the external network. In fact, he said that according to Principal OpenStack Software Engineer Dan Sneddon, having an external network interface on the compute node is *not even supported.* Since the "All nodes" wording of that bullet point can lead customers to a configuration that is not supported, it is requested the wording be changed. (Perhaps to "All non-compute nodes", or something like that.) [1]<https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/sect-Scenario_2_Using_the_CLI_to_Create_a_Basic_Overcloud.html>