320 lines
12 KiB
XML
320 lines
12 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!--
|
||
Copyright (c) 2013 Mirantis, Inc.
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an "AS IS" BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||
implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
-->
|
||
<chapter xmlns="http://docbook.org/ns/docbook"
|
||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||
xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd
|
||
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>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>using Vagrant automation tool</para>
|
||
<para>or</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>using a script to install all components automatically
|
||
</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<note>
|
||
The preferred way is to use script for automated installation. It is described in
|
||
<link linkend="AutomatedWay">Automated Way </link>section below.
|
||
</note>
|
||
<section>
|
||
<title>Vagrant Way</title>
|
||
<para>The simplest way to get working Murano devbox is Vagrant tool. On this page describes how to create the Murano DevBox on Ubuntu Desktop.</para>
|
||
<para><emphasis role="bold">Prepare Environment</emphasis></para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Install VirtualBox:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># apt-get install virtualbox
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Install VirtualBox Extension Pack.</para>
|
||
<para>To install Extension Pack please go to the Dowload section on virtualbox.org
|
||
(<link xlink:href="https://www.virtualbox.org/wiki/Downloads">https://www.virtualbox.org/wiki/Downloads</link>),
|
||
then select and download appropriate Extension Pack package. When downloaded, open it with VirtualBox
|
||
(you could simply double-click the file) and install the package.
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Install Vagrant:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># apt-get install vagrant --no-install-recommends
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Upgrade the Vagrant:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># wget http://files.vagrantup.com/
|
||
packages/7ec0ee1d00a916f80b109a298bab08e391945243/
|
||
vagrant_1.2.7_x86_64.deb
|
||
># dpkg --install vagrant_1.2.7_x86_64.deb
|
||
</programlisting>
|
||
<para><emphasis role="bold">Launch The Box</emphasis></para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Clone murano-deployment repository:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># git clone https://github.com/stackforge/murano-deployment.git
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Change directory to cloned repository folder:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># cd murano-deployment/getting-started
|
||
># git checkout -b release-0.4 origin/release-0.4
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para><emphasis role="bold">IMPORTANT STEP</emphasis>: RabbitMQ credentials are specified to default in
|
||
<filename>murano-deployment/getting-started/localrc</filename> so don't forget to change them by
|
||
replacing all the markers ‘***’ to your settings:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
# Lab Settings
|
||
#-------------
|
||
# Address of the host which provides Keystone service.
|
||
#
|
||
# LAB_HOST='192.168.1.2'
|
||
LAB_HOST='***.***.***.***'
|
||
...
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Launch the box:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
>$ ./launch-the-box.sh
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>The script will do the following:</para>
|
||
<para>- Download the predefined vagrnat box with Ubuntu Server 12.04;</para>
|
||
<para>- Register it in Vagrant;</para>
|
||
<para>- Start the box using vagrant.</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>- Vagrant will do the rest:</para>
|
||
<para>- Launch and initialize the box;</para>
|
||
<para>- Execute the provision.sh script which will install Murano onto the box.</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>When everything is done open the link http://127.0.0.1:8080/horizon
|
||
</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
</section>
|
||
<section xml:id="AutomatedWay">
|
||
<title>Automated Way</title>
|
||
<para>This easy way can be used on Ubuntu Server 12.04 x86-64 and CentOS 6.4 x86-64. Also, you can use virtual machines on VMWare, VirtualBox, KVM with these operating systems.</para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Create a folder to hold git repositories:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># mkdir -p /opt/git && cd /opt/git
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Clone murano-deployment repository from branch release-0.4:</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># git clone git://github.com/stackforge/murano-deployment.git -b release-0.4
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Install prerequisites and configure devbox.</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># cd /opt/git/murano-deployment/devbox-scripts
|
||
># ./murano-git-install.sh prerequisites
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Press Enter to configure lab binding configuration file <filename>/etc/murano-deployment/lab-binding.rc</filename>
|
||
</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
LAB_HOST=''
|
||
|
||
ADMIN_USER=''
|
||
ADMIN_PASSWORD=''
|
||
|
||
RABBITMQ_LOGIN=''
|
||
RABBITMQ_PASSWORD=''
|
||
RABBITMQ_VHOST=''
|
||
RABBITMQ_PORT=''
|
||
|
||
# Equals to LAB_HOST by default
|
||
#RABBITMQ_HOST=''
|
||
#RABBITMQ_HOST_ALT=''
|
||
|
||
#FILE_SHARE_HOST=''
|
||
|
||
BRANCH_NAME='release-0.4'
|
||
|
||
# Only 'true' or 'false' values are allowed!
|
||
SSL_ENABLED='false'
|
||
SSL_CA_FILE=''
|
||
SSL_CERT_FILE=''
|
||
SSL_KEY_FILE=''
|
||
|
||
#BRANCH_MURANO_API=''
|
||
#BRANCH_MURANO_DASHBOARD=''
|
||
#BRANCH_MURANO_CLIENT=''
|
||
#BRANCH_MURANO_CONDUCTOR=''
|
||
#BRANCH_MURANO_REPOSITORY=''
|
||
</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>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Install Murano components</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<programlisting>
|
||
># ./murano-git-install.sh install
|
||
</programlisting>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>When everything is done login to the Dashboard using URL http://your_IP/horizon for Ubuntu and http://your_IP/dashboard for CentOS </para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
</section>
|
||
<section>
|
||
<title>Custom devstack script</title>
|
||
<para>
|
||
It's just like regular devstack installation, but included all Murano services!
|
||
Follow the steps below:
|
||
</para>
|
||
<para><emphasis role="bold">System preparation</emphasis></para>
|
||
<para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para><emphasis>Create user stack</emphasis></para>
|
||
<programlisting>
|
||
># adduser stack
|
||
</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Add user stack to sudoers rules</para>
|
||
<programlisting>
|
||
># echo 'stack ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/stack
|
||
># chmod 440 /etc/sudoers.d/stack
|
||
</programlisting>
|
||
</listitem>
|
||
</itemizedlist>
|
||
</para>
|
||
<para><emphasis role="bold"></emphasis>Installation</para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>Create folders where devstack will install all the files</para>
|
||
<programlisting>
|
||
># mkdir -p /opt/stack
|
||
># chown stack:stack /opt/stack
|
||
</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Change current user to "stack" and change directory to home</para>
|
||
<programlisting>
|
||
># su stack
|
||
>stack$ cd ~
|
||
</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Clone devstack repository and checkout havana branch</para>
|
||
<programlisting>
|
||
>stack$ cd
|
||
>stack$ git clone https://github.com/openstack-dev/devstack.git
|
||
>stack$ cd devstack
|
||
>stack$ git checkout stable/havana
|
||
</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Clone murano-deployment repository</para>
|
||
<programlisting>>stack$ cd
|
||
>stack$ git clone https://github.com/stackforge/murano-deployment.git</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Copy required files from murano-deployment to devstack, then configure local.conf.
|
||
You should set at least one configuration parameter there - HOST_IP address.</para>
|
||
<programlisting>
|
||
>stack$ cd
|
||
>stack$ cp -r murano-deployment/devstack-integration/* devstack/
|
||
</programlisting>
|
||
</listitem>
|
||
|
||
<listitem>
|
||
<para>Replace (or merge settings with) <filename>local.conf</filename> with another config file, if you need a different type of installation.
|
||
Available config files and installation types are:
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para>
|
||
<filename>single-node.local.conf</filename> - single-node all-in-one installation. OpenStack + Murano will be installed on your node together.
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
<filename>devbox.local.conf</filename> - install Murano only. OpenStack must be installed on another node, and your node will be configured to use it.
|
||
</para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>Edit devstack's configuration file</para>
|
||
<programlisting>
|
||
>stack$ vim devstack/local.conf
|
||
</programlisting>
|
||
</listitem>
|
||
<listitem>
|
||
<para>From devstack directory, launch stack.sh</para>
|
||
<programlisting>
|
||
>stack$ ./stack.sh
|
||
</programlisting>
|
||
</listitem>
|
||
</itemizedlist>
|
||
<para>
|
||
Now you can operate with Openstack and Murano. Murano Dashboard panel should appears in horizon dashboard.
|
||
Just open URL http://‹your hostname› in web browser and login with your credentials. Open Murano tab and enjoy.
|
||
</para>
|
||
</section>
|
||
</chapter>
|
||
|