Build Install Guide for openSUSE *and* SUSE Linux Enterprise Server

Just a few changes are needed for SLES.

Only minimal testing done so far.

Change-Id: I8f41b713772ad2f2fb8d7d913755d1e621c02f27
This commit is contained in:
Andreas Jaeger 2013-10-16 11:39:03 +02:00
parent cfdef07334
commit ebe2c14ad1
6 changed files with 54 additions and 27 deletions

View File

@ -9,14 +9,14 @@
> for Red Hat Enterprise Linux, CentOS, and > for Red Hat Enterprise Linux, CentOS, and
Fedora</phrase> Fedora</phrase>
<phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase> <phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase>
<phrase os="opensuse"> for openSUSE</phrase> <phrase os="opensuse"> for openSUSE and SUSE Linux Enterprise Server</phrase>
</title> </title>
<?rax subtitle.font.size="17px" title.font.size="32px"?> <?rax subtitle.font.size="17px" title.font.size="32px"?>
<titleabbrev>OpenStack Installation Guide<phrase <titleabbrev>OpenStack Installation Guide<phrase
os="rhel;centos;fedora"> for Red Hat Enterprise Linux, os="rhel;centos;fedora"> for Red Hat Enterprise Linux,
CentOS, and Fedora</phrase> CentOS, and Fedora</phrase>
<phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase> <phrase os="ubuntu"> for Ubuntu 12.04 (LTS)</phrase>
<phrase os="opensuse"> for openSUSE</phrase> <phrase os="opensuse"> for openSUSE and SUSE Linux Enterprise Server</phrase>
</titleabbrev> </titleabbrev>
<info> <info>
<author> <author>
@ -64,12 +64,22 @@
files are included.</para> files are included.</para>
</abstract> </abstract>
<revhistory> <revhistory>
<revision>
<date>2013-10-16</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Add support for SUSE Linux Enterprise.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision> <revision>
<date>2013-10-08</date> <date>2013-10-08</date>
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para>Complete reorganization for Havana</para> <para>Complete reorganization for Havana.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>
@ -79,7 +89,7 @@
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">
<listitem> <listitem>
<para>Build also for openSUSE</para> <para>Build also for openSUSE.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</revdescription> </revdescription>

View File

