Browse Source

Provide updated install info for Fedora and EPEL.

This patch removes the old RHEL 6 installation instructions and provides
updated information.  It's essentially just a couple of links over to
the Fedora wiki where the latest information is being maintained.

In passing change a section title from "Installing OpenStack Compute on
..." to "Installing on ...".  It seemed a bit redundant since the
chapter is called "Installing OpenStack Compute".

Change-Id: I7321fe5d9dba5e02a5e12761e4249dfd6dc37430
changes/24/4924/3
Russell Bryant 10 years ago
parent
commit
ed645bc97f
  1. 208
      doc/src/docbkx/openstack-compute-admin/computeinstall.xml

208
doc/src/docbkx/openstack-compute-admin/computeinstall.xml

@ -97,7 +97,7 @@
</section>
<section xml:id="installing-openstack-compute-on-ubuntu">
<title>Installing OpenStack Compute on Ubuntu</title>
<title>Installing on Ubuntu</title>
<para>How you go about installing OpenStack Compute depends on your goals
for the installation. You can use an ISO image, you can use a scripted
@ -180,181 +180,49 @@
</section>
<section xml:id="installing-openstack-compute-on-rhel6">
<title>Installing OpenStack Compute on Red Hat Enterprise Linux 6</title>
<title>Installing on Fedora or Red Hat Enterprise Linux 6</title>
<para>This section documents a multi-node installation using RHEL 6. RPM
repos for the Bexar release, the Cactus release, milestone releases of
Diablo, and also per-commit trunk builds for OpenStack Nova are available
at <link
xlink:href="http://yum.griddynamics.net">http://yum.griddynamics.net</link>.
The final release of Diablo is available at <link
xlink:href="http://yum.griddynamics.net/yum/diablo/">http://yum.griddynamics.net/yum/diablo/</link>,
but is not yet tested completely (as of Oct 4, 2011). Check this page for
updates: <link
xlink:href="http://wiki.openstack.org/NovaInstall/RHEL6Notes">http://wiki.openstack.org/NovaInstall/RHEL6Notes</link>.</para>
<para>The Fedora project provides OpenStack packages in Fedora 16 and
later. Fedora also provides packages for RHEL6 via the EPEL (Extra
Packages for Enterprise Linux) 6 repository. If you would like to install
OpenStack on RHEL6, see this page for more information on enabling the use
of EPEL: <link
xlink:href="http://fedoraproject.org/wiki/EPEL">http://fedoraproject.org/wiki/EPEL</link>.</para>
<para>Known considerations for RHEL version 6 installations:</para>
<para>Detailed instructions for installing OpenStack Compute on Fedora or
RHEL6 can be found on the Fedora wiki. See these pages for more
information:</para>
<itemizedlist>
<listitem>
<para>iSCSI LUN not supported due to tgtadm versus ietadm
differences</para>
</listitem>
<listitem>
<para>GuestFS is used for files injection</para>
</listitem>
<listitem>
<para>Files injection works with libvirt</para>
</listitem>
<listitem>
<para>Static network configuration can detect OS type for RHEL and
Ubuntu</para>
</listitem>
<listitem>
<para>Only KVM hypervisor has been tested with this
installation</para>
</listitem>
</itemizedlist>
<para>To install Nova on RHEL v.6 you need access to two repositories, one
available on the yum.griddynamics.net website and the RHEL DVD image
connected as repo.</para>
<para>First, install RHEL 6.0, preferrably with a minimal set of
packages.</para>
<para>Disable SELinux in /etc/sysconfig/selinux and then reboot.</para>
<para>Connect the RHEL 3. 6.0 x86_64 DVD as a repository in YUM.</para>
<variablelist>
<varlistentry>
<term><link
xlink:href="https://fedoraproject.org/wiki/Getting_started_with_OpenStack_on_Fedora_17">Getting
Started with OpenStack on Fedora 17</link></term>
<literallayout class="monospaced">
sudo mount /dev/cdrom /mnt/cdrom
/etc/yum.repos.d/rhel.repo
</literallayout>
<programlisting>
[rhel]
name=RHEL 6.0
baseurl=file:///mnt/cdrom/Server
enabled=1
gpgcheck=0
</programlisting>
<listitem>
<para>The Essex release is in Fedora 17. This page discusses the
installation of Essex on Fedora 17. Once EPEL 6 has been updated to
include Essex, these instructions should be used if installing on
RHEL 6. The main difference between the Fedora 17 instructions and
what must be done on RHEL 6 is that RHEL 6 does not use systemd, so
the <command>systemctl</command> commands will have to substituted
with the RHEL 6 equivalent.</para>
</listitem>
</varlistentry>
<para>Download and install repo config and key. The cloud controller plus
compute node is installed with the example rpm below. You can use <link
xlink:href="http://yum.griddynamics.net/yum/diablo/openstack-nova-node-compute-2011.3-b609.noarch.rpm">http://yum.griddynamics.net/yum/diablo/openstack-nova-node-compute-2011.3-b609.noarch.rpm</link>
for a compute node only.</para>
<varlistentry>
<term><link
xlink:href="https://fedoraproject.org/wiki/Getting_started_with_OpenStack_Nova">Getting
Started with OpenStack Nova</link></term>
<literallayout class="monospaced">
wget http://yum.griddynamics.net/yum/diablo/openstack-nova-node-full-2011.3-b609.noarch.rpm
sudo rpm -i openstack-repo-2011.1-3.noarch.rpm
</literallayout>
<para>Install the libvirt package (these instructions are tested only on
KVM).</para>
<literallayout class="monospaced">
sudo yum install libvirt
sudo chkconfig libvirtd on
sudo service libvirtd start
</literallayout>
<para>Repeat the basic installation steps to put the pre-requisites on all
cloud controller and compute nodes. Nova has many different possible
configurations. You can install Nova services on separate servers as
needed but these are the basic pre-reqs.</para>
<para>These are the basic packages to install for a cloud controller
node:</para>
<literallayout class="monospaced">sudo yum install euca2ools openstack-nova-node-full</literallayout>
<para>These are the basic packages to install compute nodes. Repeat for
each compute node (the node that runs the VMs) that you want to
install.</para>
<literallayout class="monospaced">sudo yum install openstack-nova-compute </literallayout>
<para>On the cloud controller node, create a MySQL database named
nova.</para>
<literallayout class="monospaced">
sudo service mysqld start
sudo chkconfig mysqld on
sudo service rabbitmq-server start
sudo chkconfig rabbitmq-server on
mysqladmin -u root password nova
</literallayout>
<para>You can use this script to create the database.</para>
<programlisting>
#!/bin/bash
DB_NAME=nova
DB_USER=nova
DB_PASS=nova
PWD=nova
CC_HOST="A.B.C.D" # IPv4 address
HOSTS='node1 node2 node3' # compute nodes list
mysqladmin -uroot -p$PWD -f drop nova
mysqladmin -uroot -p$PWD create nova
for h in $HOSTS localhost; do
echo "GRANT ALL PRIVILEGES ON $DB_NAME.* TO '$DB_USER'@'$h' IDENTIFIED BY '$DB_PASS';" | mysql -u root -p$DB_PASS mysql
done
echo "GRANT ALL PRIVILEGES ON $DB_NAME.* TO $DB_USER IDENTIFIED BY '$DB_PASS';" | mysql -u root -p$DB_PASS mysql
echo "GRANT ALL PRIVILEGES ON $DB_NAME.* TO root IDENTIFIED BY '$DB_PASS';" | mysql -u root -p$DB_PASS mysql
</programlisting>
<para>Now, ensure the database version matches the version of nova that
you are installing:</para>
<literallayout class="monospaced">nova-manage db sync</literallayout>
<para>For iptables configuration, update your firewall configuration to
allow incoming requests on ports 5672 (RabbitMQ), 3306 (MySQL DB), 9292
(Glance), 6080 (noVNC web console), API (8773, 8774) and DHCP traffic from
instances. For non-production environments the easiest way to fix any
firewall problems is removing final REJECT in INPUT chain of filter
table.</para>
<literallayout class="monospaced">
sudo iptables -I INPUT 1 -p tcp --dport 5672 -j ACCEPT
sudo iptables -I INPUT 1 -p tcp --dport 3306 -j ACCEPT
sudo iptables -I INPUT 1 -p tcp --dport 9292 -j ACCEPT
sudo iptables -I INPUT 1 -p tcp --dport 6080 -j ACCEPT
sudo iptables -I INPUT 1 -p tcp --dport 8773 -j ACCEPT
sudo iptables -I INPUT 1 -p tcp --dport 8774 -j ACCEPT
sudo iptables -I INPUT 1 -p udp --dport 67 -j ACCEPT
</literallayout>
<para>On every node when you have nova-compute running ensure that
unencrypted VNC access is allowed only from Cloud Controller node:</para>
<literallayout class="monospaced">sudo iptables -I INPUT 1 -p tcp -s &lt;CLOUD_CONTROLLER_IP_ADDRESS&gt; --dport 5900:6400 -j ACCEPT
</literallayout>
<para>On each node, set up the configuration file in
/etc/nova/nova.conf.</para>
<para>Start the Nova services after configuring and you then are running
an OpenStack cloud!</para>
<literallayout class="monospaced">
for n in api compute network objectstore scheduler vncproxy; do
sudo service openstack-nova-$n start; done
sudo service openstack-glance-api start
sudo service openstack-glance-registry start
for n in node1 node2 node3; do
ssh $n sudo service openstack-nova-compute start; done
</literallayout>
<listitem>
<para>This page was originally written as instructions for getting
started with OpenStack on Fedora 16, which includes the Diablo
release. At the time of writing, While EPEL 6 still includes Diablo,
these instructions should be used if installing on RHEL 6.</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<section xml:id="configuring-openstack-compute-basics">

Loading…
Cancel
Save