openstack/openstack-manuals
Code Issues Proposed changes

Various cleanups in the nova chapter

Browse Source 
* Rebase against master

Change-Id: Idfadda7b68e046b5c3b2db5d7f2b43ad25adea85
This commit is contained in:
Shaun McCance 2013-10-16 23:47:01 -04:00 committed by annegentle
parent c5d8af97a1
commit 07acfa046f
3 changed files with 38 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/install-guide/section_nova-boot.xml
View File

@ -39,11 +39,11 @@
launched using mykey as the keypair. You can view available keypairs launched using mykey as the keypair. You can view available keypairs
using the <command>nova keypair-list</command> command.</para> using the <command>nova keypair-list</command> command.</para>
<screen><prompt>$</prompt> <userinput>nova keypair-list</userinput> <screen><prompt>$</prompt> <userinput>nova keypair-list</userinput>
<computeroutput>+-------+-------------------------------------------------+ <computeroutput>+--------+-------------------------------------------------+
| Name | Fingerprint | | Name | Fingerprint |
+-------+-------------------------------------------------+ +--------+-------------------------------------------------+
| mykey | b0:18:32:fa:4e:d4:3c:1b:c4:6c:dd:cb:53:29:13:82 | | mykey | b0:18:32:fa:4e:d4:3c:1b:c4:6c:dd:cb:53:29:13:82 |
+-------+-------------------------------------------------+</computeroutput></screen> +--------+-------------------------------------------------+</computeroutput></screen>
</step> </step>
<step><para>To launch an instance using OpenStack, you must specify the ID for the flavor you want to use <step><para>To launch an instance using OpenStack, you must specify the ID for the flavor you want to use
for the instance. A flavor is a resource allocation profile. For for the instance. A flavor is a resource allocation profile. For
@ -53,18 +53,18 @@
<screen><prompt>$</prompt> <userinput>nova flavor-list</userinput> <screen><prompt>$</prompt> <userinput>nova flavor-list</userinput>
<computeroutput>+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+ <computeroutput>+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+
| ID | Name | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor | Is_Public | | ID | Name | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor | Is_Public |
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+ +----+-----------+-----------+------+-----------+------+-------+-------------+-----------+
| 1 | m1.tiny | 512 | 1 | 0 | | 1 | 1.0 | True | | 1 | m1.tiny | 512 | 1 | 0 | | 1 | 1.0 | True |
| 2 | m1.small | 2048 | 20 | 0 | | 1 | 1.0 | True | | 2 | m1.small | 2048 | 20 | 0 | | 1 | 1.0 | True |
| 3 | m1.medium | 4096 | 40 | 0 | | 2 | 1.0 | True | | 3 | m1.medium | 4096 | 40 | 0 | | 2 | 1.0 | True |
| 4 | m1.large | 8192 | 80 | 0 | | 4 | 1.0 | True | | 4 | m1.large | 8192 | 80 | 0 | | 4 | 1.0 | True |
| 5 | m1.xlarge | 16384 | 160 | 0 | | 8 | 1.0 | True | | 5 | m1.xlarge | 16384 | 160 | 0 | | 8 | 1.0 | True |
+----+-----------+-----------+------+-----------+------+-------+-------------+-----------+</computeroutput></screen> +----+-----------+-----------+------+-----------+------+-------+-------------+-----------+</computeroutput></screen>
</step> </step>
<step> <step>
<para>Get the ID of the image you would like to use for the instance using the <para>Get the ID of the image you would like to use for the instance using the
<command>nova image-list</command> command.</para> <command>nova image-list</command> command.</para>
<screen><prompt>$</prompt> nova image-list <screen><prompt>$</prompt> <userinput>nova image-list</userinput>
<computeroutput>+--------------------------------------+--------------+--------+--------+ <computeroutput>+--------------------------------------+--------------+--------+--------+
| ID | Name | Status | Server | | ID | Name | Status | Server |
+--------------------------------------+--------------+--------+--------+ +--------------------------------------+--------------+--------+--------+

2
doc/install-guide/section_nova-compute.xml
View File

@ -139,7 +139,7 @@ admin_password=<replaceable>NOVA_DBPASS</replaceable>
<filename>/etc/nova/nova.conf</filename>.</para></note> <filename>/etc/nova/nova.conf</filename>.</para></note>
</step> </step>
<step> <step>
<para os="fedora;rhel;centos;opensuse;Sles">Start the Compute service and configure it to start when the system boots.</para> <para os="fedora;rhel;centos;opensuse;sles">Start the Compute service and configure it to start when the system boots.</para>
<para os="ubuntu;debian">Restart the Compute service.</para> <para os="ubuntu;debian">Restart the Compute service.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-compute restart</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-compute restart</userinput></screen>
<screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput> <screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-compute start</userinput>

