Minor edits to the install guide
- Removed revision history grizzly and prior - Edit for Neutron/OpenStack Networking Change-Id: I4273eef0699056f10a75abe906ec2220edc7248b
This commit is contained in:
Anne Gentle
Andreas Jaeger
parent
5154c458a6
commit
cfa87df9fa
@ -175,377 +175,6 @@
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-04-30</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Grizzly release.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-04-18</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates and clean up on the Object
|
||||
Storage installation.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-04-08</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Adds a note about availability of
|
||||
Grizzly packages on Ubuntu and
|
||||
Debian.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-04-03</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates RHEL/CentOS/Fedora
|
||||
information for Grizzly
|
||||
release.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-03-26</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates Dashboard (Horizon)
|
||||
information for Grizzly
|
||||
release.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-02-12</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Adds chapter about Essex to Folsom
|
||||
upgrade for Compute and related
|
||||
services (excludes OpenStack Object
|
||||
Storage (Swift) and OpenStack
|
||||
Networking (Quantum)).</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2013-01-16</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Fix file copy issue for figures in
|
||||
the /common/ directory.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-11-09</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Folsom release of this
|
||||
document.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-10-10</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1054459"
|
||||
>1054459</link><link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1064745"
|
||||
>1064745</link></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-09-26</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Adds an all-in-one install
|
||||
section.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-07-23</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Adds additional detail about
|
||||
installing and configuring
|
||||
nova-volumes.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/978510"
|
||||
>978510</link>
|
||||
<link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1027230"
|
||||
>1027230</link></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-07-17</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Update build process so two
|
||||
uniquely-named PDF files are
|
||||
output.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-07-13</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1025840"
|
||||
>1025840</link>
|
||||
<link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1025847"
|
||||
>1025847</link></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-06-19</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Fix PDF links.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/967778"
|
||||
>967778</link>
|
||||
<link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984959"
|
||||
>984959</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1002294"
|
||||
>1002294</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1010163"
|
||||
>1010163</link>.</para>
|
||||
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-05-31</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Revise install guide to encompass
|
||||
more Linux distros.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/996988"
|
||||
>996988</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/998116"
|
||||
>998116</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/999005"
|
||||
>999005</link>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-05-03</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Fixes problems with
|
||||
<filename>glance-api-paste.ini</filename>
|
||||
and
|
||||
<filename>glance-registry-paste.ini</filename>
|
||||
samples and instructions.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Removes "DRAFT" designation.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-05-02</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Essex release.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-05-01</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates the Object Storage and
|
||||
Identity (Keystone)
|
||||
configuration.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-04-25</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Changes service_id copy/paste error
|
||||
for the EC2 service-create
|
||||
command.</para>
|
||||
<para>Adds verification steps for Object
|
||||
Storage installation.</para>
|
||||
<para>Fixes
|
||||
<filename>proxy-server.conf</filename>
|
||||
file so it points to keystone not
|
||||
tempauth.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-04-23</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Adds installation and configuration
|
||||
for multi-node Object Storage
|
||||
service.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-04-17</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/983417"
|
||||
>983417</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984106"
|
||||
>984106</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/984034"
|
||||
>984034</link></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-04-13</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977905"
|
||||
>977905</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/980882"
|
||||
>980882</link>, <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977823"
|
||||
>977823</link>, adds additional
|
||||
Glance database preparation
|
||||
steps</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-04-10</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Doc bug fixes: <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/977831"
|
||||
>977831</link></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-03-23</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates for Xen hypervisor.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-03-09</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Updates for Essex release, includes
|
||||
new Glance config files, new Keystone
|
||||
configuration.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2012-01-24</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Initial draft for Essex.</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Assumes use of Ubuntu 12.04
|
||||
repository.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
<revision>
|
||||
<date>2011-01-24</date>
|
||||
<revdescription>
|
||||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Initial draft for Diablo.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</revdescription>
|
||||
</revision>
|
||||
</revhistory>
|
||||
</info>
|
||||
|
||||
|
||||
@ -5,26 +5,25 @@
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
xmlns:svg="http://www.w3.org/2000/svg"
|
||||
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0">
|
||||
<title>Configure compute node</title>
|
||||
<title>Configure compute node with neutron services</title>
|
||||
<note>
|
||||
<para>This section details set up for any node that runs the
|
||||
<literal>nova-compute</literal> component but does not run
|
||||
the full network stack.</para>
|
||||
</note>
|
||||
<warning os="rhel;centos">
|
||||
<para>By default, the <literal>system-config-firewall</literal>
|
||||
automated firewall configuration tool is in place on RHEL.
|
||||
This graphical interface (and a curses-style interface with
|
||||
<literal>-tui</literal> on the end of the name) enables you
|
||||
to configure IP tables as a basic firewall. You should disable
|
||||
it when you work with Neutron unless you are familiar with the
|
||||
underlying network technologies, as, by default, it blocks
|
||||
various types of network traffic that are important to
|
||||
Neutron. To disable it, simple launch the program and clear
|
||||
the <guilabel>Enabled</guilabel> check box.</para>
|
||||
<para>After you successfully set up OpenStack with Neutron, you
|
||||
can re-enable and configure the tool. However, during Neutron
|
||||
set up, disable the tool to make it easier to debug network
|
||||
<para>By default, the <literal>system-config-firewall</literal> automated
|
||||
firewall configuration tool is in place on RHEL. This graphical interface
|
||||
(and a curses-style interface with <literal>-tui</literal> on the end of
|
||||
the name) enables you to configure IP tables as a basic firewall. You
|
||||
should disable it when you work with OpenStack Networking unless you are
|
||||
familiar with the underlying network technologies, as, by default, it
|
||||
blocks various types of network traffic that are important to neutron
|
||||
services. To disable it, launch the program and clear the
|
||||
<guilabel>Enabled</guilabel> check box.</para>
|
||||
<para>After you successfully set up OpenStack Networking with Neutron, you
|
||||
can re-enable and configure the tool. However, during OpenStack
|
||||
Networking setup, disable the tool to make it easier to debug network
|
||||
issues.</para>
|
||||
</warning>
|
||||
<procedure>
|
||||
@ -246,7 +245,7 @@ firewall_driver=neutron.agent.linux.iptables_firewall.OVSHybridIptablesFirewallD
|
||||
</step>
|
||||
</procedure>
|
||||
<section xml:id="install-neutron.install-plugin-compute">
|
||||
<title>Install and configure Neutron plug-ins on a dedicated
|
||||
<title>Install and configure OpenStack Networking plug-ins on a dedicated
|
||||
compute node</title>
|
||||
<section xml:id="install-neutron.install-plugin-compute.ovs">
|
||||
<title>Install the Open vSwitch (OVS) plug-in on a dedicated
|
||||
|
||||
@ -7,24 +7,20 @@
|
||||
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0">
|
||||
<title>Create initial networks</title>
|
||||
<note>
|
||||
<para>In these sections, replace
|
||||
<replaceable>SPECIAL_OPTIONS</replaceable> with any options
|
||||
specific to your Networking plug-in choices. See <link
|
||||
linkend="install-neutron.configure-networks.plug-in-specific"
|
||||
>here</link> to check if your plug-in requires any special
|
||||
options.</para>
|
||||
<para>In these sections, replace <replaceable>SPECIAL_OPTIONS</replaceable> with any options specific to your OpenStack Networking plug-in choices. See <link
|
||||
linkend="install-neutron.configure-networks.plug-in-specific"
|
||||
>here</link> to check if your plug-in requires any special options.</para>
|
||||
</note>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>Create the <literal>ext-net</literal> external network.
|
||||
This network represents a slice of the outside world. VMs
|
||||
are not directly linked to this network; instead, they
|
||||
connect to internal networks. Outgoing traffic is routed by
|
||||
Neutron to the external network. Additionally, floating IP
|
||||
addresses from the subnet for <literal>ext-net</literal>
|
||||
might be assigned to VMs so that the external network can
|
||||
contact them. Neutron routes the traffic
|
||||
appropriately.</para>
|
||||
<para>Create the <literal>ext-net</literal> external network. This
|
||||
network represents a slice of the outside world. VMs are not directly
|
||||
linked to this network; instead, they connect to internal networks.
|
||||
Outgoing traffic is routed by OpenStack Networking to the external
|
||||
network. Additionally, floating IP addresses from the subnet for
|
||||
<literal>ext-net</literal> might be assigned to VMs so that the
|
||||
external network can contact them. Neutron-based services route the
|
||||
traffic appropriately.</para>
|
||||
<screen><prompt>#</prompt> <userinput>neutron net-create ext-net --router:external=True <replaceable>SPECIAL_OPTIONS</replaceable></userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
@ -116,16 +112,38 @@ router_id = <replaceable>EXT_TO_INT_ID</replaceable></programlisting>
|
||||
for any other network.</para>
|
||||
<note>
|
||||
<para>These options are not needed beyond the first
|
||||
network, as Neutron automatically increments the
|
||||
segmentation id and copy the network type option for any
|
||||
additional networks.</para>
|
||||
network, as OpenStack Networking services automatically
|
||||
increment the segmentation ID and copy the network type
|
||||
option for any additional networks.</para>
|
||||
</note>
|
||||
<para>Now, return to the general <acronym>OVS</acronym>
|
||||
<para>Now, return to the general <link linkend="install-neutron.install-plugin-compute.ovs"></link><acronym>OVS</acronym>
|
||||
instructions.</para>
|
||||
</section>
|
||||
<section
|
||||
xml:id="install-neutron.configure-networks.plug-in-specific.ovs.vlan">
|
||||
<title>VLAN network options</title>
|
||||
<warning>
|
||||
<para>Some NICs have Linux drivers that do not handle
|
||||
VLANs properly. See the
|
||||
<literal>ovs-vlan-bug-workaround</literal> and
|
||||
<literal>ovs-vlan-test</literal> man pages for more
|
||||
information. Additionally, you might try turning off
|
||||
<literal>rx-vlan-offload</literal> and
|
||||
<literal>tx-vlan-offload</literal> by using
|
||||
<command>ethtool</command> on the
|
||||
<replaceable>DATA_INTERFACE</replaceable>. Another
|
||||
potential caveat to VLAN functionality is that VLAN tags
|
||||
add an additional 4 bytes to the packet size. If your
|
||||
NICs cannot handle large packets, make sure to set the
|
||||
MTU to a value that is 4 bytes less than the normal
|
||||
value on the
|
||||
<replaceable>DATA_INTERFACE</replaceable>.</para>
|
||||
<para>If you run OpenStack inside a virtualized
|
||||
environment (for testing purposes), switching to the
|
||||
<literal>virtio</literal> NIC type (or a similar
|
||||
technology if you are not using KVM/QEMU to run your
|
||||
host VMs) might solve the issue.</para>
|
||||
</warning>
|
||||
<para>When creating networks, use these options:</para>
|
||||
<screen><userinput>--provider:network_type vlan --provider:physical_network physnet1 --provider:segmentation_id SEG_ID</userinput> </screen>
|
||||
<para><replaceable>SEG_ID</replaceable> should be
|
||||
@ -140,28 +158,6 @@ router_id = <replaceable>EXT_TO_INT_ID</replaceable></programlisting>
|
||||
only needed if you wish to modify those values in any
|
||||
way.</para>
|
||||
</note>
|
||||
<warning>
|
||||
<para>Some NICs have Linux drivers that do not handle
|
||||
VLANs properly. See the
|
||||
<literal>ovs-vlan-bug-workaround</literal> and
|
||||
<literal>ovs-vlan-test</literal> man pages for more
|
||||
information. Additionally, you might try turning off
|
||||
<literal>rx-vlan-offload</literal> and
|
||||
<literal>tx-vlan-offload</literal> by using
|
||||
<literal>ethtool</literal> on the
|
||||
<replaceable>DATA_INTERFACE</replaceable>. Another
|
||||
potential caveat to VLAN functionality is that VLAN tags
|
||||
add an additional 4 bytes to the packet size. If your
|
||||
NICs cannot handle large packets, make sure to set the
|
||||
MTU to a value that is 4 bytes less than the normal
|
||||
value on the
|
||||
<replaceable>DATA_INTERFACE</replaceable>.</para>
|
||||
<para>If you run OpenStack inside a virtualized
|
||||
environment (for testing purposes), switching to the
|
||||
<literal>virtio</literal> NIC type (or a similar
|
||||
technology if you are not using KVM/QEMU to run your
|
||||
host VMs) might solve the issue.</para>
|
||||
</warning>
|
||||
</section>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user