@ -249,24 +249,27 @@ hwclock -w</programlisting>
controller node needs to have the MySQL database installed. Any additional controller node needs to have the MySQL database installed. Any additional
nodes that access MySQL need to have the MySQL client software nodes that access MySQL need to have the MySQL client software
installed:</para> installed:</para>
<para os="opensuse">Most OpenStack services require a database to store <para os="opensuse;sles">Most OpenStack services require a database to store
information. In this guide, we use a MySQL compatible database information. In this guide, we use a MySQL on SUSE Linux
running on the controller node. This compatible database is Enterprise Server and compatible database on openSUSE running on
MariaDB. The controller node needs to have the MariaDB database the controller node. This compatible database for openSUSE is MariaDB. The
controller node needs to have the MariaDB database
installed. Any additional nodesf that access the MariaDB installed. Any additional nodesf that access the MariaDB
database need to have the MariaDB client software database need to have the MariaDB client software
installed:</para> installed:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para os="ubuntu;debian;rhel;fedora;centos">On the controller node, <para><phrase os="sles;opensuse">For SUSE Linux Enterprise Server: </phrase>
On the controller node,
install the MySQL client, the MySQL database, install the MySQL client, the MySQL database,
and the MySQL Python library.</para> and the MySQL Python library.</para>
<para os="opensuse">On the controller node, install <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mysql-client mysql python-mysql</userinput></screen>
<para os="opensuse;sles">For openSUSE: On the controller node, install
the MariaDB client, the MariaDB database, and the MySQL Python the MariaDB client, the MariaDB database, and the MySQL Python
library.</para> 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="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> <screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install mysql mysql-server MySQL-python</userinput></screen>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install mariadb-client mariadb python-mysql</userinput></screen>
<note os="ubuntu;debian"><para>When you install the server package, you will <note os="ubuntu;debian"><para>When you install the server package, you will
be asked to enter a root password for the database. Be sure to choose be asked to enter a root password for the database. Be sure to choose
a strong password and remember it - it will be needed later.</para></note> a strong password and remember it - it will be needed later.</para></note>
@ -279,16 +282,19 @@ hwclock -w</programlisting>
</listitem> </listitem>
<listitem><para>On any nodes besides the controller node, just install the <listitem><para>On any nodes besides the controller node, just install the
<phrase os="ubuntu;debian;rhel;fedora;centos">MySQL</phrase> <phrase os="ubuntu;debian;rhel;fedora;centos">MySQL</phrase>
<phrase os="opensuse">MariaDB</phrase> <phrase os="opensuse;sles">MariaDB (on openSUSE)</phrase>
client and the MySQL Python library. This is all you need to do on any client and the MySQL Python library. This is all you need to do on any
system not hosting the MySQL database.</para> system not hosting the MySQL database.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install python-mysqldb</userinput></screen> <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="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></listitem> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mariadb-client python-mysql</userinput></screen>
<para>For SUSE Linux Enterprise, install MySQL:</para>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install mysql-client python-mysql</userinput></screen>
</listitem>
</itemizedlist> </itemizedlist>
<para os="rhel;centos;fedora;opensuse">Start the <para os="rhel;centos;fedora;opensuse;sles">Start the
<phrase os="rhel;fedora;centos">MySQL</phrase> <phrase os="rhel;fedora;centos">MySQL</phrase>
<phrase os="opensuse">MariaDB</phrase> <phrase os="opensuse;sles">MariaDB or MySQL</phrase>
database server and set it to start automatically when database server and set it to start automatically when
the system boots.</para> the system boots.</para>
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service mysqld start</userinput> <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>service mysqld start</userinput>
@ -296,7 +302,7 @@ hwclock -w</programlisting>
<para os="rhel;centos;fedora;opensuse;sles">Finally, you should set a root password for your <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="rhel;fedora;centos">MySQL</phrase>
<phrase os="opensuse">MariaDB</phrase> <phrase os="opensuse;sles">MariaDB or MySQL</phrase>
database. The OpenStack programs that set up databases and tables will database. The OpenStack programs that set up databases and tables will
prompt you for this password if it's set. You also need to delete the prompt you for this password if it's set. You also need to delete the
anonymous users that are created when the database is first started. anonymous users that are created when the database is first started.
@ -304,7 +310,7 @@ hwclock -w</programlisting>
the instructions in this guide. You can do both of these with the the instructions in this guide. You can do both of these with the
<command>mysql_secure_installation</command> command.</para> <command>mysql_secure_installation</command> command.</para>
<para os="ubuntu;debian;opensuse">You need to delete the anonymous users <para os="ubuntu;debian;opensuse;sles">You need to delete the anonymous users
that are created when the database is first started. Otherwise, you that are created when the database is first started. Otherwise, you
will get database connection problems when following the instructions will get database connection problems when following the instructions
in this guide. You can do this with the in this guide. You can do this with the
@ -312,7 +318,7 @@ hwclock -w</programlisting>
<screen><prompt>#</prompt> <userinput>mysql_secure_installation</userinput></screen> <screen><prompt>#</prompt> <userinput>mysql_secure_installation</userinput></screen>
<para><phrase os="rhel;centos;fedora;opensuse">If you have not already <para><phrase os="rhel;centos;fedora;opensuse;sles">If you have not already
set a root database password, press enter when first prompted for the set a root database password, press enter when first prompted for the
password.</phrase> This command will present a number of options for password.</phrase> This command will present a number of options for
you to secure your database installation. Answer yes to all of them you to secure your database installation. Answer yes to all of them
@ -386,10 +392,18 @@ hwclock -w</programlisting>
<screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-utils</userinput></screen> <screen os="fedora;centos;rhel"><prompt>#</prompt> <userinput>yum install openstack-utils</userinput></screen>
<para os="opensuse">Use the Open Build Service repositories for Havana based on your openSUSE version, for example if you run <para os="opensuse;sles">Use the Open Build Service repositories
openSUSE 12.3 use:</para> for Havana based on your openSUSE or SUSE Linux Enterprise Server
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper ar -f obs://Cloud:OpenStack:Havana/openSUSE_12.3 Havana</userinput></screen> version, for example if you run openSUSE 12.3 use:</para>
<para os="opensuse">For openSUSE 13.1, nothing needs to be done since OpenStack Havana packages are part of the distribution itself.</para> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper ar -f obs://Cloud:OpenStack:Havana/openSUSE_12.3 Havana</userinput></screen>
<para os="opensuse;sles">
If you use SUSE Linux Enterprise Server 11 SP3, use:
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper ar -f obs://Cloud:OpenStack:Havana/SLE_11_SP3 Havana</userinput></screen>
</para>
<para os="opensuse;sles">For openSUSE 13.1, nothing needs to be
done since OpenStack Havana packages are part of the distribution
itself.
</para>
<procedure xml:id="ubuntu-cloud-archive" os="ubuntu"> <procedure xml:id="ubuntu-cloud-archive" os="ubuntu">
<title>To use the Ubuntu Cloud Archive for Havana</title> <title>To use the Ubuntu Cloud Archive for Havana</title>

