<div dir="ltr">That would work for me, as long as we point them to the very specific location in the docs where they can find it as opposed to "Check the networking section in (choose your distro)'s docs, home page here."<div>
<br></div><div>----  Nick</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Mar 24, 2014 at 9:12 AM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</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"><br><div class="gmail_extra"><br><br><div class="gmail_quote"><div class="">On Sat, Mar 22, 2014 at 7:20 PM, Phil Hopkins <span dir="ltr"><<a href="mailto:phil.hopkins@rackspace.com" target="_blank">phil.hopkins@rackspace.com</a>></span> wrote:<br>


<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">If one cannot set up networking one doesn't need to be installing Openstack, My $0.02<br>
<br></blockquote><div><br></div></div><div>Phil, I can't have us thinking this way yet... everyone takes a meandering path to OpenStack and may not have all the (pick your distro) networking knowledge we'd like. We have to be advocates for our users no matter where they started their journey. I won't ever be persuaded by this line of thinking.</div>


<div><br></div><div>That said, Matt's arguments are sound for maintenance purposes. We heavily rely on MySQL documentation for all but the very basics. Can we draw a similar line here and refer to the distro's documentation for networking? </div>
<span class="HOEnZb"><font color="#888888">

<div><br></div><div>Anne </div></font></span><div><div class="h5"><div><br></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Phil<br>
Sent from my iPhone<br>
<div><div><br>
> On Mar 22, 2014, at 5:45 PM, "Matt Kassawara" <<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>> wrote:<br>
><br>
> While updating the networking section of the basic OS configuration chapter in the installation guide, I found my step-by-step instructions quickly making the source file rather large and complex with plenty of "os" conditionals. Do we really need to provide step-by-step instructions for basic OS configuration including network interfaces, name resolution, etc? I would much rather include more generic steps and let users reference their distribution's documentation for specific 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>
><br>
> Instead of this...<br>
><br>
> Compute node<br>
><br>
> 1) Configure the management network interface:<br>
>   a) Edit the /etc/sysconfig/network-scripts/ifcfg-eth0 file to include the following:<br>
><br>
> ONBOOT="yes"<br>
> NM_CONTROLLED="no"<br>
> BOOTPROTO="static"<br>
> IPADDR="10.0.0.31"<br>
> NETMASK="255.255.255.0"<br>
> BROADCAST="10.0.0.255"<br>
> GATEWAY="10.0.0.1"<br>
><br>
> 2) Configure the external network interface:<br>
>   b) Edit the /etc/sysconfig/network-scripts/ifcfg-eth1 file ...<br>
</div></div>> _______________________________________________<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>
<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>
</blockquote></div></div></div><br></div></div>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">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>
<br></blockquote></div><br></div>