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
This commit is contained in:
Russell Bryant
parent
46d6759a0c
commit
ed645bc97f
|
|
@ -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>
|
||||
<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>
|
||||
|
||||
<listitem>
|
||||
<para>GuestFS is used for files injection</para>
|
||||
</listitem>
|
||||
<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>
|
||||
|
||||
<listitem>
|
||||
<para>Files injection works with libvirt</para>
|
||||
</listitem>
|
||||
<varlistentry>
|
||||
<term><link
|
||||
xlink:href="https://fedoraproject.org/wiki/Getting_started_with_OpenStack_Nova">Getting
|
||||
Started with OpenStack Nova</link></term>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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 <CLOUD_CONTROLLER_IP_ADDRESS> --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…
Reference in New Issue