<div dir="ltr"><div>My apologies, it was Dan Florea looking for the Nicira plugin information. We <3 all the Dans all the time!<br><br></div>Anne<br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Nov 4, 2013 at 5:03 PM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div>I think this is a good way to go, but I'd like to see most of the use cases in the configuration reference with just one or two happy paths in the install guide. This pattern would be more like the way pluggable cinder is documented, I think. <br>
<br></div>Dan Wendlandt was looking for the Nicira plugin docs last wee, for example, and Nermina's going to add them to the configuration reference. <br><br></div>I'd prefer simplicity in the install guide and deep dives in the configuration reference, what do you think?<br>
<br>Anne<br></div><div class="gmail_extra"><div><div class="h5"><br><br><div class="gmail_quote">On Mon, Nov 4, 2013 at 1:50 PM, Solly Ross <span dir="ltr"><<a href="mailto:sross@redhat.com" target="_blank">sross@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Having both ML2 and OVS documented sounds good to me. Currently, I'm a bit busy tracking down and fixing a bug involving communication between Nova and Cinder, but if nobody else has written such a section by the time I have finished, I can take a shot at adding a path to the Neutron install guide for ML2. The patch that you referenced seems to have targeted the use cases section only, and not the main "Installing Networking Services" section.<br>
<br>
As for the Use Case section, my suggestion would be to have each use case specify a particular path through the guide, so it would read like "Use Case: XYZ. The XYZ use case covers the situation when you want to have the QPW XTZ the NPO. In an XZY setup, all QPWs have LXYs. In order to set up this use case, you should follow the main documentation, and choose to follow the OVS path with GRE networking and no namespaces." In fact, we could generalize this to broader OpenStack "typical setup" use cases, and have each OpenStack "typical setup" have a particular path through the guide with a list of documentation "modules" to follow to get that setup (e.g. "Follow sections 1 (Basic Setup), 2 (Keystone), ..., 9 (Neutron, and choose the OVS plugin with GRE tunneling), and 10 (Orchestration)." This way, if somebody goes up to the guide without having already figured out what they want, they'll have a couple suggested paths to follow.<br>
<br>
Best Regards,<br>
Solly Ross<br>
<div><div><br>
----- Original Message -----<br>
From: "Andreas Jaeger" <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>><br>
To: <a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a><br>
Cc: "Solly Ross" <<a href="mailto:sross@redhat.com" target="_blank">sross@redhat.com</a>><br>
Sent: Monday, November 4, 2013 2:31:45 PM<br>
Subject: network plug-in options in install guide<br>
<br>
Looking at the guide, you see cross-references jumping to other sections.<br>
<br>
Solly said in <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1244759" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bug/1244759</a> :<br>
"The idea with the sections for the different plugins was that some of<br>
the other companies/organizations with their own plugins would fill in<br>
parts for their own sections."<br>
<br>
Right now only Open vSwitch is documented. Instead of replacing Open<br>
vSwitch with ML2 (see <a href="https://review.openstack.org/#/c/54644/" target="_blank">https://review.openstack.org/#/c/54644/</a>), why not<br>
have both ML2 and Open vSwitch documented as two different options there?<br>
<br>
We still would need to decide what to use in the "Neutron deployment use<br>
cases"<br>
(<a href="http://docs.openstack.org/trunk/install-guide/install/zypper/content/neutron-deploy-use-cases.html" target="_blank">http://docs.openstack.org/trunk/install-guide/install/zypper/content/neutron-deploy-use-cases.html</a>)<br>
- but that whole content is IMHO so inconsistent with the rest that it<br>
needs a rewrite anyway.<br>
<br>
Andreas<br>
--<br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><br></div></div><span class="HOEnZb"><font color="#888888">-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</font></span></div>
</blockquote></div><br><br clear="all"><br>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div>