Deleted Manual Way from Getting Started Guide

Change-Id: I882e53c39721debda6a3cfe2517d538af6befeec
This commit is contained in:
bigden 2013-09-27 14:22:39 +04:00
parent 87c3765c80
commit 780ffd9d74
1 changed files with 4 additions and 300 deletions

View File

@ -22,18 +22,16 @@
http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd"
version="5.0">
<title>Setup Devbox</title>
<para>There are a few ways to install Murano devbox</para>
<para>There are a few ways to install Murano devbox:</para>
<itemizedlist>
<listitem>
<para>using Vagrant automation tool</para>
<para>or</para>
</listitem>
<listitem>
<para>using a script to install all components automatically
</para>
</listitem>
<listitem>
<para>install everything manually</para>
</listitem>
</itemizedlist>
<note>
The preferred way is to use script for automated installation. It is described in
@ -184,6 +182,8 @@ RABBITMQ_LOGIN='muranouser'
RABBITMQ_PASSWORD='murano'
RABBITMQ_VHOST='muranovhost'
BRANCH_NAME='release-0.2'
SSL_ENABLED='false'
</programlisting>
<para>It's recommended to use separate vHost in <link linkend="Rabbit">RabbitMQ</link>.</para>
<para>Then some additional system packages will be installed.</para>
@ -201,301 +201,5 @@ BRANCH_NAME='release-0.2'
</listitem>
</itemizedlist>
</section>
<section xml:id="ManualWay">
<title>Manual Way</title>
<para>By this way you can install and configure all Murano services separately</para>
<section>
<title>Murano-API</title>
<para>Make sure the <link linkend="Rabbit">RabbitMQ</link> and <link linkend="Keystone">Keystone</link> is configured correctly</para>
<itemizedlist>
<listitem>
<para>Create a folder to hold git repositories:</para>
</listitem>
</itemizedlist>
<programlisting>
># mkdir -p /opt/git &amp;&amp; cd /opt/git
</programlisting>
<itemizedlist>
<listitem>
<para>Clone murano-api repository from branch release-0.2:</para>
</listitem>
</itemizedlist>
<programlisting>
># git clone git://github.com/stackforge/murano-api.git -b release-0.2 &amp;&amp; cd /opt/git/murano-api
</programlisting>
<itemizedlist>
<listitem>
<para>Install Murano-API:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># sh setup.sh install
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># sh setup-centos.sh install
</programlisting>
<para>Successful installation ends with message like this:</para>
<programlisting>
Successfully installed muranoapi
Cleaning up...
LOG:> Making sample configuration files at "/etc/murano-api"
LOG:> Reloading initctl
LOG:> Please, make proper configuration,located at "/etc/murano-api", before starting the "murano-api" daemon!
</programlisting>
<para>Configuration files of the murano-api service reside at <filename>
/etc/murano-api</filename> directory. Basic configuration parameters are
listed below.
</para>
<itemizedlist>
<listitem>
<para>murano-api.conf:</para>
</listitem>
</itemizedlist>
<programlisting>
[DEFAULT]
...
bind_host = 0.0.0.0
bind_port = 8082
log_file = /var/log/murano-api.log
...
[database]
...
connection = sqlite:///murano.sqlite
...
[rabbitmq]
host = &lt;rabbitmq_ip>
port = 5672
ssl = False
login = &lt;rabbitmq login>
password = &lt;rabbitmq password>
virtual_host = &lt;rabbitmq vhost>
...
</programlisting>
<itemizedlist>
<listitem>
<para>murano-api-paste.ini:</para>
</listitem>
</itemizedlist>
<programlisting>
...
[filter:authtoken]
auth_host = &lt;keystone_ip>
auth_port = 35357
auth_protocol = http
admin_tenant_name = &lt;tenant_name>
admin_user = admin
admin_password = &lt;admin_keystone_password>
signing_dir = /tmp/keystone-signing-muranoapi
...
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>Start Murano-API:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># service murano-api start
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># initctl start murano-api
</programlisting>
</listitem>
</itemizedlist>
</section>
<section>
<title>Murano-Conductor</title>
<itemizedlist>
<listitem>
<para>Go to a git folder:</para>
</listitem>
</itemizedlist>
<programlisting>
># cd /opt/git
</programlisting>
<itemizedlist>
<listitem>
<para>Clone murano-conductor repository from branch release-0.2:</para>
</listitem>
</itemizedlist>
<programlisting>
># git clone git://github.com/stackforge/murano-conductor.git -b release-0.2 &amp;&amp; cd /opt/git/murano-conductor
</programlisting>
<itemizedlist>
<listitem>
<para>Install Murano-Conductor:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># sh setup.sh install
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># sh setup-centos.sh install
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>
Configuration files of the murano-conductor service reside at
<filename>/etc/murano-conductor </filename>directory. Basic configuration parameters are
listed below:
</para>
<itemizedlist>
<listitem>
<para>conductor.conf</para>
</listitem>
</itemizedlist>
<programlisting>
[DEFAULT]
log_file = /var/log/murano-conductor.log
[keystone]
# URL of OpenStack KeyStone service REST
API.
# Typically only hostname (or IP) needs to be
changed
auth_url = http://keystone_ip:5000/v2.0
...
...
[rabbitmq]
host = &lt;rabbitmq ip>
port = 5672
login = &lt;rabbitmq login>
password = &lt;rabbitmq password>
virtual_host = &lt;rabbitmq vhost>
...
</programlisting>
<itemizedlist>
<listitem>
<para>conductor-paste.ini</para>
<para>Its empty but must exist.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>Start Murano-Conductor:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># service murano-conductor start
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># initctl start murano-conductor
</programlisting>
</listitem>
</itemizedlist>
</section>
<section>
<title>Murano-Dashboard</title>
<para>Murano-Dashboard required additional repositories are installed and your system is updated and upgraded.
It can be checked with steps in the appendix of administrator guide.</para>
<warning>
<para>This installation is not capable with Horizon installed by devstack</para>
</warning>
<itemizedlist>
<listitem>
<para>If there is no openstack dashboard package in your environment install it now with all dependencies:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<para>Deleting an Ubuntu theme is an optional step but recommended. </para>
<programlisting>
># apt-get install memcached libapache2-mod-wsgi openstack-dashboard
># dpkg --purge openstack-dashboard-ubuntu-theme
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># yum install make gcc memcached python-memcached mod_wsgi openstack-dashboard python-netaddr.noarch
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>Go to a git folder:</para>
</listitem>
</itemizedlist>
<programlisting>
># cd /opt/git
</programlisting>
<itemizedlist>
<listitem>
<para>Clone murano-dashboard repository from branch release-0.2:</para>
</listitem>
</itemizedlist>
<programlisting>
># git clone git://github.com/stackforge/murano-dashboard .git -b release-0.2 &amp;&amp; cd /opt/git/murano-dashboard
</programlisting>
<itemizedlist>
<listitem>
<para>Install Murano-Dashboard:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># sh setup.sh install
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># sh setup-centos.sh install
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para> Murano-dashboard does not need to be configured, but we need to
set up proper OPENSTACK_HOST variable in the OpenStack dashboard
configuration file, which resides at
<filename> /etc/openstack-dashboard </filename>
directory. It should point to the OpenStack controller node.
</para>
<programlisting>
# optional, but sometimes very useful to set DEBUG to True
DEBUG = True
...
OPENSTACK_HOST =
“openstack_controller_address”
...
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>Start Murano-Dashboard:</para>
<para><emphasis>On Ubuntu:</emphasis></para>
<programlisting>
># service apache2 restart
</programlisting>
<para><emphasis>On CentOS:</emphasis></para>
<programlisting>
># service httpd restart
</programlisting>
</listitem>
</itemizedlist>
<itemizedlist>
<listitem>
<para>Open your browser:</para>
<para><emphasis>For Ubuntu:</emphasis></para>
<programlisting>
http://your_devbox_ip/horizon
</programlisting>
<para><emphasis>For CentOS:</emphasis></para>
<programlisting>
http://your_devbox_ip/dashboard
</programlisting>
</listitem>
</itemizedlist>
Login with Keystone credentials and check that "Environments" panel appears at the horizon "Project" tab.
</section>
</section>
</chapter>