Restructured and updated basic environment config chapter
As part of the installation guide improvement project, I performed the following operations on the basic environment configuration chapter of the installation guide: 1) Split large ch_basics.xml file into smaller files to ease addition of new networking content and future updates. 2) Added information on how to install on VMs. 3) Added recommended minimum hardware requirements for each node. 4) Built detailed instructions for network configuration on three-node neutron and two-node nova example architectures including verification of connectivity using name resolution. 5) Clarified phrasing and wording. 6) Updated glossary as necessary. This patch primarily updates networking content in this chapter. Change-Id: Ib31a99448757d36ae29ff8069ddbeab8fe0106bd Partial-Bug: #1291071 Implements: blueprint networking-install-guide-improvements
This commit is contained in:
Matt Kassawara
parent
e207423d38
commit
ab3b945c26
@ -906,6 +906,13 @@
|
||||
storage services for VMs.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>CirrOS</glossterm>
|
||||
<glossdef>
|
||||
<para>A minimal Linux distribution designed for use as a test
|
||||
image on clouds such as OpenStack.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>Cisco neutron plug-in</glossterm>
|
||||
<glossdef>
|
||||
@ -1876,6 +1883,13 @@
|
||||
</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>external network</glossterm>
|
||||
<glossdef>
|
||||
<para>A network segment typically used for instance Internet
|
||||
access.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>extra specs</glossterm>
|
||||
<glossdef>
|
||||
@ -2523,6 +2537,13 @@
|
||||
<para>The current state of a guest VM image.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>instance tunnels network</glossterm>
|
||||
<glossdef>
|
||||
<para>A network segment used for instance traffic tunnels
|
||||
between compute nodes and the network node.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>instance type</glossterm>
|
||||
<glossdef>
|
||||
@ -2811,6 +2832,14 @@
|
||||
requests evenly between designated instances.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>Logical Volume Manager (LVM)</glossterm>
|
||||
<glossdef>
|
||||
<para>Provides a method of allocating space on mass-storage
|
||||
devices that is more flexible than conventional
|
||||
partitioning schemes.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
</glossdiv>
|
||||
<!-- .M. -->
|
||||
<glossdiv>
|
||||
@ -3573,6 +3602,14 @@
|
||||
<para>Alternative term for a cloudpipe.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>promiscuous mode</glossterm>
|
||||
<glossdef>
|
||||
<para>Causes the network interface to pass all traffic it
|
||||
receives to the host rather than passing only the frames
|
||||
addressed to it.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
<glossentry>
|
||||
<glossterm>provider</glossterm>
|
||||
<glossdef>
|
||||
|
||||
@ -2,659 +2,36 @@
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="ch_basics">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Basic operating system configuration</title>
|
||||
<title>Basic environment configuration</title>
|
||||
<warning>
|
||||
<para>We are updating this material for Icehouse. You may find structure
|
||||
and/or content issues during this process.</para>
|
||||
</warning>
|
||||
<para>This guide shows you how to create a controller node to host most
|
||||
services and a compute node to run virtual machine instances. Subsequent
|
||||
chapters create additional nodes to run more services. OpenStack is flexible
|
||||
about how and where you run each service, so other configurations are
|
||||
possible. However, you must configure certain operating system settings on
|
||||
each node.</para>
|
||||
<para>This chapter explains how to configure each node in the
|
||||
<link linkend="architecture_example-architectures">example architectures</link>
|
||||
including the <link linkend="example-architecture-with-legacy-networking">
|
||||
two-node architecture with legacy networking</link> and
|
||||
<link linkend="example-architecture-with-neutron-networking">three-node
|
||||
architecture with OpenStack Networking (neutron)</link>.</para>
|
||||
<note>
|
||||
<para>You can install OpenStack Object Storage with OpenStack Identity as a
|
||||
starting point rather than installing OpenStack Compute. You cannot use
|
||||
the OpenStack dashboard unless you also install Compute and the Image
|
||||
Service. If object storage is your use case, you can skip these operating
|
||||
system configuration requirements and refer to <link
|
||||
linkend="object-storage-system-requirements"/> instead.</para>
|
||||
<para>Although most environments include OpenStack Identity, Image Service,
|
||||
Compute, at least one networking service, and the dashboard, OpenStack
|
||||
Object Storage can operate independently of most other services. If your
|
||||
use case only involves Object Storage, you can skip to
|
||||
<xref linkend="object-storage-system-requirements"/>. However, the
|
||||
dashboard will not work without at least OpenStack Image Service and
|
||||
Compute.</para>
|
||||
</note>
|
||||
<para>This chapter details a sample configuration for the controller node and
|
||||
any additional nodes. You can configure the operating system in other ways,
|
||||
but this guide assumes that your configuration is compatible with the one
|
||||
described here.</para>
|
||||
<para>All example commands assume you have administrative privileges. Either
|
||||
run the commands as the root user or prefix them with the
|
||||
<command>sudo</command> command.</para>
|
||||
|
||||
|
||||
<section xml:id="before-you-begin">
|
||||
<title>Before you begin</title>
|
||||
|
||||
<para>We strongly recommend that you install a 64-bit operating system on
|
||||
your compute nodes. If you use a 32-bit operating system, attempting a
|
||||
start a virtual machine using a 64-bit image will fail with an
|
||||
error.</para>
|
||||
|
||||
<para>For more information about system requirements, see the <link
|
||||
xlink:href="http://docs.openstack.org/ops/">OpenStack Operations
|
||||
Guide</link>.</para>
|
||||
</section>
|
||||
<section xml:id="basics-networking">
|
||||
<title>Networking</title>
|
||||
<para>For an OpenStack production deployment, most nodes must have these
|
||||
network interface cards:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>One network interface card for external network traffic.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Another card to communicate with other OpenStack nodes.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>For simple test cases, you can use machines with a single network
|
||||
interface card.</para>
|
||||
<para>The following example configures Networking on two networks with
|
||||
<glossterm baseform="static IP address">static IP addresses</glossterm>
|
||||
and manually manages a list of host names on each machine. If you manage a
|
||||
large network, you might already have systems in place to manage this. If
|
||||
so, you can skip this section but note that the rest of this guide assumes
|
||||
that each node can reach the other nodes on the internal network by using
|
||||
the <literal>controller</literal> and <literal>compute1</literal> host
|
||||
names.</para>
|
||||
<!-- these fedora only paragraphs are confirmed not needed in centos -->
|
||||
<para os="fedora">Disable the <systemitem class="service"
|
||||
>NetworkManager</systemitem> service and enable the <systemitem
|
||||
class="service">network</systemitem> service. The <systemitem
|
||||
class="service">network</systemitem> service is more suitable for the
|
||||
static network configuration done in this guide.</para>
|
||||
|
||||
<screen os="fedora"><prompt>#</prompt> <userinput>service NetworkManager stop</userinput>
|
||||
<prompt>#</prompt> <userinput>service network start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig NetworkManager off</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig network on</userinput></screen>
|
||||
<note os="fedora">
|
||||
<para>Since Fedora 19, <literal>firewalld</literal> replaces
|
||||
<literal>iptables</literal> as the default firewall system.</para>
|
||||
<para>You can use <literal>firewalld</literal> successfully, but this
|
||||
guide recommends and demonstrates the use of the default
|
||||
<literal>iptables</literal>.</para>
|
||||
<para>For Fedora 19 systems, run the following commands to disable
|
||||
<literal>firewalld</literal> and enable
|
||||
<literal>iptables</literal>:</para>
|
||||
<screen><prompt>#</prompt> <userinput>service firewalld stop</userinput>
|
||||
<prompt>#</prompt> <userinput>service iptables start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig firewalld off</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig iptables on</userinput></screen>
|
||||
</note>
|
||||
<warning os="centos;rhel">
|
||||
<para>RHEL and derivatives including CentOS and Scientific Linux enable a
|
||||
restrictive <glossterm>firewall</glossterm> by default. During this
|
||||
installation, certain steps will fail unless you alter this setting or
|
||||
disable the firewall. For further information about securing your
|
||||
installation, refer to the <link
|
||||
xlink:href="http://docs.openstack.org/sec/">OpenStack Security
|
||||
Guide</link>.</para>
|
||||
</warning>
|
||||
<para os="opensuse;sles">When you set up your system, use the traditional
|
||||
network scripts and do not use <systemitem class="service"
|
||||
>NetworkManager</systemitem>. You can change the settings after
|
||||
installation with the YaST network module:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
|
||||
<para>Configure both <literal>eth0</literal> and <literal>eth1</literal>.
|
||||
The examples in this guide use the
|
||||
<literal>192.168.0.<replaceable>x</replaceable></literal> IP addresses
|
||||
for the internal network and the
|
||||
<literal>10.0.0.<replaceable>x</replaceable></literal> IP addresses
|
||||
for the external network. Make sure to connect your network devices to the
|
||||
correct network.</para>
|
||||
<para>In this guide, the controller node uses the
|
||||
<literal>192.168.0.10</literal> and <literal>10.0.0.10</literal> IP
|
||||
addresses. When you create the compute node, use the
|
||||
<literal>192.168.0.11</literal> and <literal>10.0.0.11</literal>
|
||||
addresses instead. Additional nodes that you add in subsequent chapters
|
||||
also follow this pattern.</para>
|
||||
<figure xml:id="basic-architecture-networking">
|
||||
<title>Basic architecture</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="6in"
|
||||
fileref="figures/basic-architecture-networking.svg"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<example os="fedora">
|
||||
<title><filename>/etc/sysconfig/network-scripts/ifcfg-eth0</filename></title>
|
||||
<programlisting language="ini"># Internal Network
|
||||
DEVICE=eth0
|
||||
TYPE=Ethernet
|
||||
BOOTPROTO=static
|
||||
IPADDR=192.168.0.10
|
||||
NETMASK=255.255.255.0
|
||||
DEFROUTE=yes
|
||||
ONBOOT=yes</programlisting>
|
||||
</example>
|
||||
<example os="fedora">
|
||||
<title><filename>/etc/sysconfig/network-scripts/ifcfg-eth1</filename></title>
|
||||
<programlisting language="ini"># External Network
|
||||
DEVICE=eth1
|
||||
TYPE=Ethernet
|
||||
BOOTPROTO=static
|
||||
IPADDR=10.0.0.10
|
||||
NETMASK=255.255.255.0
|
||||
DEFROUTE=yes
|
||||
ONBOOT=yes</programlisting>
|
||||
</example>
|
||||
<para os="opensuse;sles">To configure the network interfaces, start the YaST
|
||||
network module, as follows:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
|
||||
<itemizedlist os="opensuse;sles">
|
||||
<listitem>
|
||||
<para>Use these parameters to set up the <literal>eth0</literal>
|
||||
Ethernet card for the internal network:</para>
|
||||
<programlisting>Statically assigned IP Address
|
||||
IP Address: 192.168.0.10
|
||||
Subnet Mask: 255.255.255.0</programlisting>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Use these parameters to set up the <literal>eth1</literal>
|
||||
Ethernet card for the external network:</para>
|
||||
<programlisting>Statically assigned IP Address
|
||||
IP Address: 10.0.0.10
|
||||
Subnet Mask: 255.255.255.0</programlisting>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Set up a default route on the external network.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<example os="ubuntu;debian">
|
||||
<title><filename>/etc/network/interfaces</filename></title>
|
||||
<programlisting language="ini"># Internal Network
|
||||
auto eth0
|
||||
iface eth0 inet static
|
||||
address 192.168.0.10
|
||||
netmask 255.255.255.0
|
||||
|
||||
# External Network
|
||||
auto eth1
|
||||
iface eth1 inet static
|
||||
address 10.0.0.10
|
||||
netmask 255.255.255.0</programlisting>
|
||||
</example>
|
||||
<para>After you configure the network, restart the daemon for changes to
|
||||
take effect:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service networking restart</userinput></screen>
|
||||
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>service network restart</userinput></screen>
|
||||
<para>Set the host name of each machine. Name the controller node
|
||||
<literal>controller</literal> and the first compute node
|
||||
<literal>compute1</literal>. The examples in this guide use these host
|
||||
names.</para>
|
||||
<para os="ubuntu;debian;fedora;rhel;centos">Use the
|
||||
<command>hostname</command> command to set the host name:
|
||||
<screen><prompt>#</prompt> <userinput>hostname controller</userinput></screen></para>
|
||||
<para os="opensuse;sles">Use <command>yast network</command> to set the host
|
||||
name with YaST.</para>
|
||||
<para os="rhel;fedora;centos">To have the host name change persist when the
|
||||
system reboots, you must specify it in the proper configuration file. In
|
||||
Red Hat Enterprise Linux, CentOS, and older versions of Fedora, you set
|
||||
this in the file <filename>/etc/sysconfig/network</filename>. Change the
|
||||
line starting with <literal>HOSTNAME=</literal>.</para>
|
||||
<programlisting language="ini" os="rhel;fedora;centos">HOSTNAME=controller</programlisting>
|
||||
<para os="fedora">As of Fedora 18, Fedora uses the
|
||||
<filename>/etc/hostname</filename> file, which contains a single line
|
||||
with the host name.</para>
|
||||
<para os="ubuntu;debian">To configure this host name to be available when
|
||||
the system reboots, you must specify it in the
|
||||
<filename>/etc/hostname</filename> file, which contains a single line
|
||||
with the host name.</para>
|
||||
<para>Finally, ensure that each node can reach the other nodes by using host
|
||||
names. You must manually edit the <filename>/etc/hosts</filename> file on
|
||||
each system. For large-scale deployments, use DNS or a configuration
|
||||
management system like Puppet.</para>
|
||||
<programlisting>127.0.0.1 localhost
|
||||
192.168.0.10 controller
|
||||
192.168.0.11 compute1</programlisting>
|
||||
</section>
|
||||
<section xml:id="basics-ntp">
|
||||
<title>Network Time Protocol (NTP)</title>
|
||||
<para>To synchronize services across multiple machines, you must install
|
||||
<glossterm baseform="Network Time Protocol (NTP)">NTP</glossterm>. The
|
||||
examples in this guide configure the controller node as the reference
|
||||
server and any additional nodes to set their time from the controller
|
||||
node.</para>
|
||||
<para>Install the <literal>ntp</literal> package on each system running
|
||||
OpenStack services.</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ntp</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install ntp</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install ntp</userinput></screen>
|
||||
<para os="rhel;fedora;centos;opensuse;sles">Set up the NTP server on your
|
||||
controller node so that it receives data by modifying the
|
||||
<filename>ntp.conf</filename> file and restarting the service.</para>
|
||||
<screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service ntpd start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig ntpd on</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service ntp start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig ntp on</userinput></screen>
|
||||
<para>On additional nodes, it is advised that you configure the other nodes
|
||||
to synchronize their time from the controller node rather than from
|
||||
outside of your LAN. To do so, install the ntp daemon as above, then edit
|
||||
<filename>/etc/ntp.conf</filename> and change the <code>server</code>
|
||||
directive to use the controller node as internet time source.</para>
|
||||
</section>
|
||||
<section xml:id="basics-passwords"
|
||||
os="ubuntu;rhel;fedora;centos;opensuse;sles">
|
||||
<title>Passwords</title>
|
||||
<para>The various OpenStack services and the required software like the
|
||||
database and the messaging server have to be password protected. You use
|
||||
these passwords when configuring a service and then again to access the
|
||||
service. You have to choose a password while configuring the service and
|
||||
later remember to use the same password when accessing it. Optionally, you
|
||||
can generate random passwords with the <application>pwgen</application>
|
||||
program. Or, to create passwords one at a time, use the output of this
|
||||
command repeatedly:
|
||||
<screen><prompt>$</prompt> <userinput>openssl rand -hex 10</userinput></screen>
|
||||
</para>
|
||||
<para>This guide uses the convention that
|
||||
<literal><replaceable>SERVICE_PASS</replaceable></literal> is password
|
||||
to access the service <literal>SERVICE</literal> and
|
||||
<literal><replaceable>SERVICE_DBPASS</replaceable></literal> is the
|
||||
database password used by the service SERVICE to access the database.</para>
|
||||
<para>The complete list of passwords you need to define in this guide are:
|
||||
<table rules="all">
|
||||
<caption>Passwords</caption>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Password name</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Database password (no variable used)</td>
|
||||
<td>Root password for the database</td>
|
||||
</tr>
|
||||
<tr os="ubuntu;opensuse;sles">
|
||||
<td><literal><replaceable>RABBIT_PASS</replaceable></literal></td>
|
||||
<td>Password of user guest of RabbitMQ</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>KEYSTONE_DBPASS</replaceable></literal></td>
|
||||
<td>Database password of Identity service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>ADMIN_PASS</replaceable></literal></td>
|
||||
<td>Password of user <literal>admin</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>GLANCE_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for Image Service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>GLANCE_PASS</replaceable></literal></td>
|
||||
<td>Password of Image Service user <literal>glance</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NOVA_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for Compute service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NOVA_PASS</replaceable></literal></td>
|
||||
<td>Password of Compute service user <literal>nova</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>DASH_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the dashboard</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CINDER_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Block Storage service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CINDER_PASS</replaceable></literal></td>
|
||||
<td>Password of Block Storage service user
|
||||
<literal>cinder</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NEUTRON_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Networking service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NEUTRON_PASS</replaceable></literal></td>
|
||||
<td>Password of Networking service user
|
||||
<literal>neutron</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>HEAT_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Orchestration service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>HEAT_PASS</replaceable></literal></td>
|
||||
<td>Password of Orchestration service user
|
||||
<literal>heat</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CEILOMETER_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Telemetry service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CEILOMETER_PASS</replaceable></literal></td>
|
||||
<td>Password of Telemetry service user
|
||||
<literal>ceilometer</literal></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section xml:id="basics-database">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>MySQL database</title>
|
||||
<para os="ubuntu;debian;rhel;fedora;centos">Most OpenStack services require
|
||||
a database to store information. These examples use a MySQL database that
|
||||
runs on the controller node. You must install the MySQL database on the
|
||||
controller node. You must install MySQL client software on any additional
|
||||
nodes that access MySQL.</para>
|
||||
<para os="opensuse;sles">Most OpenStack services require a database to store
|
||||
information. This guide uses a MySQL database on SUSE Linux Enterprise
|
||||
Server and a compatible database on openSUSE running on the controller
|
||||
node. This compatible database for openSUSE is MariaDB. You must install
|
||||
the MariaDB database on the controller node. You must install the MariaDB
|
||||
client software on any nodes that access the MariaDB database.</para>
|
||||
|
||||
<section xml:id="basics-database-controller">
|
||||
<title>Controller setup</title>
|
||||
<para><phrase os="sles">For SUSE Linux Enterprise Server: </phrase> On the
|
||||
controller node, install the MySQL client and server packages, and the
|
||||
Python library.</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mysql-client mysql python-mysql</userinput></screen>
|
||||
<para os="opensuse">For openSUSE: On the controller node, install the
|
||||
MariaDB client and database server packages, and the MySQL Python
|
||||
library.</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mariadb-client mariadb python-mysql</userinput></screen>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-mysqldb mysql-server</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install mysql mysql-server MySQL-python</userinput></screen>
|
||||
<note os="ubuntu;debian">
|
||||
<para>When you install the server package, you are prompted for the root
|
||||
password for the database. Choose a strong password and remember
|
||||
it.</para>
|
||||
</note>
|
||||
<para>The MySQL configuration requires some changes to work with
|
||||
OpenStack.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para os="ubuntu;debian">Edit the
|
||||
<filename>/etc/mysql/my.cnf</filename> file:</para>
|
||||
<para os="opensuse;sles;rhel;fedora;centos">Edit the
|
||||
<filename>/etc/my.cnf</filename> file:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>Under the <literal>[mysqld]</literal> section, set the
|
||||
<literal>bind-address</literal> key to the management IP
|
||||
address of the controller node to enable access by other nodes
|
||||
via the management network:</para>
|
||||
<programlisting>[mysqld]
|
||||
...
|
||||
bind-address = 192.168.0.10</programlisting>
|
||||
</step>
|
||||
<step>
|
||||
<para>Under the <literal>[mysqld]</literal> section, set the
|
||||
following keys to enable InnoDB, UTF-8 character set, and
|
||||
UTF-8 collation by default:</para>
|
||||
<programlisting>[mysqld]
|
||||
...
|
||||
default-storage-engine = innodb
|
||||
collation-server = utf8_general_ci
|
||||
init-connect = 'SET NAMES utf8'
|
||||
character-set-server = utf8</programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
</procedure>
|
||||
<para os="ubuntu;debian">Restart the MySQL service to apply the
|
||||
changes:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mysql restart</userinput></screen>
|
||||
<para os="rhel;centos;fedora;opensuse;sles">Start the <phrase
|
||||
os="rhel;fedora;centos">MySQL</phrase>
|
||||
<phrase os="opensuse;sles">MariaDB or MySQL</phrase> database server and
|
||||
set it to start automatically when the system boots.</para>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>service mysqld start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig mysqld on</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service mysql start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig mysql on</userinput></screen>
|
||||
<para os="rhel;centos;fedora;opensuse;sles">Finally, you should set a root
|
||||
password for your <phrase os="rhel;fedora;centos">MySQL</phrase>
|
||||
<phrase os="opensuse;sles">MariaDB or MySQL</phrase> database. The
|
||||
OpenStack programs that set up databases and tables prompt you for this
|
||||
password if it is set.</para>
|
||||
<para os="ubuntu;debian;rhel;centos;fedora;opensuse;sles">You must delete
|
||||
the anonymous users that are created when the database is first started.
|
||||
Otherwise, database connection problems occur when you follow the
|
||||
instructions in this guide. To do this, use the
|
||||
<command>mysql_secure_installation</command> command. Note that if
|
||||
<command>mysql_secure_installation</command> fails you might need to
|
||||
use <command>mysql_install_db</command> first:</para>
|
||||
<screen os="ubuntu;debian;rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>mysql_install_db</userinput>
|
||||
<prompt>#</prompt> <userinput>mysql_secure_installation</userinput></screen>
|
||||
<para><phrase os="rhel;centos;fedora;opensuse;sles">If you have not
|
||||
already set a root database password, press <keycap>ENTER</keycap>
|
||||
when you are prompted for the password.</phrase> This command presents
|
||||
a number of options for you to secure your database installation.
|
||||
Respond <userinput>yes</userinput> to all prompts unless you have a good
|
||||
reason to do otherwise.</para>
|
||||
</section>
|
||||
|
||||
<section xml:id="basics-database-node">
|
||||
<title>Node setup</title>
|
||||
<para>On all nodes other than the controller node, install the <phrase
|
||||
os="ubuntu;debian;rhel;fedora;centos">MySQL</phrase>
|
||||
<phrase os="opensuse">MariaDB (on openSUSE)</phrase> client and the
|
||||
MySQL Python library on any system that does not host a MySQL
|
||||
database:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-mysqldb</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install mysql MySQL-python</userinput></screen>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mariadb-client python-mysql</userinput></screen>
|
||||
<para os="sles">For SUSE Linux Enterprise, install MySQL:</para>
|
||||
<screen os="sles"><prompt>#</prompt> <userinput>zypper install mysql-client python-mysql</userinput></screen>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<section xml:id="basics-packages">
|
||||
<title>OpenStack packages</title>
|
||||
<para>Distributions might release OpenStack packages as part of their
|
||||
distribution or through other methods because the OpenStack and
|
||||
distribution release times are independent of each other.</para>
|
||||
<para>This section describes the configuration you must complete after you
|
||||
configure machines to install the latest OpenStack packages.</para>
|
||||
<para os="fedora;centos;rhel">The examples in this guide use the OpenStack
|
||||
packages from the RDO repository. These packages work on Red Hat
|
||||
Enterprise Linux 6, compatible versions of CentOS, and Fedora 20. To
|
||||
enable the RDO repository, download and install the
|
||||
<package>rdo-release-icehouse</package> package.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://repos.fedorapeople.org/repos/openstack/openstack-icehouse/rdo-release-icehouse-1.noarch.rpm</userinput></screen>
|
||||
<para os="fedora;centos;rhel">The EPEL package includes GPG keys for package
|
||||
signing and repository information. This should only be installed on Red
|
||||
Hat Enterprise Linux and CentOS, not Fedora. Install the latest
|
||||
<package>epel-release</package> package (see <link
|
||||
xlink:href="http://download.fedoraproject.org/pub/epel/6/x86_64/repoview/epel-release.html"
|
||||
>http://download.fedoraproject.org/pub/epel/6/x86_64/repoview/epel-release.html</link>).
|
||||
For example:</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</userinput></screen>
|
||||
<para os="fedora;centos;rhel">The <package>openstack-utils</package> package
|
||||
contains utility programs that make installation and configuration easier.
|
||||
These programs are used throughout this guide. Install
|
||||
<package>openstack-utils</package>. This verifies that you can access
|
||||
the RDO repository.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-utils</userinput></screen>
|
||||
<para os="opensuse;sles">Use the Open Build Service repositories for
|
||||
<glossterm>Icehouse</glossterm> based on your openSUSE or SUSE Linux
|
||||
Enterprise Server version, for example if you run openSUSE 12.3
|
||||
use:</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/openSUSE_12.3 Icehouse</userinput></screen>
|
||||
<para os="opensuse">For openSUSE 13.1 use:</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/openSUSE_13.1 Icehouse</userinput></screen>
|
||||
<para os="sles">If you use SUSE Linux Enterprise Server 11 SP3, use:</para>
|
||||
<screen os="sles"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/SLE_11_SP3 Icehouse</userinput></screen>
|
||||
<para os="opensuse;sles">The <package>openstack-utils</package> package
|
||||
contains utility programs that make installation and configuration easier.
|
||||
These programs are used throughout this guide. Install
|
||||
<package>openstack-utils</package>. This verifies that you can access
|
||||
the Open Build Service repository:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-utils</userinput></screen>
|
||||
<warning os="fedora;centos;rhel;opensuse;sles">
|
||||
<para>The <application>openstack-config</application> program in the
|
||||
<package>openstack-utils</package> package uses
|
||||
<application>crudini</application> to manipulate configuration files.
|
||||
However, <application>crudini</application> version 0.3 does not support
|
||||
multi valued options. See <link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1269271"
|
||||
>https://bugs.launchpad.net/openstack-manuals/+bug/1269271</link>. As
|
||||
a work around, you must manually set any multi valued options or the new
|
||||
value overwrites the previous value instead of creating a new
|
||||
option.</para>
|
||||
</warning>
|
||||
<para os="fedora;centos;rhel">The <package>openstack-selinux</package>
|
||||
package includes the policy files that are required to configure SELinux
|
||||
during OpenStack installation. Install
|
||||
<package>openstack-selinux</package>.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-selinux</userinput></screen>
|
||||
<para os="fedora;centos;rhel;opensuse;sles">Upgrade your system
|
||||
packages:</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum upgrade</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper refresh</userinput>
|
||||
<prompt>#</prompt> <userinput>zypper update</userinput></screen>
|
||||
<para os="fedora;centos;rhel;opensuse;sles">If the upgrade included a new
|
||||
kernel package, reboot the system to ensure the new kernel is
|
||||
running:</para>
|
||||
<screen os="fedora;centos;rhel;opensuse;sles"><prompt>#</prompt> <userinput>reboot</userinput></screen>
|
||||
<procedure xml:id="ubuntu-cloud-archive" os="ubuntu">
|
||||
<title>To use the Ubuntu Cloud Archive for Icehouse</title>
|
||||
<para>The <link
|
||||
xlink:href="https://wiki.ubuntu.com/ServerTeam/CloudArchive">Ubuntu
|
||||
Cloud Archive</link> is a special repository that allows you to
|
||||
install newer releases of OpenStack on the stable supported version of
|
||||
Ubuntu.</para>
|
||||
<step>
|
||||
<para>Install the Ubuntu Cloud Archive for
|
||||
<glossterm>Icehouse</glossterm>:
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install python-software-properties</userinput>
|
||||
<prompt>#</prompt> <userinput>add-apt-repository cloud-archive:icehouse</userinput></screen></para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the package database, upgrade your system, and reboot for
|
||||
all changes to take effect:
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get dist-upgrade</userinput>
|
||||
<prompt>#</prompt> <userinput>reboot</userinput> </screen></para>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure xml:id="debian-cloud-archive" os="debian">
|
||||
<title>To use the Debian Wheezy backports archive for Icehouse</title>
|
||||
<para>The <glossterm>Icehouse</glossterm> release is available only in
|
||||
Debian Sid (otherwise called Unstable). However, the Debian maintainers
|
||||
of OpenStack also maintain a non-official Debian repository for
|
||||
OpenStack containing Wheezy backports.</para>
|
||||
<step>
|
||||
<para>Install the Debian Wheezy backport repository Icehouse:</para>
|
||||
<screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian icehouse-backports main" >>/etc/apt/sources.list</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Install the Debian Wheezy OpenStack repository for
|
||||
Icehouse:</para>
|
||||
<screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian icehouse main" >>/etc/apt/sources.list</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the repository database and install the key:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get install gplhost-archive-keyring</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the package database, upgrade your system, and reboot for
|
||||
all changes to take effect:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get dist-upgrade</userinput>
|
||||
<prompt>#</prompt> <userinput>reboot</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<para os="debian">Numerous archive.gplhost.com mirrors are available around
|
||||
the world. All are available with both FTP and HTTP protocols (you should
|
||||
use the closest mirror). The list of mirrors is available at <link
|
||||
xlink:href="http://archive.gplhost.com/readme.mirrors"
|
||||
>http://archive.gplhost.com/readme.mirrors</link>.</para>
|
||||
</section>
|
||||
<section xml:id="basics-argparse" os="debian">
|
||||
<title>Manually install python-argparse</title>
|
||||
<para>The Debian OpenStack packages are maintained on Debian Sid (also known
|
||||
as Debian Unstable) - the current development version. Backported packages
|
||||
run correctly on Debian Wheezy with one caveat:</para>
|
||||
<para>All OpenStack packages are written in Python. Wheezy uses Python 2.6
|
||||
and 2.7, with Python 2.6 as the default interpreter; Sid has only Python
|
||||
2.7. There is one packaging change between these two. In Python 2.6, you
|
||||
installed the <package>python-argparse</package> package separately. In
|
||||
Python 2.7, this package is installed by default. Unfortunately, in Python
|
||||
2.7, this package does not include <code>Provides: python-argparse</code>
|
||||
directive.</para>
|
||||
<para>Because the packages are maintained in Sid where the <code>Provides:
|
||||
python-argparse</code> directive causes an error, and the Debian
|
||||
OpenStack maintainer wants to maintain one version of the OpenStack
|
||||
packages, you must manually install the <package>python-argparse</package>
|
||||
on each OpenStack system that runs Debian Wheezy before you install the
|
||||
other OpenStack packages. Use the following command to install the
|
||||
package:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install python-argparse</userinput></screen>
|
||||
<para>This caveat applies to most OpenStack packages in Wheezy.</para>
|
||||
</section>
|
||||
<section xml:id="basics-queue">
|
||||
<title>Messaging server</title>
|
||||
<para>On the controller node, install the messaging queue server. Typically
|
||||
this is <phrase os="ubuntu;debian;opensuse;sles"
|
||||
><glossterm>RabbitMQ</glossterm></phrase>
|
||||
<phrase os="centos;rhel;fedora">
|
||||
<glossterm>Qpid</glossterm></phrase> but <phrase
|
||||
os="ubuntu;debian;opensuse;sles"><glossterm>Qpid</glossterm></phrase>
|
||||
<phrase os="centos;rhel;fedora"><glossterm>RabbitMQ</glossterm></phrase>
|
||||
and <glossterm>ZeroMQ</glossterm> (0MQ) are also available.</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install rabbitmq-server</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install rabbitmq-server</userinput></screen>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install qpid-cpp-server</userinput></screen>
|
||||
<note os="ubuntu;debian;opensuse;sles">
|
||||
<title>Important security consideration</title>
|
||||
<para>The <package>rabbitmq-server</package> package configures the
|
||||
RabbitMQ service to start automatically and creates a
|
||||
<literal>guest</literal> user with a default <literal>guest</literal>
|
||||
password. The RabbitMQ examples in this guide use the
|
||||
<literal>guest</literal> account, though it is strongly advised to
|
||||
change its default password, especially if you have IPv6 available: by
|
||||
default the RabbitMQ server enables anyone to connect to it by using
|
||||
guest as login and password, and with IPv6, it is reachable from the
|
||||
outside.</para>
|
||||
<para>To change the default guest password of RabbitMQ:</para>
|
||||
<screen><prompt>#</prompt> <userinput>rabbitmqctl change_password guest <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
</note>
|
||||
<para os="fedora;centos;rhel">Disable Qpid authentication by editing
|
||||
<filename>/etc/qpidd.conf</filename> file and changing the
|
||||
<literal>auth</literal> option to <literal>no</literal>.</para>
|
||||
<screen os="fedora;centos;rhel"> <userinput>auth=no</userinput></screen>
|
||||
<note os="fedora;centos;rhel">
|
||||
<para>To simplify configuration, the Qpid examples in this guide do not
|
||||
use authentication. However, we strongly advise enabling authentication
|
||||
for production deployments. For more information on securing Qpid refer
|
||||
to the <link
|
||||
xlink:href="http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-CPP-Book/html/chap-Messaging_User_Guide-Security.html"
|
||||
>Qpid Documentation</link>.</para>
|
||||
<para>After you enable Qpid authentication, you must update the
|
||||
configuration file of each OpenStack service to ensure that the
|
||||
<literal>qpid_username</literal> and <literal>qpid_password</literal>
|
||||
configuration keys refer to a valid Qpid username and password,
|
||||
respectively.</para>
|
||||
</note>
|
||||
<para os="fedora;centos;rhel">Start Qpid and set it to start automatically
|
||||
when the system boots.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>service qpidd start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig qpidd on</userinput></screen>
|
||||
<para os="opensuse;sles">Start the messaging service and set it to start
|
||||
automatically when the system boots:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service rabbitmq-server start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig rabbitmq-server on</userinput></screen>
|
||||
<para>Congratulations, now you are ready to install OpenStack
|
||||
services!</para>
|
||||
</section>
|
||||
<note>
|
||||
<para>You must use an account with administrative privileges to configure
|
||||
each node. Either run the commands as the <literal>root</literal> user
|
||||
or configure the <literal>sudo</literal> utility.</para>
|
||||
</note>
|
||||
<xi:include href="section_basics-prerequisites.xml"/>
|
||||
<xi:include href="section_basics-networking.xml"/>
|
||||
<xi:include href="section_basics-ntp.xml"/>
|
||||
<xi:include href="section_basics-passwords.xml"/>
|
||||
<xi:include href="section_basics-database.xml"/>
|
||||
<xi:include href="section_basics-packages.xml"/>
|
||||
<xi:include href="section_basics-queue.xml"/>
|
||||
</chapter>
|
||||
|
||||
120
doc/install-guide/section_basics-database.xml
Normal file
120
doc/install-guide/section_basics-database.xml
Normal file
@ -0,0 +1,120 @@
|
||||
<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="basics-database">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Database</title>
|
||||
<para os="ubuntu;debian;rhel;fedora;centos">Most OpenStack
|
||||
services require a database to store information. These examples
|
||||
use a MySQL database that runs on the controller node. You must
|
||||
install the MySQL database on the controller node. You must
|
||||
install MySQL client software on any additional nodes that
|
||||
access MySQL.</para>
|
||||
<para os="opensuse;sles">Most OpenStack services require a
|
||||
database to store information. This guide uses a MySQL database
|
||||
on SUSE Linux Enterprise Server and a compatible database on
|
||||
openSUSE running on the controller node. This compatible
|
||||
database for openSUSE is MariaDB. You must install the MariaDB
|
||||
database on the controller node. You must install the MariaDB
|
||||
client software on any nodes that access the MariaDB
|
||||
database.</para>
|
||||
<section xml:id="basics-database-controller">
|
||||
<title>Controller setup</title>
|
||||
<para><phrase os="sles">For SUSE Linux Enterprise Server:
|
||||
</phrase> On the controller node, install the MySQL client and
|
||||
server packages, and the Python library.</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mysql-client mysql python-mysql</userinput></screen>
|
||||
<para os="opensuse">For openSUSE: On the controller node,
|
||||
install the MariaDB client and database server packages,
|
||||
and the MySQL Python library.</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mariadb-client mariadb python-mysql</userinput></screen>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-mysqldb mysql-server</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install mysql mysql-server MySQL-python</userinput></screen>
|
||||
<note os="ubuntu;debian">
|
||||
<para>When you install the server package, you are prompted
|
||||
for the root password for the database. Choose a strong
|
||||
password and remember it.</para>
|
||||
</note>
|
||||
<para>The MySQL configuration requires some changes to work with
|
||||
OpenStack.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para os="ubuntu;debian">Edit the
|
||||
<filename>/etc/mysql/my.cnf</filename> file:</para>
|
||||
<para os="opensuse;sles;rhel;fedora;centos">Edit the
|
||||
<filename>/etc/my.cnf</filename> file:</para>
|
||||
<substeps>
|
||||
<step>
|
||||
<para>Under the <literal>[mysqld]</literal> section, set the
|
||||
<literal>bind-address</literal> key to the management IP
|
||||
address of the controller node to enable access by other
|
||||
nodes via the management network:</para>
|
||||
<programlisting>[mysqld]
|
||||
...
|
||||
bind-address = 192.168.0.10</programlisting>
|
||||
</step>
|
||||
<step>
|
||||
<para>Under the <literal>[mysqld]</literal> section, set the
|
||||
following keys to enable InnoDB, UTF-8 character set, and
|
||||
UTF-8 collation by default:</para>
|
||||
<programlisting>[mysqld]
|
||||
...
|
||||
default-storage-engine = innodb
|
||||
collation-server = utf8_general_ci
|
||||
init-connect = 'SET NAMES utf8'
|
||||
character-set-server = utf8</programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
</procedure>
|
||||
<para os="ubuntu;debian">Restart the MySQL service to apply
|
||||
the changes:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mysql restart</userinput></screen>
|
||||
<para os="rhel;centos;fedora;opensuse;sles">Start the <phrase
|
||||
os="rhel;fedora;centos">MySQL</phrase>
|
||||
<phrase os="opensuse;sles">MariaDB or MySQL</phrase> database
|
||||
server and set it to start automatically when the system
|
||||
boots.</para>
|
||||
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>service mysqld start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig mysqld on</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service mysql start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig mysql on</userinput></screen>
|
||||
<para os="rhel;centos;fedora;opensuse;sles">Finally, you should
|
||||
set a root password for your <phrase os="rhel;fedora;centos"
|
||||
>MySQL</phrase>
|
||||
<phrase os="opensuse;sles">MariaDB or MySQL</phrase> database.
|
||||
The OpenStack programs that set up databases and tables prompt
|
||||
you for this password if it is set.</para>
|
||||
<para os="ubuntu;debian;rhel;centos;fedora;opensuse;sles">You must
|
||||
delete the anonymous users that are created when the database is
|
||||
first started. Otherwise, database connection problems occur
|
||||
when you follow the instructions in this guide. To do this, use
|
||||
the <command>mysql_secure_installation</command> command.
|
||||
Note that if <command>mysql_secure_installation</command> fails
|
||||
you might need to use <command>mysql_install_db</command> first:</para>
|
||||
<screen os="ubuntu;debian;rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>mysql_install_db</userinput>
|
||||
<prompt>#</prompt> <userinput>mysql_secure_installation</userinput></screen>
|
||||
<para><phrase os="rhel;centos;fedora;opensuse;sles">If you have
|
||||
not already set a root database password, press
|
||||
<keycap>ENTER</keycap> when you are prompted for the
|
||||
password.</phrase> This command presents a number of options
|
||||
for you to secure your database installation. Respond
|
||||
<userinput>yes</userinput> to all prompts unless you have a
|
||||
good reason to do otherwise.</para>
|
||||
</section>
|
||||
<section xml:id="basics-database-node">
|
||||
<title>Node setup</title>
|
||||
<para>On all nodes other than the controller node, install the
|
||||
<phrase os="ubuntu;debian;rhel;fedora;centos"
|
||||
>MySQL</phrase>
|
||||
<phrase os="opensuse">MariaDB (on openSUSE)</phrase> client
|
||||
and the MySQL Python library on any system that does not
|
||||
host a MySQL database:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-mysqldb</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install mysql MySQL-python</userinput></screen>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mariadb-client python-mysql</userinput></screen>
|
||||
<para os="sles">For SUSE Linux Enterprise, install
|
||||
MySQL:</para>
|
||||
<screen os="sles"><prompt>#</prompt> <userinput>zypper install mysql-client python-mysql</userinput></screen>
|
||||
</section>
|
||||
</section>
|
||||
325
doc/install-guide/section_basics-networking-neutron.xml
Normal file
325
doc/install-guide/section_basics-networking-neutron.xml
Normal file
@ -0,0 +1,325 @@
|
||||
<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="basics-networking-neutron">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>OpenStack Networking</title>
|
||||
<para>The example architecture with OpenStack Networking (neutron) requires
|
||||
one controller node, one network node, and at least one compute node.
|
||||
The controller node contains one network interface on the
|
||||
<glossterm>management network</glossterm>. The network node contains
|
||||
one network interface on the management network, one on the
|
||||
<glossterm>instance tunnels network</glossterm>, and one on the
|
||||
<glossterm>external network</glossterm>. The compute node contains
|
||||
one network interface on the management network and one on the
|
||||
instance tunnels network.</para>
|
||||
<figure>
|
||||
<title>Three-node architecture with OpenStack Networking</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="6in"
|
||||
fileref="figures/installguide_arch-neutron.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Unless you intend to use the exact configuration provided in this
|
||||
example architecture, you must modify the networks in this procedure to
|
||||
match your environment. Also, each node must resolve the other nodes
|
||||
by name in addition to IP address. For example, the
|
||||
<replaceable>controller</replaceable> name must resolve to
|
||||
<literal>10.0.0.11</literal>, the IP address of the management
|
||||
interface on the controller node.</para>
|
||||
<warning>
|
||||
<para>Reconfiguring network interfaces will interrupt network
|
||||
connectivity. We recommend using a local terminal session for these
|
||||
procedures.</para>
|
||||
</warning>
|
||||
<section xml:id="basics-neutron-networking-controller-node">
|
||||
<title>Controller node</title>
|
||||
<procedure>
|
||||
<title>To configure networking:</title>
|
||||
<step>
|
||||
<para>Configure the management interface:</para>
|
||||
<para>IP address: 10.0.0.11</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<para>Default gateway: 10.0.0.1</para>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To configure name resolution:</title>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/hosts</filename> file to contain the
|
||||
following:</para>
|
||||
<programlisting># controller
|
||||
10.0.0.11 controller
|
||||
|
||||
# network
|
||||
10.0.0.21 network
|
||||
|
||||
# compute1
|
||||
10.0.0.31 compute1</programlisting>
|
||||
<warning os="ubuntu;debian">
|
||||
<para>You must remove or comment the line beginning with
|
||||
<literal>127.0.1.1</literal>.</para>
|
||||
</warning>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
<section xml:id="basics-neutron-networking-network-node">
|
||||
<title>Network node</title>
|
||||
<procedure>
|
||||
<title>To configure networking:</title>
|
||||
<step>
|
||||
<para>Configure the management interface:</para>
|
||||
<para>IP address: 10.0.0.21</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<para>Default gateway: 10.0.0.1</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Configure the instance tunnels interface:</para>
|
||||
<para>IP address: 10.0.1.21</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>The external interface uses a special configuration without an
|
||||
IP address assigned to it. Configure the external interface:</para>
|
||||
<substeps>
|
||||
<step os="ubuntu;debian">
|
||||
<para>Edit the <filename>/etc/network/interfaces</filename> file
|
||||
to contain the following:</para>
|
||||
<programlisting># The external network interface
|
||||
auto eth2
|
||||
iface eth2 inet manual
|
||||
up ip link set dev $IFACE up
|
||||
down ip link set dev $IFACE down</programlisting>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora">
|
||||
<para>Edit the
|
||||
<filename>/etc/sysconfig/network-scripts/ifcfg-eth2</filename>
|
||||
file to contain the following:</para>
|
||||
<para>Do not change the <literal>HWADDR</literal> and
|
||||
<literal>UUID</literal> keys.</para>
|
||||
<programlisting>DEVICE=eth2
|
||||
TYPE=Ethernet
|
||||
ONBOOT="yes"
|
||||
BOOTPROTO="none"</programlisting>
|
||||
</step>
|
||||
<step os="sles;opensuse">
|
||||
<para>Edit the
|
||||
<filename>/etc/sysconfig/network/ifcfg-eth2</filename> file to
|
||||
contain the following:</para>
|
||||
<programlisting>STARTMODE='auto'
|
||||
BOOTPROTO='static'</programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step>
|
||||
<para>Restart networking:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service networking stop && service networking start</userinput></screen>
|
||||
<screen os="rhel;centos;fedora;sles;opensuse"><prompt>#</prompt> <userinput>service network restart</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To configure name resolution:</title>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/hosts</filename> file to contain the
|
||||
following:</para>
|
||||
<programlisting># network
|
||||
10.0.0.21 network
|
||||
|
||||
# controller
|
||||
10.0.0.11 controller
|
||||
|
||||
# compute1
|
||||
10.0.0.31 compute1</programlisting>
|
||||
<warning os="ubuntu;debian">
|
||||
<para>You must remove or comment the line beginning with
|
||||
<literal>127.0.1.1</literal>.</para>
|
||||
</warning>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
<section xml:id="basics-neutron-networking-compute-node">
|
||||
<title>Compute node</title>
|
||||
<procedure>
|
||||
<title>To configure networking:</title>
|
||||
<step>
|
||||
<para>Configure the management interface:</para>
|
||||
<para>IP address: 10.0.0.31</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<para>Default gateway: 10.0.0.1</para>
|
||||
<note>
|
||||
<para>Additional compute nodes should use 10.0.0.32, 10.0.0.33,
|
||||
and so on.</para>
|
||||
</note>
|
||||
</step>
|
||||
<step>
|
||||
<para>Configure the instance tunnels interface:</para>
|
||||
<para>IP address: 10.0.1.31</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<note>
|
||||
<para>Additional compute nodes should use 10.0.1.32, 10.0.1.33,
|
||||
and so on.</para>
|
||||
</note>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To configure name resolution:</title>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/hosts</filename> file to contain the
|
||||
following:</para>
|
||||
<programlisting># compute1
|
||||
10.0.0.31 compute1
|
||||
|
||||
# controller
|
||||
10.0.0.11 controller
|
||||
|
||||
# network
|
||||
10.0.0.21 network</programlisting>
|
||||
<warning os="ubuntu;debian">
|
||||
<para>You must remove or comment the line beginning with
|
||||
<literal>127.0.1.1</literal>.</para>
|
||||
</warning>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
<section xml:id="basics-neutron-networking-verify">
|
||||
<title>Verify connectivity</title>
|
||||
<para>We recommend that you verify network connectivity to the internet
|
||||
and among the nodes before proceeding further.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>From the <emphasis>controller</emphasis> node,
|
||||
<command>ping</command> a site on the internet:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 openstack.org</userinput>
|
||||
<computeroutput>PING openstack.org (174.143.194.225) 56(84) bytes of data.
|
||||
64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
|
||||
|
||||
--- openstack.org ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3022ms
|
||||
rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>controller</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>network</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>network</replaceable></userinput>
|
||||
<computeroutput>PING network (10.0.0.21) 56(84) bytes of data.
|
||||
64 bytes from network (10.0.0.21): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from network (10.0.0.21): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from network (10.0.0.21): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from network (10.0.0.21): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- network ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>controller</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>compute</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>compute1</replaceable></userinput>
|
||||
<computeroutput>PING compute1 (10.0.0.31) 56(84) bytes of data.
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- network ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>network</emphasis> node,
|
||||
<command>ping</command> a site on the internet:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 openstack.org</userinput>
|
||||
<computeroutput>PING openstack.org (174.143.194.225) 56(84) bytes of data.
|
||||
64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
|
||||
|
||||
--- openstack.org ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3022ms
|
||||
rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>network</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>controller</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>controller</replaceable></userinput>
|
||||
<computeroutput>PING controller (10.0.0.11) 56(84) bytes of data.
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- controller ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>network</emphasis> node,
|
||||
<command>ping</command> the instance tunnels interface on the
|
||||
<emphasis>compute</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 10.0.1.31</userinput>
|
||||
<computeroutput>PING 10.0.1.31 (10.0.1.31) 56(84) bytes of data.
|
||||
64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- 10.0.1.31 ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>compute</emphasis> node,
|
||||
<command>ping</command> a site on the internet:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 openstack.org</userinput>
|
||||
<computeroutput>PING openstack.org (174.143.194.225) 56(84) bytes of data.
|
||||
64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
|
||||
|
||||
--- openstack.org ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3022ms
|
||||
rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>compute</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>controller</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>controller</replaceable></userinput>
|
||||
<computeroutput>PING controller (10.0.0.11) 56(84) bytes of data.
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- controller ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>compute</emphasis> node,
|
||||
<command>ping</command> the instance tunnels interface on the
|
||||
<emphasis>network</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 10.0.1.21</userinput>
|
||||
<computeroutput>PING 10.0.1.21 (10.0.1.21) 56(84) bytes of data.
|
||||
64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- 10.0.1.21 ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
</section>
|
||||
197
doc/install-guide/section_basics-networking-nova.xml
Normal file
197
doc/install-guide/section_basics-networking-nova.xml
Normal file
@ -0,0 +1,197 @@
|
||||
<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="basics-networking-nova">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Legacy networking</title>
|
||||
<para>The example architecture with legacy networking (nova) requires one
|
||||
controller node and at least one compute node. The controller node
|
||||
contains one network interface on the
|
||||
<glossterm>management network</glossterm>. The compute node contains
|
||||
one network interface on the management network and one on the
|
||||
<glossterm>external network</glossterm>.</para>
|
||||
<figure>
|
||||
<title>Two-node architecture with legacy networking</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="6in"
|
||||
fileref="figures/installguide_arch-nova.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Unless you intend to use the exact configuration provided in this
|
||||
example architecture, you must modify the networks in this procedure to
|
||||
match your environment. Also, each node must resolve the other nodes
|
||||
by name in addition to IP address. For example, the
|
||||
<replaceable>controller</replaceable> name must resolve to
|
||||
<literal>10.0.0.11</literal>, the IP address of the management
|
||||
interface on the controller node.</para>
|
||||
<warning>
|
||||
<para>Reconfiguring network interfaces will interrupt network
|
||||
connectivity. We recommend using a local terminal session for these
|
||||
procedures.</para>
|
||||
</warning>
|
||||
<section xml:id="basics-networking-nova-controller-node">
|
||||
<title>Controller node</title>
|
||||
<procedure>
|
||||
<title>To configure networking:</title>
|
||||
<step>
|
||||
<para>Configure the management interface:</para>
|
||||
<para>IP address: 10.0.0.11</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<para>Default gateway: 10.0.0.1</para>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To configure name resolution:</title>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/hosts</filename> file to contain the
|
||||
following:</para>
|
||||
<programlisting># controller
|
||||
10.0.0.11 controller
|
||||
|
||||
# compute1
|
||||
10.0.0.31 compute1</programlisting>
|
||||
<warning os="ubuntu;debian">
|
||||
<para>You must remove or comment the line beginning with
|
||||
<literal>127.0.1.1</literal>.</para>
|
||||
</warning>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
<section xml:id="basics-networking-node-compute-node">
|
||||
<title>Compute node</title>
|
||||
<procedure>
|
||||
<title>To configure networking:</title>
|
||||
<step>
|
||||
<para>Configure the management interface:</para>
|
||||
<para>IP address: 10.0.0.31</para>
|
||||
<para>Network mask: 255.255.255.0 (or /24)</para>
|
||||
<para>Default gateway: 10.0.0.1</para>
|
||||
<note>
|
||||
<para>Additional compute nodes should use 10.0.0.32, 10.0.0.33,
|
||||
and so on.</para>
|
||||
</note>
|
||||
</step>
|
||||
<step>
|
||||
<para>The external interface uses a special configuration without an
|
||||
IP address assigned to it. Configure the external interface:</para>
|
||||
<substeps>
|
||||
<step os="ubuntu;debian">
|
||||
<para>Edit the <filename>/etc/network/interfaces</filename> file
|
||||
to contain the following:</para>
|
||||
<programlisting># The external network interface
|
||||
auto eth1
|
||||
iface eth1 inet manual
|
||||
up ip link set dev $IFACE up
|
||||
down ip link set dev $IFACE down</programlisting>
|
||||
</step>
|
||||
<step os="rhel;centos;fedora">
|
||||
<para>Edit the
|
||||
<filename>/etc/sysconfig/network-scripts/ifcfg-eth1</filename>
|
||||
file to contain the following:</para>
|
||||
<para>Do not change the <literal>HWADDR</literal> and
|
||||
<literal>UUID</literal> keys.</para>
|
||||
<programlisting>DEVICE=eth1
|
||||
TYPE=Ethernet
|
||||
ONBOOT="yes"
|
||||
BOOTPROTO="none"</programlisting>
|
||||
</step>
|
||||
<step os="sles;opensuse">
|
||||
<para>Edit the
|
||||
<filename>/etc/sysconfig/network/ifcfg-eth1</filename> file to
|
||||
contain the following:</para>
|
||||
<programlisting>STARTMODE='auto'
|
||||
BOOTPROTO='static'</programlisting>
|
||||
</step>
|
||||
</substeps>
|
||||
</step>
|
||||
<step>
|
||||
<para>Restart networking:</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service networking stop && service networking start</userinput></screen>
|
||||
<screen os="rhel;centos;fedora;sles;opensuse"><prompt>#</prompt> <userinput>service network restart</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure>
|
||||
<title>To configure name resolution:</title>
|
||||
<step>
|
||||
<para>Edit the <filename>/etc/hosts</filename> file to contain the
|
||||
following:</para>
|
||||
<programlisting># compute1
|
||||
10.0.0.31 compute1
|
||||
|
||||
# controller
|
||||
10.0.0.11 controller</programlisting>
|
||||
<warning os="ubuntu;debian">
|
||||
<para>You must remove or comment the line beginning with
|
||||
<literal>127.0.1.1</literal>.</para>
|
||||
</warning>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
<section xml:id="basics-networking-nova-verify">
|
||||
<title>Verify connectivity</title>
|
||||
<para>We recommend that you verify network connectivity to the internet
|
||||
and among the nodes before proceeding further.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>From the <emphasis>controller</emphasis> node,
|
||||
<command>ping</command> a site on the internet:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 openstack.org</userinput>
|
||||
<computeroutput>PING openstack.org (174.143.194.225) 56(84) bytes of data.
|
||||
64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
|
||||
|
||||
--- openstack.org ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3022ms
|
||||
rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>controller</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>compute</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>compute1</replaceable></userinput>
|
||||
<computeroutput>PING compute1 (10.0.0.31) 56(84) bytes of data.
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from compute1 (10.0.0.31): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- compute1 ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>compute</emphasis> node,
|
||||
<command>ping</command> a site on the internet:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 openstack.org</userinput>
|
||||
<computeroutput>PING openstack.org (174.143.194.225) 56(84) bytes of data.
|
||||
64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
|
||||
64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
|
||||
|
||||
--- openstack.org ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3022ms
|
||||
rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms</computeroutput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>From the <emphasis>compute</emphasis> node,
|
||||
<command>ping</command> the management interface on the
|
||||
<emphasis>controller</emphasis> node:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ping -c 4 <replaceable>controller</replaceable></userinput>
|
||||
<computeroutput>PING controller (10.0.0.11) 56(84) bytes of data.
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=1 ttl=64 time=0.263 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=2 ttl=64 time=0.202 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=3 ttl=64 time=0.203 ms
|
||||
64 bytes from controller (10.0.0.11): icmp_seq=4 ttl=64 time=0.202 ms
|
||||
|
||||
--- controller ping statistics ---
|
||||
4 packets transmitted, 4 received, 0% packet loss, time 3000ms
|
||||
rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms</computeroutput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
</section>
|
||||
</section>
|
||||
80
doc/install-guide/section_basics-networking.xml
Normal file
80
doc/install-guide/section_basics-networking.xml
Normal file
@ -0,0 +1,80 @@
|
||||
<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="basics-networking">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Networking</title>
|
||||
<para>After installing the operating system on each node for the
|
||||
architecture that you choose to deploy, you must configure the network
|
||||
interfaces. We recommend that you disable any automated network
|
||||
management tools and manually edit the appropriate configuration files
|
||||
for your distribution. For more information on how to configure networking
|
||||
on your distribution, see the
|
||||
<link os="ubuntu"
|
||||
xlink:href="https://help.ubuntu.com/lts/serverguide/network-configuration.html"
|
||||
>documentation.</link>
|
||||
<link os="debian"
|
||||
xlink:href="https://wiki.debian.org/NetworkConfiguration"
|
||||
>documentation.</link>
|
||||
<link os="rhel;centos;fedora"
|
||||
xlink:href="https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-networkscripts-interfaces.html"
|
||||
>documentation.</link>
|
||||
<link os="sles"
|
||||
xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_basicnet_manconf.html"
|
||||
>documentation.</link>
|
||||
<link os="opensuse"
|
||||
xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking"
|
||||
>documentation.</link></para>
|
||||
<procedure os="fedora">
|
||||
<title>To disable <systemitem class="service">NetworkManager</systemitem>
|
||||
and enable the <systemitem class="service">network</systemitem>
|
||||
service:</title>
|
||||
<step>
|
||||
<screen><prompt>#</prompt> <userinput>service NetworkManager stop</userinput>
|
||||
<prompt>#</prompt> <userinput>service network start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig NetworkManager off</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig network on</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure os="sles;opensuse">
|
||||
<title>To disable <systemitem class="service">NetworkManager</systemitem>
|
||||
:</title>
|
||||
<step>
|
||||
<para>Use the YaST network module:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>yast2 network</userinput></screen>
|
||||
<para os="sles">For more information, see the
|
||||
<link xlink:href="https://www.suse.com/documentation/sles11/book_sle_admin/data/sec_nm_activate.html">documentation.</link></para>
|
||||
<para os="opensuse">For more information, see the
|
||||
<link xlink:href="http://activedoc.opensuse.org/book/opensuse-reference/chapter-13-basic-networking#sec.basicnet.yast.netcard.global">documentation.
|
||||
</link></para>
|
||||
</step>
|
||||
</procedure>
|
||||
<para os="rhel;centos">RHEL and derivatives including CentOS and Scientific
|
||||
Linux enable a restrictive <glossterm>firewall</glossterm> by default.
|
||||
During this installation, certain steps will fail unless you alter or
|
||||
disable the firewall. For further information about securing your
|
||||
installation, refer to the
|
||||
<link xlink:href="http://docs.openstack.org/sec/">
|
||||
OpenStack Security Guide</link>.</para>
|
||||
<para os="fedora">On Fedora, <literal>firewalld</literal> replaces
|
||||
<literal>iptables</literal> as the default firewall system. While you
|
||||
can use <literal>firewalld</literal> successfully, this guide
|
||||
references <literal>iptables</literal> for compatibility with other
|
||||
distributions.</para>
|
||||
<procedure os="fedora">
|
||||
<title>To disable <literal>firewalld</literal> and enable
|
||||
<literal>iptables</literal>:</title>
|
||||
<step>
|
||||
<screen><prompt>#</prompt> <userinput>service firewalld stop</userinput>
|
||||
<prompt>#</prompt> <userinput>service iptables start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig firewalld off</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig iptables on</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<para>Proceed to network configuration for the example
|
||||
<link linkend="basics-networking-neutron">OpenStack Networking
|
||||
</link> or <link linkend="basics-networking-nova">legacy
|
||||
networking</link> architecture.</para>
|
||||
<xi:include href="section_basics-networking-neutron.xml"/>
|
||||
<xi:include href="section_basics-networking-nova.xml"/>
|
||||
</section>
|
||||
31
doc/install-guide/section_basics-ntp.xml
Normal file
31
doc/install-guide/section_basics-ntp.xml
Normal file
@ -0,0 +1,31 @@
|
||||
<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="basics-ntp">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Network Time Protocol (NTP)</title>
|
||||
<para>To synchronize services across multiple machines, you must
|
||||
install <glossterm baseform="Network Time Protocol (NTP)">NTP</glossterm>.
|
||||
The examples in this guide configure the controller
|
||||
node as the reference server and any additional nodes to set
|
||||
their time from the controller node.</para>
|
||||
<para>Install the <literal>ntp</literal> package on each system
|
||||
running OpenStack services.</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ntp</userinput></screen>
|
||||
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install ntp</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install ntp</userinput></screen>
|
||||
<para os="rhel;fedora;centos;opensuse;sles">Set up the NTP server
|
||||
on your controller node so that it receives data by modifying
|
||||
the <filename>ntp.conf</filename> file and restarting the
|
||||
service.</para>
|
||||
<screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service ntpd start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig ntpd on</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service ntp start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig ntp on</userinput></screen>
|
||||
<para>On additional nodes, it is advised that you configure the
|
||||
other nodes to synchronize their time from the controller node
|
||||
rather than from outside of your LAN. To do so, install the ntp
|
||||
daemon as above, then edit <filename>/etc/ntp.conf</filename>
|
||||
and change the <code>server</code> directive to use the
|
||||
controller node as internet time source.</para>
|
||||
</section>
|
||||
160
doc/install-guide/section_basics-packages.xml
Normal file
160
doc/install-guide/section_basics-packages.xml
Normal file
@ -0,0 +1,160 @@
|
||||
<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="basics-packages">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>OpenStack packages</title>
|
||||
<para>Distributions might release OpenStack packages as part of
|
||||
their distribution or through other methods because the
|
||||
OpenStack and distribution release times are independent of each
|
||||
other.</para>
|
||||
<para>This section describes the configuration you must
|
||||
complete after you configure machines to install the latest
|
||||
OpenStack packages.</para>
|
||||
<para os="fedora;centos;rhel">The examples in this guide use the
|
||||
OpenStack packages from the RDO repository. These packages work
|
||||
on Red Hat Enterprise Linux 6, compatible versions of CentOS,
|
||||
and Fedora 20. To enable the RDO repository, download and
|
||||
install the <package>rdo-release-icehouse</package>
|
||||
package.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://repos.fedorapeople.org/repos/openstack/openstack-icehouse/rdo-release-icehouse-1.noarch.rpm</userinput></screen>
|
||||
<para os="fedora;centos;rhel">The EPEL package includes GPG keys
|
||||
for package signing and repository information. This should only
|
||||
be installed on Red Hat Enterprise Linux and CentOS, not Fedora.
|
||||
Install the latest <package>epel-release</package> package (see
|
||||
<link
|
||||
xlink:href="http://download.fedoraproject.org/pub/epel/6/x86_64/repoview/epel-release.html"
|
||||
>http://download.fedoraproject.org/pub/epel/6/x86_64/repoview/epel-release.html</link>).
|
||||
For example:</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</userinput></screen>
|
||||
<para os="fedora;centos;rhel">The
|
||||
<package>openstack-utils</package> package contains utility
|
||||
programs that make installation and configuration easier. These
|
||||
programs are used throughout this guide. Install
|
||||
<package>openstack-utils</package>. This verifies that you can
|
||||
access the RDO repository.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-utils</userinput></screen>
|
||||
<para os="opensuse;sles">Use the Open Build Service repositories
|
||||
for <glossterm>Icehouse</glossterm> based on your openSUSE or
|
||||
SUSE Linux Enterprise
|
||||
Server version, for example if you run openSUSE 12.3 use:</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/openSUSE_12.3 Icehouse</userinput></screen>
|
||||
<para os="opensuse">For openSUSE 13.1 use:</para>
|
||||
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/openSUSE_13.1 Icehouse</userinput></screen>
|
||||
<para os="sles">If you use SUSE Linux Enterprise Server 11 SP3,
|
||||
use:</para>
|
||||
<screen os="sles"><prompt>#</prompt> <userinput>zypper addrepo -f obs://Cloud:OpenStack:Icehouse/SLE_11_SP3 Icehouse</userinput></screen>
|
||||
<para os="opensuse;sles">The <package>openstack-utils</package>
|
||||
package contains utility programs that make installation and
|
||||
configuration easier. These programs are used throughout this
|
||||
guide. Install <package>openstack-utils</package>. This verifies
|
||||
that you can access the Open Build Service repository:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-utils</userinput></screen>
|
||||
<warning os="fedora;centos;rhel;opensuse;sles">
|
||||
<para>The <application>openstack-config</application> program
|
||||
in the <package>openstack-utils</package> package uses
|
||||
<application>crudini</application> to manipulate configuration
|
||||
files. However, <application>crudini</application> version 0.3
|
||||
does not support multi valued options. See
|
||||
<link
|
||||
xlink:href="https://bugs.launchpad.net/openstack-manuals/+bug/1269271"
|
||||
>https://bugs.launchpad.net/openstack-manuals/+bug/1269271</link>.
|
||||
As a work around, you must manually set any multi valued
|
||||
options or the new value overwrites the previous value instead
|
||||
of creating a new option.</para>
|
||||
</warning>
|
||||
<para os="fedora;centos;rhel">The
|
||||
<package>openstack-selinux</package> package includes the
|
||||
policy files that are required to configure SELinux during
|
||||
OpenStack installation.
|
||||
Install <package>openstack-selinux</package>.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-selinux</userinput></screen>
|
||||
<para os="fedora;centos;rhel;opensuse;sles">Upgrade your system packages:</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum upgrade</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper refresh</userinput>
|
||||
<prompt>#</prompt> <userinput>zypper update</userinput></screen>
|
||||
<para os="fedora;centos;rhel;opensuse;sles">If the upgrade included a new
|
||||
kernel package, reboot the system to ensure the new kernel is running:</para>
|
||||
<screen os="fedora;centos;rhel;opensuse;sles"><prompt>#</prompt> <userinput>reboot</userinput></screen>
|
||||
<procedure xml:id="ubuntu-cloud-archive" os="ubuntu">
|
||||
<title>To use the Ubuntu Cloud Archive for Icehouse</title>
|
||||
<para>The <link
|
||||
xlink:href="https://wiki.ubuntu.com/ServerTeam/CloudArchive"
|
||||
>Ubuntu Cloud Archive</link> is a special repository that
|
||||
allows you to install newer releases of OpenStack on the
|
||||
stable supported version of Ubuntu.</para>
|
||||
<step>
|
||||
<para>Install the Ubuntu Cloud Archive for
|
||||
<glossterm>Icehouse</glossterm>:
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install python-software-properties</userinput>
|
||||
<prompt>#</prompt> <userinput>add-apt-repository cloud-archive:icehouse</userinput></screen></para>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the package database, upgrade your system, and reboot
|
||||
for all changes to take effect:
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get dist-upgrade</userinput>
|
||||
<prompt>#</prompt> <userinput>reboot</userinput> </screen></para>
|
||||
</step>
|
||||
</procedure>
|
||||
<procedure xml:id="debian-cloud-archive" os="debian">
|
||||
<title>To use the Debian Wheezy backports archive for
|
||||
Icehouse</title>
|
||||
<para>The <glossterm>Icehouse</glossterm> release is available
|
||||
only in Debian Sid
|
||||
(otherwise called Unstable). However, the Debian maintainers
|
||||
of OpenStack also maintain a non-official Debian repository
|
||||
for OpenStack containing Wheezy backports.</para>
|
||||
<step>
|
||||
<para>Install the Debian Wheezy backport repository
|
||||
Icehouse:</para>
|
||||
<screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian icehouse-backports main" >>/etc/apt/sources.list</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Install the Debian Wheezy OpenStack repository for
|
||||
Icehouse:</para>
|
||||
<screen><prompt>#</prompt> <userinput>echo "deb http://archive.gplhost.com/debian icehouse main" >>/etc/apt/sources.list</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the repository database and install the key:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get install gplhost-archive-keyring</userinput></screen>
|
||||
</step>
|
||||
<step>
|
||||
<para>Update the package database, upgrade your system, and reboot
|
||||
for all changes to take effect:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get update && apt-get dist-upgrade</userinput>
|
||||
<prompt>#</prompt> <userinput>reboot</userinput></screen>
|
||||
</step>
|
||||
</procedure>
|
||||
<para os="debian">Numerous archive.gplhost.com mirrors are
|
||||
available around the world. All are available with both FTP and
|
||||
HTTP protocols (you should use the closest mirror). The list of
|
||||
mirrors is available at <link
|
||||
xlink:href="http://archive.gplhost.com/readme.mirrors"
|
||||
>http://archive.gplhost.com/readme.mirrors</link>.</para>
|
||||
<section xml:id="basics-argparse" os="debian">
|
||||
<title>Manually install python-argparse</title>
|
||||
<para>The Debian OpenStack packages are maintained on Debian Sid
|
||||
(also known as Debian Unstable) - the current development
|
||||
version. Backported packages run correctly on Debian Wheezy with
|
||||
one caveat:</para>
|
||||
<para>All OpenStack packages are written in Python. Wheezy uses
|
||||
Python 2.6 and 2.7, with Python 2.6 as the default interpreter;
|
||||
Sid has only Python 2.7. There is one packaging change between
|
||||
these two. In Python 2.6, you installed the
|
||||
<package>python-argparse</package> package separately. In
|
||||
Python 2.7, this package is installed by default. Unfortunately,
|
||||
in Python 2.7, this package does not include <code>Provides:
|
||||
python-argparse</code> directive.</para>
|
||||
<para>Because the packages are maintained in Sid where the
|
||||
<code>Provides: python-argparse</code> directive causes an
|
||||
error, and the Debian OpenStack maintainer wants to maintain one
|
||||
version of the OpenStack packages, you must manually install the
|
||||
<package>python-argparse</package> on each OpenStack system
|
||||
that runs Debian Wheezy before you install the other OpenStack
|
||||
packages. Use the following command to install the
|
||||
package:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install python-argparse</userinput></screen>
|
||||
<para>This caveat applies to most OpenStack packages in
|
||||
Wheezy.</para>
|
||||
</section>
|
||||
</section>
|
||||
105
doc/install-guide/section_basics-passwords.xml
Normal file
105
doc/install-guide/section_basics-passwords.xml
Normal file
@ -0,0 +1,105 @@
|
||||
<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="basics-passwords">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Passwords</title>
|
||||
<para>The various OpenStack services and the required software like the
|
||||
database and the messaging server have to be password protected. You use
|
||||
these passwords when configuring a service and then again to access the
|
||||
service. You have to choose a password while configuring the
|
||||
service and later remember to use the same password when accessing it.
|
||||
Optionally, you can generate random passwords with the
|
||||
<application>pwgen</application> program. Or, to create passwords one at a
|
||||
time, use the output of this command repeatedly:
|
||||
<screen><prompt>$</prompt> <userinput>openssl rand -hex 10</userinput></screen>
|
||||
</para>
|
||||
<para>This guide uses the convention that
|
||||
<literal><replaceable>SERVICE_PASS</replaceable></literal> is
|
||||
password to access the service <literal>SERVICE</literal> and
|
||||
<literal><replaceable>SERVICE_DBPASS</replaceable></literal> is
|
||||
the database password used by the service SERVICE to access the
|
||||
database.
|
||||
</para>
|
||||
<para>The complete list of passwords you need to define in this guide are:
|
||||
<table rules="all">
|
||||
<caption>Passwords</caption>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Password name</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Database password (no variable used)</td>
|
||||
<td>Root password for the database</td>
|
||||
</tr>
|
||||
<tr os="ubuntu;opensuse;sles">
|
||||
<td><literal><replaceable>RABBIT_PASS</replaceable></literal></td>
|
||||
<td>Password of user guest of RabbitMQ</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>KEYSTONE_DBPASS</replaceable></literal></td>
|
||||
<td>Database password of Identity service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>ADMIN_PASS</replaceable></literal></td>
|
||||
<td>Password of user <literal>admin</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>GLANCE_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for Image Service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>GLANCE_PASS</replaceable></literal></td>
|
||||
<td>Password of Image Service user <literal>glance</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NOVA_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for Compute service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NOVA_PASS</replaceable></literal></td>
|
||||
<td>Password of Compute service user <literal>nova</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>DASH_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the dashboard</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CINDER_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Block Storage service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CINDER_PASS</replaceable></literal></td>
|
||||
<td>Password of Block Storage service user <literal>cinder</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NEUTRON_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Networking service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>NEUTRON_PASS</replaceable></literal></td>
|
||||
<td>Password of Networking service user <literal>neutron</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>HEAT_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Orchestration service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>HEAT_PASS</replaceable></literal></td>
|
||||
<td>Password of Orchestration service user <literal>heat</literal></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CEILOMETER_DBPASS</replaceable></literal></td>
|
||||
<td>Database password for the Telemetry service</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><literal><replaceable>CEILOMETER_PASS</replaceable></literal></td>
|
||||
<td>Password of Telemetry service user <literal>ceilometer</literal></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</para>
|
||||
</section>
|
||||
63
doc/install-guide/section_basics-prerequisites.xml
Normal file
63
doc/install-guide/section_basics-prerequisites.xml
Normal file
@ -0,0 +1,63 @@
|
||||
<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="basics-prerequisites">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Before you begin</title>
|
||||
<para>For a functional environment, OpenStack doesn't require a
|
||||
significant amount of resources. We recommend that your environment meets
|
||||
or exceeds the following minimum requirements which can support several
|
||||
minimal <glossterm>CirrOS</glossterm> instances:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Controller Node: 1 processor, 2 GB memory, and 5 GB
|
||||
storage</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Network Node: 1 processor, 512 MB memory, and 5 GB
|
||||
storage</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Compute Node: 1 processor, 2 GB memory, and 10 GB
|
||||
storage</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>To minimize clutter and provide more resources for OpenStack, we
|
||||
recommend a minimal installation of your Linux distribution. Also, we
|
||||
strongly recommend that you install a 64-bit version of your distribution
|
||||
on at least the compute node. If you install a 32-bit version of your
|
||||
distribution on the compute node, attempting to start an instance using
|
||||
a 64-bit image will fail.</para>
|
||||
<note>
|
||||
<para>A single disk partition on each node works for most basic
|
||||
installations. However, you should consider
|
||||
<glossterm>Logical Volume Manager (LVM)</glossterm> for installations
|
||||
with optional services such as Block Storage.</para>
|
||||
</note>
|
||||
<para>Many users build their test environments on
|
||||
<glossterm baseform="virtual machine (VM)">virtual machines
|
||||
(VMs)</glossterm>. The primary benefits of VMs include the
|
||||
following:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>One physical server can support multiple nodes, each with almost
|
||||
any number of network interfaces.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Ability to take periodic "snap shots" throughout the installation
|
||||
process and "roll back" to a working configuration in the event of
|
||||
a problem.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>However, VMs will reduce performance of your instances, particularly
|
||||
if your hypervisor and/or processor lacks support for hardware
|
||||
acceleration of nested VMs.</para>
|
||||
<note>
|
||||
<para>If you choose to install on VMs, make sure your hypervisor
|
||||
permits <glossterm>promiscuous mode</glossterm> on the
|
||||
<glossterm>external network</glossterm>.</para>
|
||||
</note>
|
||||
<para>For more information about system requirements, see the <link
|
||||
xlink:href="http://docs.openstack.org/ops/">OpenStack Operations
|
||||
Guide</link>.</para>
|
||||
</section>
|
||||
66
doc/install-guide/section_basics-queue.xml
Normal file
66
doc/install-guide/section_basics-queue.xml
Normal file
@ -0,0 +1,66 @@
|
||||
<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="basics-queue">
|
||||
<?dbhtml-stop-chunking?>
|
||||
<title>Messaging server</title>
|
||||
<para>On the controller node, install the messaging queue server.
|
||||
Typically this is <phrase os="ubuntu;debian;opensuse;sles"
|
||||
><glossterm>RabbitMQ</glossterm></phrase>
|
||||
<phrase os="centos;rhel;fedora">
|
||||
<glossterm>Qpid</glossterm></phrase> but
|
||||
<phrase os="ubuntu;debian;opensuse;sles"><glossterm>Qpid</glossterm></phrase>
|
||||
<phrase os="centos;rhel;fedora"><glossterm>RabbitMQ</glossterm></phrase>
|
||||
and <glossterm>ZeroMQ</glossterm> (0MQ) are also available.</para>
|
||||
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install rabbitmq-server</userinput></screen>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install rabbitmq-server</userinput></screen>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install qpid-cpp-server</userinput></screen>
|
||||
<note os="ubuntu;debian;opensuse;sles">
|
||||
<title>Important security consideration</title>
|
||||
<para>The <package>rabbitmq-server</package> package configures
|
||||
the RabbitMQ service to start automatically and creates a
|
||||
<literal>guest</literal> user with a default
|
||||
<literal>guest</literal> password. The RabbitMQ examples in
|
||||
this guide use the <literal>guest</literal> account, though it
|
||||
is strongly advised to change its default password, especially
|
||||
if you have IPv6 available: by default the RabbitMQ server
|
||||
enables anyone to connect to it by using guest as login and
|
||||
password, and with IPv6, it is reachable from the
|
||||
outside.</para>
|
||||
<para>To change the default guest password of RabbitMQ:</para>
|
||||
<screen><prompt>#</prompt> <userinput>rabbitmqctl change_password guest <replaceable>RABBIT_PASS</replaceable></userinput></screen>
|
||||
</note>
|
||||
<para os="fedora;centos;rhel">Disable Qpid authentication by
|
||||
editing <filename>/etc/qpidd.conf</filename> file and changing
|
||||
the <literal>auth</literal> option to
|
||||
<literal>no</literal>.</para>
|
||||
<screen os="fedora;centos;rhel"> <userinput>auth=no</userinput></screen>
|
||||
<note os="fedora;centos;rhel">
|
||||
<para>
|
||||
To simplify configuration, the Qpid examples in this guide do not use
|
||||
authentication. However, we strongly advise enabling authentication
|
||||
for production deployments. For more information on securing Qpid
|
||||
refer to the
|
||||
<link xlink:href=
|
||||
"http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-CPP-Book/html/chap-Messaging_User_Guide-Security.html"
|
||||
>Qpid Documentation</link>.
|
||||
</para>
|
||||
<para>
|
||||
After you enable Qpid authentication, you must update the configuration
|
||||
file of each OpenStack service to ensure that the
|
||||
<literal>qpid_username</literal> and <literal>qpid_password</literal>
|
||||
configuration keys refer to a valid Qpid username and password,
|
||||
respectively.
|
||||
</para>
|
||||
</note>
|
||||
<para os="fedora;centos;rhel">Start Qpid and set it to start
|
||||
automatically when the system boots.</para>
|
||||
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>service qpidd start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig qpidd on</userinput></screen>
|
||||
<para os="opensuse;sles">Start the messaging service and set it to
|
||||
start automatically when the system boots:</para>
|
||||
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>service rabbitmq-server start</userinput>
|
||||
<prompt>#</prompt> <userinput>chkconfig rabbitmq-server on</userinput></screen>
|
||||
<para>Congratulations, now you are ready to install OpenStack
|
||||
services!</para>
|
||||
</section>
|
||||
Loading…
Reference in New Issue
Block a user