From ebe2c14ad190005126a5387a18165e0ac399d475 Mon Sep 17 00:00:00 2001 From: Andreas Jaeger Date: Wed, 16 Oct 2013 11:39:03 +0200 Subject: [PATCH] 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 --- .../bk_openstackinstallguide.xml | 18 +++++-- doc/install-guide/ch_basics.xml | 50 ++++++++++++------- doc/install-guide/ch_overview.xml | 4 +- doc/local-files.html | 3 +- www/havana/index.html | 3 +- www/trunk/index.html | 3 +- 6 files changed, 54 insertions(+), 27 deletions(-) diff --git a/doc/install-guide/bk_openstackinstallguide.xml b/doc/install-guide/bk_openstackinstallguide.xml index 4d5ef3e6d1..14015e3d2f 100644 --- a/doc/install-guide/bk_openstackinstallguide.xml +++ b/doc/install-guide/bk_openstackinstallguide.xml @@ -9,14 +9,14 @@ > for Red Hat Enterprise Linux, CentOS, and Fedora for Ubuntu 12.04 (LTS) - for openSUSE + for openSUSE and SUSE Linux Enterprise Server OpenStack Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora for Ubuntu 12.04 (LTS) - for openSUSE + for openSUSE and SUSE Linux Enterprise Server @@ -64,12 +64,22 @@ files are included. + + 2013-10-16 + + + + Add support for SUSE Linux Enterprise. + + + + 2013-10-08 - Complete reorganization for Havana + Complete reorganization for Havana. @@ -79,7 +89,7 @@ - Build also for openSUSE + Build also for openSUSE. diff --git a/doc/install-guide/ch_basics.xml b/doc/install-guide/ch_basics.xml index d9206f9876..c6286e798b 100644 --- a/doc/install-guide/ch_basics.xml +++ b/doc/install-guide/ch_basics.xml @@ -249,24 +249,27 @@ hwclock -w controller node needs to have the MySQL database installed. Any additional nodes that access MySQL need to have the MySQL client software installed: - 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 + 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: - On the controller node, + For SUSE Linux Enterprise Server: + On the controller node, install the MySQL client, the MySQL database, and the MySQL Python library. - On the controller node, install + # zypper install mysql-client mysql python-mysql + For openSUSE: On the controller node, install the MariaDB client, the MariaDB database, and the MySQL Python library. + # zypper install mariadb-client mariadb python-mysql # apt-get install python-mysqldb mysql-server # yum install mysql mysql-server MySQL-python - # zypper install mariadb-client mariadb python-mysql 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. @@ -279,16 +282,19 @@ hwclock -w On any nodes besides the controller node, just install the MySQL - MariaDB + MariaDB (on openSUSE) client and the MySQL Python library. This is all you need to do on any system not hosting the MySQL database. # apt-get install python-mysqldb # yum install mysql MySQL-python - # zypper install mariadb-client python-mysql + # zypper install mariadb-client python-mysql + For SUSE Linux Enterprise, install MySQL: + # zypper install mysql-client python-mysql + - Start the + Start the MySQL - MariaDB + MariaDB or MySQL database server and set it to start automatically when the system boots. # service mysqld start @@ -296,7 +302,7 @@ hwclock -w Finally, you should set a root password for your MySQL - MariaDB + MariaDB or MySQL 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 the instructions in this guide. You can do both of these with the mysql_secure_installation command. - You need to delete the anonymous users + 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 # mysql_secure_installation - If you have not already + If you have not already set a root database password, press enter when first prompted for the password. 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 # yum install openstack-utils - Use the Open Build Service repositories for Havana based on your openSUSE version, for example if you run - openSUSE 12.3 use: - # zypper ar -f obs://Cloud:OpenStack:Havana/openSUSE_12.3 Havana - For openSUSE 13.1, nothing needs to be done since OpenStack Havana packages are part of the distribution itself. + 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: + # zypper ar -f obs://Cloud:OpenStack:Havana/openSUSE_12.3 Havana + + If you use SUSE Linux Enterprise Server 11 SP3, use: + # zypper ar -f obs://Cloud:OpenStack:Havana/SLE_11_SP3 Havana + + For openSUSE 13.1, nothing needs to be + done since OpenStack Havana packages are part of the distribution + itself. + To use the Ubuntu Cloud Archive for Havana diff --git a/doc/install-guide/ch_overview.xml b/doc/install-guide/ch_overview.xml index ee783a0cdf..c8ab81bab2 100644 --- a/doc/install-guide/ch_overview.xml +++ b/doc/install-guide/ch_overview.xml @@ -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: + each: 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. - Technical details: Compute with KVM, + 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). diff --git a/doc/local-files.html b/doc/local-files.html index 44decb3ab1..b2fe5558c7 100644 --- a/doc/local-files.html +++ b/doc/local-files.html @@ -59,7 +59,8 @@
Installation Guide for - openSUSE
+ openSUSE and SUSE + Linux Enterprise Server
Note: build locally with "mvn generate-sources -Doperating.system=zypper -Dprofile.os='opensuse;sles'".
diff --git a/www/havana/index.html b/www/havana/index.html index 88e769653a..f54a27f39c 100644 --- a/www/havana/index.html +++ b/www/havana/index.html @@ -179,7 +179,8 @@
Installation Guide for - openSUSE
+ openSUSE and SUSE Linux + Enterprise Server

Configure and run an OpenStack cloud

diff --git a/www/trunk/index.html b/www/trunk/index.html index 63051650a1..3507d1c7e4 100644 --- a/www/trunk/index.html +++ b/www/trunk/index.html @@ -180,7 +180,8 @@
Installation Guide for - openSUSE
+ openSUSE and SUSE Linux + Enterprise Server

Configure and run an OpenStack cloud