View File

@ -22,7 +22,7 @@
meet different use cases, with many storage choices and meet different use cases, with many storage choices and
underlying software-defined networking scenarios, this guide underlying software-defined networking scenarios, this guide
offers these main examples with the intention of expanding on offers these main examples with the intention of expanding on
each: </para> each:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Example architecture for simplicity: the most basic <para>Example architecture for simplicity: the most basic
@ -44,7 +44,7 @@
Identity with SQL backend, Image with local storage, Identity with SQL backend, Image with local storage,
Dashboard (optional extra). Use as many default options as possible. Dashboard (optional extra). Use as many default options as possible.
</para> </para>
<para os="ubuntu;debian;opensuse">Technical details: Compute with KVM, <para os="ubuntu;debian;opensuse;sles">Technical details: Compute with KVM,
local ephemeral storage, nova-networks in multi-host flatDHCP, local ephemeral storage, nova-networks in multi-host flatDHCP,
MySQL, nova-api, default scheduler, RabbitMQ for messaging, MySQL, nova-api, default scheduler, RabbitMQ for messaging,
Identity with SQL backend, Image with local storage, Dashboard (optional extra). Identity with SQL backend, Image with local storage, Dashboard (optional extra).

View File

@ -59,7 +59,8 @@
<dd><a <dd><a
href="install-guide/target/docbkx/webhelp/local/install-guide/install/zypper/content/index.html" href="install-guide/target/docbkx/webhelp/local/install-guide/install/zypper/content/index.html"
>Installation Guide for >Installation Guide for
openSUSE</a><br/> openSUSE and SUSE
Linux Enterprise Server</a><br/>
Note: build locally with "mvn Note: build locally with "mvn
generate-sources -Doperating.system=zypper -Dprofile.os='opensuse;sles'". generate-sources -Doperating.system=zypper -Dprofile.os='opensuse;sles'".
</dd> </dd>

View File

@ -179,7 +179,8 @@
<dd><a <dd><a
href="http://docs.openstack.org/trunk/install-guide/install/zypper/content/" href="http://docs.openstack.org/trunk/install-guide/install/zypper/content/"
>Installation Guide for >Installation Guide for
openSUSE</a></dd> openSUSE and SUSE Linux
Enterprise Server</a></dd>
</dl> </dl>
<h4 class="special">Configure and run an OpenStack cloud</h4> <h4 class="special">Configure and run an OpenStack cloud</h4>
<dl> <dl>

View File

@ -180,7 +180,8 @@
<dd><a <dd><a
href="http://docs.openstack.org/trunk/install-guide/install/zypper/content/" href="http://docs.openstack.org/trunk/install-guide/install/zypper/content/"
>Installation Guide for >Installation Guide for
openSUSE</a></dd> openSUSE and SUSE Linux
Enterprise Server</a></dd>
</dl> </dl>
<h4 class="special">Configure and run an OpenStack cloud</h4> <h4 class="special">Configure and run an OpenStack cloud</h4>
<dl> <dl>