Deleted Manual Way from Getting Started Guide
Change-Id: I882e53c39721debda6a3cfe2517d538af6befeec
This commit is contained in:
parent
87c3765c80
commit
780ffd9d74
@ -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 && 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>
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user