stackforge-attic/murano-docs
Code Issues Proposed changes

Edit Automatic way in Install Murano Components

Browse Source 
Change-Id: I5f308796224ecd10f740024d16c6f990020de9b4
This commit is contained in:
bigden 2013-09-27 20:11:56 +04:00
parent 2e341e9e07
commit 4e28ed98ef
1 changed files with 89 additions and 185 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

212
src/administrators-guide/src/docbkx/content/installation-guide.xml
View File

@ -23,209 +23,113 @@
http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd" http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd"
version="5.0"> version="5.0">
<title>Install Murano Components</title> <title>Install Murano Components</title>
<para>This chapter describes how to install Murano components on a <para>This chapter describes how to install Murano components on a separate devbox.
separate devbox. We We strongly recommend to use a separate host (virtual machine or real host) for Murano
strongly recommend to use a separate host (virtual machine or real
host) for Murano
devbox as it prevents you from various dependency conflicts. devbox as it prevents you from various dependency conflicts.
</para> </para>
<section> <section>
<title>Automatic Installation</title> <title>Automatic Installation</title>
<para>There is a script to automate Murano installation onto <para>There is a script to automate Murano installation onto devbox.
devbox.
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Create a folder to hold cloned <para>Create a folder to hold cloned repositories
repositories <programlisting>
<screen>># mkdir -p /opt/git</screen> ># mkdir -p /opt/git
</programlisting>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Clone murano-deployment <para>Clone murano-deployment repository
repository <programlisting>
<screen>
># cd /opt/git ># cd /opt/git
># git clone git://github.com/stackforge/murano-deployment.git ># git clone git://github.com/stackforge/murano-deployment.git
</screen> </programlisting>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Change directory to <para>Set configuration and install prerequisites
<emphasis role="bold">murano-deployment</emphasis> <programlisting>
and switch to required branch (e.g.<emphasis
role="bold"
>master</emphasis>)
<screen>
># cd /opt/git/murano-deployment
># git checkout -b master origin/master
</screen>
</para>
</listitem>
<listitem>
<para>Install
prerequisites
<screen>
># cd /opt/git/murano-deployment/devbox-scripts ># cd /opt/git/murano-deployment/devbox-scripts
># ./murano-git-install.sh prerequisites ># ./murano-git-install.sh prerequisites
</screen> </programlisting>
</para> </para>
</listitem> <para>Press Enter to edit <filename>/etc/murano-deployment/lab-binding.rc</filename>,
<listitem> then 'i' to enter INSERT mode. After editing press ESC and type :wq to write and exit from VI.
<para>Configure the following parameters in lab binding <programlisting>
configuration file LAB_HOST='lab_IP_or_hostname'
<emphasis role="bold" ADMIN_USER='admin'
>/etc/murano-deployment/lab-binding.rc ADMIN_PASSWORD='admin_pass'
</emphasis> RABBITMQ_LOGIN='muranouser'
RABBITMQ_PASSWORD='murano'
RABBITMQ_VHOST='muranovhost'
#RABBITMQ_HOST=''
BRANCH_NAME='master'
SSL_ENABLED='false'
SSL_CA_FILE=''
SSL_CERT_FILE=''
SSL_KEY_FILE=''
</programlisting>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para><emphasis role="bold">LAB_HOST</emphasis> - IP or hostname of the lab.
<emphasis role="bold">LAB_HOST This address/hostname should point to the host where Keystone is installed.</para>
</emphasis>
- IP or nostname
of the lab. Actually, this address/name
should point to the
host where Keystone is installed.
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">ADMIN_USER</emphasis> - OpenStack admin user.</para>
<emphasis role="bold">ADMIN_USER
</emphasis>
- OpenStack
<emphasis role="bold">admin</emphasis>
user
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">ADMIN_PASSWORD</emphasis> - A password for OpenStack admin user.</para>
<emphasis role="bold">ADMIN_PASSWORD
</emphasis>
- A password for OpenStack
<emphasis role="bold"
>admin
</emphasis>
user
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">RABBITMQ_USER</emphasis> - User to connect to RabbitMQ host.</para>
<emphasis role="bold">RABBITMQ_USER
</emphasis>
- User to connect to RabbitMQ host
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">RABBITMQ_PASSWORD</emphasis> - Password for that user.</para>
<emphasis role="bold">
RABBITMQ_PASSWORD
</emphasis>
- Password for that user
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">RABBITMQ_VHOST</emphasis> - vHost which will be used by Murano
<emphasis role="bold">RABBITMQ_VHOST components. Provides additional layer of isolation from other devboxes.</para>
</emphasis>
- vHost
which will be used by Murano
components. Provides additional
layer of isolation from other devboxes.
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">RABBITMQ_HOST</emphasis> - (optional) IP address or hostname of
<emphasis role="bold">RABBITMQ_HOST the host where RabbitMQ is installed IF it is not the same host as LAB_HOST points to.</para>
</emphasis>
-
(optional) IP address or hostname of
the host where RabbitMQ
is installed IF it is not the same host
as LAB_HOST points
to
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">RABBITMQ_HOST_ALT</emphasis> - (optional) IP address or hostname of
<emphasis role="bold"> the RabbitMQ host to connect from inside the Windows instance. In some cases the
RABBITMQ_HOST_ALT addresses like LAB_HOST or RABBITMQ_HOST are inaccessible from instances, and they must use
</emphasis> different address.</para>
-
(optional) IP address or hostname of
the RabbitMQ host to
connect from inside the Windows
instance. In some cases the
addresses like LAB_HOST or
RABBITMQ_HOST are inaccessible
from instances, and they must use
different address.
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">FILE_SHARE_HOST</emphasis> - (optional) IP address or hostname of
<emphasis role="bold">FILE_SHARE_HOST the host where file share with prerequisites is located if it is not the same host as
</emphasis> LAB_HOST points to.</para>
-
(optional) IP address or hostname of
the host where file
share with prerequisites is located IF
it is not the same
host as LAB_HOST points to.
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">BRANCH_NAME</emphasis> - branch name from which all Murano
<emphasis role="bold">BRANCH_NAME components will be fetched for installation.</para>
</emphasis>
- branch name
from which all Murano components will
be fetched for
installation
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">SSL_ENABLED</emphasis> - Set <emphasis role="bold">'true'</emphasis> if
<emphasis role="bold">SSL_ENABLED OpenStack is configured with SSL support and <emphasis role="bold">'false'</emphasis> otherwise.</para>
</emphasis>
- Set
<emphasis role="bold">'true'</emphasis>
if OpenStack is
configured with SSL support and
<emphasis role="bold"
>'false'
</emphasis>
otherwise.
</para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para><emphasis role="bold">SSL_CA_FILE</emphasis> - Path to CA certificate for certificate validation
<emphasis role="bold">SSL_CA_FILE on client side. Leave it empty when used self-signed certificates.</para>
</emphasis>
- Path to CA
certificate for certificate validation
on client
side.
</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Install Murano <para>Install Murano components
components <programlisting>
<screen> ># ./murano-git-install.sh install
># ./murano-git-install.sh install</screen> </programlisting>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Login to the Dashboard using URL <para>Login to the Dashboard using URL <emphasis role="bold">http://your_VM_IP/horizon</emphasis>
<emphasis role="bold">http://&lt;your on Ubuntu or <emphasis role="bold">http://your_VM_IP/dashboard</emphasis> on CentOS.</para>
VM IP>/dashboard
</emphasis>
or
<emphasis role="bold">http://&lt;your
VM IP>/horizon
</emphasis>
</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</para> </para>