From e9483b4baf73149958528d5f5b0fbfdf6284588b Mon Sep 17 00:00:00 2001 From: Ekaterina Fedorova Date: Fri, 7 Jun 2013 18:21:09 +0400 Subject: [PATCH] Update Installation chapter Change-Id: Idf6d5a9155b84c0798b46f506aa238b51482cbf9 --- .../src/docbkx/murano-manual.xml | 202 +++++++++++++----- 1 file changed, 147 insertions(+), 55 deletions(-) diff --git a/src/murano-manual/src/docbkx/murano-manual.xml b/src/murano-manual/src/docbkx/murano-manual.xml index c8664e3..281f533 100644 --- a/src/murano-manual/src/docbkx/murano-manual.xml +++ b/src/murano-manual/src/docbkx/murano-manual.xml @@ -703,7 +703,7 @@ http://docbook.org/ns/docbook " tenant_id string - Open Stack tenant ID + OpenStack tenant ID version @@ -3358,17 +3358,37 @@ http://docbook.org/ns/docbook " Installation Guide + This chapter is about installation and configuration Murano services. + Note that all Murano modules can be downloaded from + our page on launchpad. + +
+ Common Pre-Requirements + Operation system: + + Ubuntu + RHEL/CentOS + + Packages: + + python-dev + libxml2-dev + libxslt-dev + + +
Murano API Service - Murano API is a project that provides access to engine via API. - This document describes Murano API for contributors of the project, and assumes that you are already + Murano API provides access to the Murano orchestration engine via API. + This chapter describes Murano API for contributors of the project, and assumes that you are already familiar with Murano API from an end-user perspective.
Install - Check out sources to some directory (<home>/murano): + Project source can be checked out as git repository (see below) or downloaded from + here - Install Murano API: + Switch to just created directory + + + + + + And them perform installation: @@ -3389,7 +3417,18 @@ user@work:~/$ cd murano-api && sudo python setup.py install Configure - Open first configuration file for editing: + First configure rabbitMQ by adding vhost and user with administrator rights: + + + + + + Edit configuration file: - Configure according to your environment (please note rabbitmq section): + Configure it according to your environment: + [DEFAULT] section sets up logging. + In [reports] section you can set names for new rabbitMQ queues. + [rabbitmq] section sets up host configuration where rabbitMQ with just created user and vhost is running. + - Open second configuration file for editing: + Edit one more configuration file: - Configure according to your environment (please note filter:authtoken section): + Configure keystone auth_token in [filter:authtoken] section. + For more information see Auth-Token Middleware with Username and Password - + @@ -3494,7 +3538,7 @@ user@work:~/$ murano-api --config-file=./murano/api/etc/murano-api.conf
Conductor Service - Conductor is an Murano orchestration engine that transforms object model sent by REST API service into + Conductor is a Murano orchestration engine that transforms object model sent by REST API service into a series of Heat and Murano-Agent commands. This document describes Conductor for contributors of the project. @@ -3502,18 +3546,31 @@ user@work:~/$ murano-api --config-file=./murano/api/etc/murano-api.conf Install - Check out sources to some directory (<home>/murano): + Project source code can be checked out from git repository (see below) or downloaded from + here. + + + + - Install Conductor: + Switch to just created directory + + + + And install Conductor Service to the system: + + @@ -3523,7 +3580,7 @@ user@work:~/cd murano-conductor && sudo python setup.py install Configure - Open configuration file for editing: + Edit configuration file: - Configure according to your environment (please note rabbitmq section): + + Change it according to your environment. + [DEFAULT] section is responsible for logging. + [heat] points where heat is running. + [rabbitmq] section points where your rabbitMQ installed and configured. + Run Conductor and supply valid configuration file:
Murano Dashboard - Murano Dashboard is a project that provides Web UI to Murano Project. + Murano Dashboard provides Web UI for Murano Project.
- Dependencies - - - - Horizon - - - NodeJs - - - python-muranoclient - - - First two dependencies is already satisfied if you install Murano Dashboard on machine with - OpenStack - Horizon installed. Otherwise, please run: + Pre-Requirements + + + To setup Murano Dashboard on a host with Openstack Dashbord already installed you just need to install + the python-muranoclient. You can download it from here. + And then perform installation with pip: +user@work:~/$ sudo pip install ]]> just_downloaded.tar.gz - - Also, this two packages (horizon and python-muranoclient) can be installed to venv. + + + If there is no OpenStack Dashboard (horizon) you'll need to install it. See here how to do that. + +
Install - Check out sources to some directory (<home>/murano-dashboard): + Project source code can be checked out from git repository (see below) or downloaded from + here. + - Install: + Switch to just created directory + + + + And perform installation + + - Make sure that horizon and python-muranoclient is already installed.
@@ -3622,18 +3682,50 @@ user@work:~/$ cd murano-dashboard && sudo python setup.py install Open Django configuration file: && nano settings.py +user@work:~/$ cd && nano settings.py ]]> Please, make sure that no local/local_settings.py file exists. - Configure: + Add to import section + + + + And this so muranoclient exceptions can be safely handle by horizon: + + + + + + And finally edit HORIZON_CONFIG and INSTALLED_APPS sections + +