<p dir="ltr">I disagree with the overall sentiment, but I agree that we shouldn't clutter up the guide with os-specific instructions. The fact is that you might have someone who understands networking but comes from the Windows world, or whose expertise lies in a different area of OpenStack - related technologies. I think it's disingenuous at best to say "if you can't set up networking you have no business being here." We might as well say "Not an expert in all things OpenStack? Go get a distro, this isn't for you."</p>
<p dir="ltr">The whole point of revisiting the install and admin guides was to FIX THIS PROBLEM, in which the guides don't provide enough information for someone who hasn't done this before.</p>
<p dir="ltr">Now, again, not saying we should clutter up the guide with conditionals. I'm in favor of taking the specifics and devoting them to an appendix if necessary. </p>
<p dir="ltr">---- Nick</p>
<div class="gmail_quote">On Mar 23, 2014 9:10 PM, "Tom Fifield" <<a href="mailto:tom@openstack.org">tom@openstack.org</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 24/03/14 02:55, Andreas Jaeger wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 03/22/2014 11:45 PM, Matt Kassawara wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
While updating the networking section of the basic OS configuration<br>
chapter in the installation guide, I found my step-by-step instructions<br>
quickly making the source file rather large and complex with plenty of<br>
"os" conditionals. Do we really need to provide step-by-step<br>
instructions for basic OS configuration including network interfaces,<br>
name resolution, etc? I would much rather include more generic steps and<br>
let users reference their distribution's documentation for specific<br>
instructions.<br>
<br>
For example:<br>
<br>
Use this...<br>
<br>
Compute node<br>
<br>
1) Configure the network interfaces:<br>
a) Management (eth0)<br>
<br>
IP address: 10.0.0.31<br>
Netmask: 255.255.255.0<br>
Gateway: 10.0.0.1<br>
<br>
b) External (eth1) ...<br>
</blockquote>
<br>
I agree, let's be more generic. We still might need to add one or two<br>
sentences per distro overall - like saying do not use NetworkManager on<br>
Fedora - but that's overall and not specific to each single step.<br>
<br>
<br>
Andreas<br>
</blockquote>
<br>
+1 - I agree, that without the understanding to do these basic networking steps, your ability to perform the rest of the install guide is limited. Though, if anything there is "complex", some hints might be worthy. For example, maybe not everyone is used to dealing with multiple interfaces.<br>
<br>
<br>
______________________________<u></u>_________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</blockquote></div>