Deleted Manual Way from Getting Started Guide
Change-Id: I882e53c39721debda6a3cfe2517d538af6befeec
This commit is contained in:
bigden
@@ -22,18 +22,16 @@
|
|||||||
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>Setup Devbox</title>
|
<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>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>using Vagrant automation tool</para>
|
<para>using Vagrant automation tool</para>
|
||||||
|
<para>or</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>using a script to install all components automatically
|
<para>using a script to install all components automatically
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
|
||||||
<para>install everything manually</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
<note>
|
<note>
|
||||||
The preferred way is to use script for automated installation. It is described in
|
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_PASSWORD='murano'
|
||||||
RABBITMQ_VHOST='muranovhost'
|
RABBITMQ_VHOST='muranovhost'
|
||||||
BRANCH_NAME='release-0.2'
|
BRANCH_NAME='release-0.2'
|
||||||
|
|
||||||
|
SSL_ENABLED='false'
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<para>It's recommended to use separate vHost in <link linkend="Rabbit">RabbitMQ</link>.</para>
|
<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>
|
<para>Then some additional system packages will be installed.</para>
|
||||||
@@ -201,301 +201,5 @@ BRANCH_NAME='release-0.2'
|
|||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</section>
|
</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 && 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 && 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 = <rabbitmq_ip>
|
|
||||||
port = 5672
|
|
||||||
ssl = False
|
|
||||||
login = <rabbitmq login>
|
|
||||||
password = <rabbitmq password>
|
|
||||||
virtual_host = <rabbitmq vhost>
|
|
||||||
...
|
|
||||||
</programlisting>
|
|
||||||
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>murano-api-paste.ini:</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
<programlisting>
|
|
||||||
...
|
|
||||||
[filter:authtoken]
|
|
||||||
auth_host = <keystone_ip>
|
|
||||||
auth_port = 35357
|
|
||||||
auth_protocol = http
|
|
||||||
admin_tenant_name = <tenant_name>
|
|
||||||
admin_user = admin
|
|
||||||
admin_password = <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 && 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 = <rabbitmq ip>
|
|
||||||
port = 5672
|
|
||||||
login = <rabbitmq login>
|
|
||||||
password = <rabbitmq password>
|
|
||||||
virtual_host = <rabbitmq vhost>
|
|
||||||
...
|
|
||||||
</programlisting>
|
|
||||||
<itemizedlist>
|
|
||||||
<listitem>
|
|
||||||
<para>conductor-paste.ini</para>
|
|
||||||
<para>It’s 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 && 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>
|
</chapter>
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user