59
doc/install-guide/section_nova-network.xml
View File

@ -12,6 +12,7 @@
<note><para>If you require the full software-defined networking stack, see <link <note><para>If you require the full software-defined networking stack, see <link
linkend="ch_neutron">Using Neutron Networking</link>.</para></note> linkend="ch_neutron">Using Neutron Networking</link>.</para></note>
<procedure> <procedure>
<title>Enable networking on a compute node</title>
<step><para>After performing initial configuration of the compute node, <step><para>After performing initial configuration of the compute node,
install the appropriate packages for compute networking.</para> install the appropriate packages for compute networking.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install nova-network</userinput></screen>
@ -21,23 +22,22 @@
<step> <step>
<para>First, set the configuration options needed in <filename>nova.conf</filename> for the chosen networking mode.</para> <para>First, set the configuration options needed in <filename>nova.conf</filename> for the chosen networking mode.</para>
<screen os="fedora;rhel;centos;opensuse;sles"> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_manager nova.network.manager.FlatDHCPManager</userinput> network_manager nova.network.manager.FlatDHCPManager</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT firewall_driver nova.virt.libvirt.firewall.IptablesFirewallDriver</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT \
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_size 254</userinput> firewall_driver nova.virt.libvirt.firewall.IptablesFirewallDriver</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT routing_source_ip ADDRESS</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT network_size 254</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT allow_same_net_traffic False</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT routing_source_ip ADDRESS</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT multi_host True</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT allow_same_net_traffic False</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT send_arp_for_ha True</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT multi_host True</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT share_dhcp_address True</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT send_arp_for_ha True</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT force_dhcp_release True</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT share_dhcp_address True</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_interface eth1</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT force_dhcp_release True</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_network_bridge br100</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_interface eth1</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT public_interface br100</userinput> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT flat_network_bridge br100</userinput>
</screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT public_interface br100</userinput></screen>
<para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para> <para os="ubuntu;debian">Edit <filename>/etc/nova/nova.conf</filename> and add to the <literal>[DEFAULT]</literal> section.</para>
<programlisting os="ubuntu;debian" language="ini"> <programlisting os="ubuntu;debian" language="ini">[DEFAULT]
[DEFAULT]
... ...
network_manager=nova.network.manager.FlatDHCPManager network_manager=nova.network.manager.FlatDHCPManager
@ -52,22 +52,23 @@ flat_network_bridge=br100
flat_interface=eth1 flat_interface=eth1
public_interface=eth0 public_interface=eth0
</programlisting> </programlisting>
</step> </step>
<step> <step>
<para>Now, restart the relevant services:</para> <para os="ubuntu;debian">Restart the network service.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service nova-network restart</userinput></screen>
<screen os="ubuntu;debian"> <para os="fedora;rhel;centos;opensuse;sles">Start the network service and configure it to start when the system boots.</para>
<prompt>#</prompt> <userinput>service nova-network restart</userinput></screen> <screen os="centos;rhel;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-nova-network restart</userinput>
<screen os="centos;rhel;fedora;opensuse;sles"> <prompt>#</prompt> <userinput>chkconfig openstack-nova-network on</userinput></screen>
<prompt>#</prompt> <userinput>service openstack-nova-network restart</userinput></screen>
</step>
<step>
<para>You must run the command that creates the network that the virtual machines use.
You only need to run this command once, from a place where your admin user credentials are loaded.</para>
<screen>source keystonerc</screen>
<screen><prompt>#</prompt> <userinput>nova network-create vmnet --fixed-range-v4=10.0.0.0/24 --bridge-interface=br100 --multi-host=T</userinput></screen>
</step> </step>
</procedure> </procedure>
<para>Finally, you have to create a network that virtual machines can use. You
only need to do this once for the entire installation, not for each compute node.
Run the <command>nova network-create</command> command anywhere your admin user
credentials are loaded.</para>
<screen><prompt>#</prompt> <userinput>source keystonerc</userinput></screen>
<screen><prompt>#</prompt> <userinput>nova network-create vmnet --fixed-range-v4=10.0.0.0/24 \
--bridge-interface=br100 --multi-host=T</userinput></screen>
</section> </section>