[Openstack-docs] Basic OS configuration chapter in installation guide

Tom Fifield tom at openstack.org
Mon Mar 24 01:10:59 UTC 2014


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.




More information about the Openstack-docs mailing list