openstack-manuals/doc/user-guide/section_dashboard_create_networks.xml
Karin Levenstein fca88670a4 Edits to the End User Guide dashboard chapter with corrections from Anne G
Change-Id: Ia9961bbdab446e15930d0b31176c37fe1d532b8f
2014-04-14 10:16:06 -05:00

194 lines
8.2 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash "&#x2013;">
<!ENTITY mdash "&#x2014;">
<!ENTITY hellip "&#x2026;">
]>
<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="dashboard_create_networks">
<title>Create and manage networks</title>
<?dbhtml stop-chunking?>
<para>The OpenStack Networking service provides a scalable
system for managing the network connectivity within an OpenStack
cloud deployment. It can easily and quickly react to changing
network needs (for example, creating and assigning new IP
addresses).</para>
<para>Networking in OpenStack is complex. This section provides the
basic instructions for creating a network and a router. For
detailed information about managing networks, refer to the <link
xlink:href="http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html"
><emphasis role="italic">OpenStack Cloud Administrator
Guide</emphasis></link>.</para>
<section xml:id="dashboard_create_network">
<title>Create a network</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and click
<guibutton>Networks</guibutton>.</para>
</step>
<step>
<para>Click <guibutton>Create Network</guibutton>.</para>
</step>
<step>
<para>In the Create Network dialog box, specify the
following values.</para>
<informaltable rules="all" width="75%">
<col width="30%"/>
<col width="70%"/>
<thead>
<tr>
<th colspan="2" align="center"
><guilabel>Network</guilabel> tab</th>
</tr>
</thead>
<tbody>
<tr>
<td><para><guilabel>Network Name</guilabel></para></td>
<td><para>Specify a name to identify the network.</para></td>
</tr>
<tr>
<th colspan="2" align="center">
<guilabel>Subnet</guilabel> tab</th>
</tr>
<tr>
<td><para><guilabel>Create Subnet</guilabel></para></td>
<td><para>Select this check box to create a
subnet</para><para>You do not have to specify a subnet
when you create a network, but if you do not, any
attached instance receives an Error status.</para></td>
</tr>
<tr>
<td><para><guilabel>Subnet Name</guilabel></para></td>
<td><para>Specify a name for the subnet.</para></td>
</tr>
<tr>
<td><para><guilabel>Network Address</guilabel></para></td>
<td><para>Specify the IP address for the subnet.</para></td>
</tr>
<tr>
<td><para><guilabel>IP Version</guilabel></para></td>
<td><para>Select IPv4 or IPv6.</para></td>
</tr>
<tr>
<td><para><guilabel>Gateway IP</guilabel></para></td>
<td><para>Specify an IP address for a specific gateway. This parameter is
optional.</para></td>
</tr>
<tr>
<td><para><guilabel>Disable Gateway</guilabel></para></td>
<td><para>Select this check box to disable a gateway IP address.</para></td>
</tr>
<tr>
<th colspan="2" align="center"
><guilabel>Subnet Detail</guilabel> tab</th>
</tr>
<tr>
<td><para><guilabel>Enable DHCP</guilabel></para></td>
<td><para>Select this check box to enable DHCP.</para></td>
</tr>
<tr>
<td><para><guilabel>Allocation Pools</guilabel></para></td>
<td><para>Specify IP address pools.</para></td>
</tr>
<tr>
<td><para><guilabel>DNS Name Servers</guilabel></para></td>
<td><para>Specify a name for the DNS server.</para></td>
</tr>
<tr>
<td><para><guilabel>Host Routes</guilabel></para></td>
<td><para>Specify the IP address of host routes.</para></td>
</tr>
</tbody>
</informaltable>
</step>
<step>
<para>Click <guilabel>Create</guilabel>.</para>
<para>The dashboard shows the network on the
<guilabel>Networks</guilabel> tab.</para>
</step>
</procedure>
</section>
<section xml:id="dashboard_create_router">
<title>Create a router</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and click
<guibutton>Routers</guibutton>.</para>
</step>
<step>
<para>Click <guibutton>Create Router</guibutton>.</para>
</step>
<step><para>In the Create Router dialog box, specify a name for the router
and click <guibutton>Create Router</guibutton>.</para>
<para>The new router is now displayed in the
<guilabel>Routers</guilabel> tab.</para>
</step>
<step>
<para>Click the new router's <guibutton>Set Gateway</guibutton> button.
</para>
</step>
<step>
<para>In the <guilabel>External Network</guilabel> field,
specify the network to which the router will connect, and
then click <guibutton>Set Gateway</guibutton>.</para>
</step>
<step>
<para>To connect a private network to the newly created
router, perform the following steps:</para>
<substeps>
<step>
<para>On the <guilabel>Routers</guilabel> tab, click the
name of the router.</para>
</step>
<step>
<para>On the Router Details page, click <guilabel>Add
Interface</guilabel>.</para>
</step>
<step>
<para>In the Add Interface dialog box, specify the
following information:</para>
<informaltable rules="all" width="75%">
<col width="30%"/>
<col width="70%"/>
<tbody>
<tr>
<td>
<para><guilabel>Subnet</guilabel>
</para>
</td>
<td>
<para>Select a subnet.</para>
</td>
</tr>
<tr>
<td>
<para><guilabel>IP Address (optional)</guilabel></para>
</td>
<td>
<para>Enter the router interface IP address for the
selected subnet.</para>
<para>Note: If this value is not set, then by
default, the first host IP address in the subnet
is used by OpenStack Networking.</para>
</td>
</tr>
</tbody>
</informaltable>
<para>The <guilabel>Router Name</guilabel> and <guilabel>Router ID</guilabel>
fields are automatically updated.</para>
</step>
</substeps>
</step>
<step>
<para>Click <guilabel>Add Interface</guilabel>.</para>
</step>
</procedure>
<para>You have successfully created the router. You can view
the new topology from the <guilabel>Network Topology</guilabel>
tab.</para>
</section>
</section>