Bug 994028
| Summary: | [Doc] Clarify multi-tenant networking requirements. | ||
|---|---|---|---|
| Product: | Red Hat OpenStack | Reporter: | Stephen Gordon <sgordon> |
| Component: | doc-Installation_and_Configuration_Guide | Assignee: | Martin Lopes <mlopes> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | ecs-bugs |
| Severity: | medium | Docs Contact: | |
| Priority: | medium | ||
| Version: | 4.0 | CC: | bholden, lpeer, mnewby, slong, yeylon |
| Target Milestone: | --- | Keywords: | Documentation, Triaged |
| Target Release: | 5.0 (RHEL 7) | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2015-03-10 03:36:06 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: | |||
| Bug Depends On: | |||
| Bug Blocks: | 1049118 | ||
|
Description
Stephen Gordon
2013-08-06 13:58:39 UTC
Steve, looks like you have an idea of the content for this? Do you need any more info to get going? > Suggestions for improvement:
>
> Clarify up from that multi-tenant networking requires VLANs.
Or GRE/VXLAN tunnels. We'll definitely have GRE tunnels in RHOS 4.0/RHEL 6.5. VXLAN is likely but not certain yet.
Also from Brent Holden on the dev mailing list (prompting this bug): Can the documentation be updated with a sample visual architecture? For example, if you server has 2 NICs, which side needs VLANs configured for tenant networks? What interfaces need to be bound to which bridges? There's no visual guide to help the user understand and it's difficult to wrap your head around some of the practical realities of how it would be setup. See this for an example: https://github.com/ansible/ansible-redhat-openstack/blob/master/README.md A reference setup (with graphics) at the beginning of the quantum description would be immensely helpful. It's not clear until later that the setup requires GRE or VLANs to be useful for multi-tenants. For someone wading in to how to setup quantum, it's a painful experience that requires visits to websites and forums that mostly aren't our properties. This may come off as whiny but I'm trying to relate my experiences of getting quantum setup for our labs, which would likely closely mimic a customer's experience. I've put these here. If they are too big a task for the rework, will need to split off into separate bugs. This content was previously added. Link: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html-single/Installation_and_Configuration_Guide/index.html#Configuring_Open_vSwitch_tunnels Includes: * Sample architecture diagram. * Specific mention of VLANs role in multi-tenant networking. * Describes how tunnels allows this functionality to span between nodes. * Sample tunnel configuration steps. |