stackforge-attic/murano-docs
Code Issues Proposed changes

Resolve comments in installation chapter

Browse Source 
Change-Id: Ia5af9d1b21011e018d2608477f2caa02057b00db
This commit is contained in:
Ekaterina Fedorova 2013-09-27 15:19:13 +04:00
parent 780ffd9d74
commit 2e341e9e07
1 changed files with 45 additions and 57 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
src/administrators-guide/src/docbkx/content/installation-guide.xml
View File

@ -333,13 +333,13 @@ sudo su -
git clone https://github.com/stackforge/murano-api git clone https://github.com/stackforge/murano-api
]]> ]]>
</programlisting> </programlisting>
<para>Stable version one of our <link xlink:href="http://murano-docs.github.io/latest/developers-guide/content/ch03s02.html"> releases</link> can be checked by tag:</para> <para>Stable version one of our <link xlink:href="http://murano-docs.github.io/latest/developers-guide/content/ch03s02.html"> releases</link> can be checked by the tag:</para>
<programlisting> <programlisting>
cd murano-api &amp;&amp; git checkout 0.2 cd murano-api &amp;&amp; git checkout 0.2
</programlisting> </programlisting>
</listitem> </listitem>
<listitem> <listitem>
<para>Switch to just created directory and then perform installation</para> <para>And perform installation:</para>
<para> <para>
<emphasis>Ubuntu</emphasis> <emphasis>Ubuntu</emphasis>
</para> </para>
@ -385,7 +385,7 @@ cp murano-api-paste.ini.sample murano-api-paste.ini
</programlisting> </programlisting>
</listitem> </listitem>
<listitem> <listitem>
<para>Configure <file>murano-api.conf</file> it according to your environment: <para>Configure <filename>murano-api.conf</filename> it according to your environment:
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><emphasis>[DEFAULT]</emphasis> section sets up logging. <para><emphasis>[DEFAULT]</emphasis> section sets up logging.
@ -413,34 +413,18 @@ rabbitmqctl set_permissions -p muranovhost muranouser ".*" ".*" ".*"
</programlisting> </programlisting>
</listitem> </listitem>
<listitem> <listitem>
<para>In <emphasis>[filter:authtoken]</emphasis> <para>In <emphasis>[keystone_authtoken]</emphasis>
configure keystone auth_token. For more information see configure parameters of Openstack Keystone service. For more information see
<link xlink:href="http://docs.openstack.org/developer/keystone/configuringservices.html"> <link xlink:href="http://docs.openstack.org/developer/keystone/configuringservices.html">
Auth-Token Middleware with Username and Password Auth-Token Middleware with Username and Password
</link> </link>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Update configuration in <filename>/etc/murano-api/murano-api-paste.ini <para>
</filename>: Another murano-api configuration file located at
<programlisting> <filename>/etc/murano-api/murano-api-paste.ini</filename> and does
... not require any changes.
[filter.authtoken]
...
# auth_host should point to the host where Keyston servive is installed
auth_host =
...
# For auth_protocol use 'http' in general and 'https' if Keystone supports SSL.
auth_protocol = http
# A name for OpenStack admin tenant name ('admin' by default)
admin_tenant_name = admin
# A name for OpenStack admin user ('admin' by default)
admin_user = admin
# A pasword for admin user
admin_password =
...
</programlisting>
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
@ -550,7 +534,7 @@ cd murano-conductor &amp;&amp; git checkout 0.2
</programlisting> </programlisting>
</listitem> </listitem>
<listitem> <listitem>
<para>Switch to just created directory and then perform installation</para> <para>And then perform installation</para>
<para> <para>
<emphasis>Ubuntu</emphasis> <emphasis>Ubuntu</emphasis>
</para> </para>
@ -828,7 +812,7 @@ sh setup-centos.sh install
<title>HTTPS for Murano API</title> <title>HTTPS for Murano API</title>
<para> <para>
SSL for Murano API service can be configured in <emphasis>ssl</emphasis> section in SSL for Murano API service can be configured in <emphasis>ssl</emphasis> section in
<emphasis>/etc/murano-api/murano-api.conf</emphasis>. Just point to a valid SSL certificate. <filename>/etc/murano-api/murano-api.conf</filename>. Just point to a valid SSL certificate.
See the example below: See the example below:
</para> </para>
<programlisting> <programlisting>
@ -880,15 +864,14 @@ ca_file = PATH
default all messages in Rabbit MQ are not encrypted. default all messages in Rabbit MQ are not encrypted.
Each RabbitMQ Exchange should be configured separately. Each RabbitMQ Exchange should be configured separately.
</para> </para>
<section> <para><emphasis role="bold">Murano API -> Rabbit MQ exchange</emphasis></para>
<title>Murano API -> Rabbit MQ exchange</title> <para>
<para> Edit <emphasis>rabbitmq</emphasis> section in <filename>/etc/murano-api/murano-api.conf</filename>
Edit <emphasis>rabbitmq</emphasis> section in <emphasis>/etc/murano-api/murano-api.conf</emphasis> and set ssl option to True to enable SSL. Specify the path to the
and set ssl option to True to enable SSL. Specify the path to the SSL CA certificate in regular format: /path/to/file without quotes or leave it empty to allow
SSL CA certificate in regular format: /path/to/file without quotes or leave it empty to allow self-signed certificates.
self-signed certificates. </para>
</para> <programlisting>
<programlisting>
<![CDATA[ <![CDATA[
[rabbitmq] [rabbitmq]
@ -898,10 +881,8 @@ ssl = True
# Path to SSL CA certificate or empty to allow self signed server certificate # Path to SSL CA certificate or empty to allow self signed server certificate
ca_certs = ca_certs =
]]> ]]>
</programlisting> </programlisting>
</section> <para><emphasis role="bold">Rabbit MQ -> Murano Conductor exchange</emphasis></para>
<section>
<title>Rabbit MQ -> Murano Conductor exchange</title>
<para> <para>
Open <emphasis>/etc/murano-conductor/conductor.conf</emphasis> Open <emphasis>/etc/murano-conductor/conductor.conf</emphasis>
and configure <emphasis>rabbitmq</emphasis> section in the same way: and configure <emphasis>rabbitmq</emphasis> section in the same way:
@ -919,16 +900,16 @@ ssl = True
ca_certs = /home/user/certificates/example.crt ca_certs = /home/user/certificates/example.crt
]]> ]]>
</programlisting> </programlisting>
</section> <para><emphasis role="bold">
<section> Murano Agent -> Rabbit MQ exchange</emphasis>
<title>Murano Agent -> Rabbit MQ exchange</title> </para>
<para> <para>
By default all Murano Conductor configuration settings apply to Murano Agent. By default all Murano Conductor configuration settings apply to Murano Agent.
If you want to configure Murano Agent in a different way change the default template. It can be found If you want to configure Murano Agent in a different way change the default template. It can be found
here:<emphasis>/etc/murano-conductor/data/templates/agent-config/Default.template.</emphasis> here:<emphasis>/etc/murano-conductor/data/templates/agent-config/Default.template.</emphasis>
Take a look at appSettings section: Take a look at appSettings section:
</para> </para>
<programlisting> <programlisting>
<![CDATA[ <![CDATA[
<appSettings> <appSettings>
<add key="rabbitmq.host" value="%RABBITMQ_HOST%"/> <add key="rabbitmq.host" value="%RABBITMQ_HOST%"/>
@ -949,16 +930,23 @@ ca_certs = /home/user/certificates/example.crt
<add key="rabbitmq.sslServerName" value=""/> <add key="rabbitmq.sslServerName" value=""/>
</appSettings> </appSettings>
]]> ]]>
</programlisting> </programlisting>
<para>
Desired parameter should be set directly to the value of the key
that you want to change. Quotes are need to be kept.
Thus you can change "rabbitmq.ssl" and "rabbitmq.port" values to
make Rabbit MQ work with this exchange in a different from
Murano-Conductor way.
</para>
</section>
<section>
<title>SSL for Murano Dashboard</title>
<para> <para>
Desired parameter should be set directly to the value of the key If you are going not to use self-signed certificates additional configuration do not need to be done.
that you want to change. Quotes are need to be kept. Just point https in the URL. Otherwise, set <emphasis>MURANO_API_INSECURE = True</emphasis> on horizon config.
Thus you can change "rabbitmq.ssl" and "rabbitmq.port" values to You can find it in <filename>/etc/openstack-dashboard/local_settings.py.</filename>.
make Rabbit MQ work with this exchange in a different from
Murano-Conductor way.
</para> </para>
</section> </section>
</section>
</section> </section>
</section> </section>
</chapter> </chapter>