openstack/openstack-manuals
Code Issues Proposed changes

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

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/install-guide/bk_openstackinstallguide.xml
View File

@ -9,14 +9,14 @@
> for Red Hat Enterprise Linux, CentOS, and
Fedora</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>
<?rax subtitle.font.size="17px" title.font.size="32px"?>
<titleabbrev>OpenStack Installation Guide<phrase
os="rhel;centos;fedora"> for Red Hat Enterprise Linux,
CentOS, and Fedora</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>
<info>
<author>
@ -64,12 +64,22 @@
files are included.</para>
</abstract>
<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>
<date>2013-10-08</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Complete reorganization for Havana</para>
<para>Complete reorganization for Havana.</para>
</listitem>
</itemizedlist>
</revdescription>
@ -79,7 +89,7 @@
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Build also for openSUSE</para>
<para>Build also for openSUSE.</para>
</listitem>
</itemizedlist>
</revdescription>

50
doc/install-guide/ch_basics.xml
View File

@ -249,24 +249,27 @@ hwclock -w</programlisting>
controller node needs to have the MySQL database installed. Any additional
nodes that access MySQL need to have the MySQL client software
installed:</para>
<para os="opensuse">Most OpenStack services require a database to store
information. In this guide, we use a MySQL compatible database
running on the controller node. This compatible database is
MariaDB. The controller node needs to have the MariaDB database
<para os="opensuse;sles">Most OpenStack services require a database to store
information. In this guide, we use a MySQL on SUSE Linux
Enterprise Server and compatible database on openSUSE running on
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
database need to have the MariaDB client software
installed:</para>
<itemizedlist>
<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,
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
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>
<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
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>
@ -279,16 +282,19 @@ hwclock -w</programlisting>
</listitem>
<listitem><para>On any nodes besides the controller node, just install the
<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
system not hosting the 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></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>
<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="opensuse">MariaDB</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;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
<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
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.
@ -304,7 +310,7 @@ hwclock -w</programlisting>
the instructions in this guide. You can do both of these with the
<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
will get database connection problems when following the instructions
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>
<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
password.</phrase> This command will present a number of options for
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>
<para os="opensuse">Use the Open Build Service repositories for Havana based on your openSUSE version, for example if you run
openSUSE 12.3 use:</para>
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper ar -f obs://Cloud:OpenStack:Havana/openSUSE_12.3 Havana</userinput></screen>
<para os="opensuse">For openSUSE 13.1, nothing needs to be done since OpenStack Havana packages are part of the distribution itself.</para>
<para os="opensuse;sles">Use the Open Build Service repositories
for Havana based on your openSUSE or SUSE Linux Enterprise Server
version, for example if you run openSUSE 12.3 use:</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">
<title>To use the Ubuntu Cloud Archive for Havana</title>

4
doc/install-guide/ch_overview.xml
View File

@ -22,7 +22,7 @@
meet different use cases, with many storage choices and
underlying software-defined networking scenarios, this guide
offers these main examples with the intention of expanding on
each: </para>
each:</para>
<itemizedlist>
<listitem>
<para>Example architecture for simplicity: the most basic
@ -44,7 +44,7 @@
Identity with SQL backend, Image with local storage,
Dashboard (optional extra). Use as many default options as possible.
</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,
MySQL, nova-api, default scheduler, RabbitMQ for messaging,
Identity with SQL backend, Image with local storage, Dashboard (optional extra).

3
doc/local-files.html
View File

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

3
www/havana/index.html
View File

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

3
www/trunk/index.html
View File

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