f3ecb24050
As part of the installation guide improvement project, I performed the following operations on the Nova networking sections of the installation guide: 1) Split configuration and initial network creation section to align with structure of Neutron chapter. 2) Aligned phrasing/wording and examples with Neutron chapter. 3) Removed defunct ch_neutron.xml from repository. 4) Modified links affected by these changes. 5) Updated glossary as necessary. Change-Id: I690a7c2565826f4370940a716a6200e974211d8f Partial-Bug: #1291071 Implements: blueprint networking-install-guide-improvements
44 lines
2.2 KiB
XML
44 lines
2.2 KiB
XML
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="nova-network-initial-network">
|
|
<title>Create initial network</title>
|
|
<para>Before launching your first instance, you must create the necessary
|
|
virtual network infrastructure to which the instance will connect.
|
|
This network typically provides internet access
|
|
<emphasis>from</emphasis> instances. You can enable internet access
|
|
<emphasis>to</emphasis> individual instances using a
|
|
<glossterm>floating IP address</glossterm> and suitable
|
|
<glossterm>security group</glossterm> rules. The <literal>admin</literal>
|
|
tenant owns this network because it provides external network access
|
|
for multiple tenants.</para>
|
|
<para>This network shares the same <glossterm>subnet</glossterm>
|
|
associated with the physical network connected to the external
|
|
<glossterm>interface</glossterm> on the compute node. You should specify
|
|
an exclusive slice of this subnet to prevent interference with other
|
|
devices on the external network.</para>
|
|
<note>
|
|
<para>Perform these commands on the controller node.</para>
|
|
</note>
|
|
<procedure>
|
|
<title>To create the network:</title>
|
|
<step>
|
|
<para>Source the <literal>admin</literal> tenant credentials:</para>
|
|
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Create the network:</para>
|
|
<para>Replace <replaceable>NETWORK_CIDR</replaceable> with the subnet
|
|
associated with the physical network.</para>
|
|
<screen><prompt>$</prompt> <userinput>nova network-create demo-net --bridge br100 --multi-host T \
|
|
--fixed-range-v4 <replaceable>NETWORK_CIDR</replaceable></userinput></screen>
|
|
<para>For example, using an exclusive slice of
|
|
<literal>203.0.113.0/24</literal> with IP address range
|
|
<literal>203.0.113.24</literal> to <literal>203.0.113.32</literal>:
|
|
</para>
|
|
<screen><prompt>$</prompt> <userinput>nova network-create demo-net --bridge br100 --multi-host T \
|
|
--fixed-range-v4 203.0.113.24/29</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|