Open Stack

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."

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.

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.

---- Nick
On Mar 23, 2014 9:10 PM, "Tom Fifield" <tom at openstack.org> wrote:

> On 24/03/14 02:55, Andreas Jaeger wrote:
>
>> On 03/22/2014 11:45 PM, Matt Kassawara wrote:
>>
>>> 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.
>>>
>>> For example:
>>>
>>> Use this...
>>>
>>> Compute node
>>>
>>> 1) Configure the network interfaces:
>>>    a) Management (eth0)
>>>
>>>    IP address: 10.0.0.31
>>>    Netmask: 255.255.255.0
>>>    Gateway: 10.0.0.1
>>>
>>>    b) External (eth1) ...
>>>
>>
>> I agree, let's be more generic. We still might need to add one or two
>> sentences per distro overall - like saying do not use NetworkManager on
>> Fedora - but that's overall and not specific to each single step.
>>
>>
>> Andreas
>>
>
> +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.
>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140323/b6b78ab3/attachment-0001.html>