Add installation from venv chapter

Change-Id: I0ba51450abc310f6dd76c5e2238e308ab66e99ec

src/administrators-guide/pom.xml

@@ -40,6 +40,14 @@
                 <configuration>
                     <xincludeSupported>true</xincludeSupported>
                     <chunkSectionDepth>100</chunkSectionDepth>
+                    <postProcess>
+                        <copy todir="target/docbkx/webhelp/administrators-guide/style">
+                            <fileset dir="src/docbkx/style">
+                                <include name="**/*.css"/>
+                                <include name="**/*.xsl"/>
+                            </fileset>
+                        </copy>
+                    </postProcess>
                 </configuration>
             </plugin>
         </plugins>

src/administrators-guide/src/docbkx/administrators-guide.xml

@@ -869,9 +869,11 @@ create mask = 0755                        </screen>
         <orderedlist>
             <listitem>
                 <para> Use the glance image-create command to import your disk image to Glance:
-                    <screen>>$ glance image-create --name &lt;NAME> --is-public true       \
+                    <screen>>$ glance image-create --name &lt;NAME> \
-                        --disk-format qcow2 --container-format bare --file &lt;IMAGE_FILE> \
+     --is-public true --disk-format qcow2 \
-                        --property &lt;IMAGE_METADATA></screen>
+     --container-format bare \
+     --file &lt;IMAGE_FILE> \
+     --property &lt;IMAGE_METADATA></screen>
                 </para>
                 <para>
                     Replace the command line arguments to glance image-create with the
@@ -932,7 +934,8 @@ create mask = 0755                        </screen>
                     <listitem>
                         <para> Replace <emphasis role="bold">&lt;IMAGE_METADATA></emphasis> with
                             murano_image_info property,
-                            e.g.<screen>murano_image_info='{"title": "Windows 2012 Core Edition","type": "ws-2012-core"}'</screen></para>
+                            e.g.<screen>murano_image_info='{"title": "Windows 2012 Core Edition",\
+"type": "ws-2012-core"}'</screen></para>
                     </listitem>
                 </itemizedlist>
             </listitem>

src/administrators-guide/src/docbkx/style/administrators-guide.css

@@ -0,0 +1,41 @@
+img {
+    max-width: 100%;
+    width: auto;
+    height: auto;
+}
+ body {
+         font-family: luxi sans,sans-serif;
+}
+
+.programlisting ~ a,
+.programlisting,
+.screen  {
+        font-family: monospace;
+        font-size: 1em;
+        display: block;
+        padding: 10px;
+        border: 1px solid #bbb;
+        background-color: #ddd;
+        color: #000;
+        overflow: auto;
+        border-radius: 2.5px;
+        -moz-border-radius: 2.5px;
+        margin: 0.5em 2em;
+}
+
+a[href] {
+    text-decoration: none;
+    color: #0a5ba8;
+   }
+
+a[href]:hover {
+    text-decoration:underline
+}
+
+a:visited {
+    color: #131580;
+   }
+
+a:active {
+    color: #0a5ba8;
+   }

src/administrators-guide/src/docbkx/style/config.xsl

@@ -0,0 +1,10 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
+                version="1.0">
+  <xsl:param name="use.id.as.filename" select="'1'"/>
+  <xsl:param name="admon.graphics" select="'1'"/>
+  <xsl:param name="admon.graphics.path"></xsl:param>
+  <xsl:param name="chunk.section.depth" select="0"></xsl:param>
+  <xsl:param name="html.stylesheet" select="administrators-guide.css"/>
+</xsl:stylesheet>

src/developers-guide/src/docbkx/content/installation-guide.xml

@@ -36,7 +36,7 @@
                 Getting Started Guide</link>
         </note>
     </para>
-    <section>
+    <section xml:id="prerequisites">
         <title>Pre-Requisites</title>
         <para>Murano supports the following operating systems:</para>
         <orderedlist>
@@ -164,7 +164,7 @@ LOG:> Please, make proper configuration,located at "/etc/murano-api", before sta
                 </listitem>
             </itemizedlist>
         </section>
-        <section>
+        <section xml:id="configure_api">
             <title>Configure</title>
             <itemizedlist spacing="compact">
                 <listitem>
@@ -379,7 +379,7 @@ sh murano-conductor/setup-centos.sh install
                 </listitem>
             </itemizedlist >
         </section>
-        <section>
+        <section xml:id="configure_conductor">
             <title>Configure</title>
             <itemizedlist spacing="compact">
                 <listitem>
@@ -577,7 +577,7 @@ sh murano-dashboard/setup-centos.sh install
                 </listitem>
             </itemizedlist>
         </section>
-    <section>
+    <section xml:id="configure_dashboard">
         <title>Configure</title>
         <itemizedlist spacing="compact">
         <listitem>
@@ -617,13 +617,153 @@ sh murano-dashboard/setup-centos.sh install
                         Check that "Environments" panel appears at the horizon "Project" tab.
                         To see how to operate with Murano dashboard plugin check out
                         <link xlink:href="http://murano-docs.github.io/latest/user-guide/content/ch01.html">
-                        Murano User Guide
+                        Murano User Guide.
                         </link>
                     </para>
                 </listitem>
             </itemizedlist>
         </section>
     </section>
+    <section xml:id="venv">
+        <title>Installing with virtual environment</title>
+        <para>
+            For local development, all Murano components can be installed in
+            a virtual environment.
+            </para>
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        Install virtaulenv packege if you don't have one:
+                        <programlisting>
+sudo pip install virtualenv
+                        </programlisting>
+
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>Check out git repository with murano component:
+                    </para>
+                    <itemizedlist>
+                        <listitem>
+                                <programlisting>
+git clone https://github.com/stackforge/murano-api
+                                </programlisting>
+                        </listitem>
+                        <listitem>
+                                <programlisting>
+git clone https://github.com/stackforge/murano-conductor
+                                </programlisting>
+                        </listitem>
+                        <listitem>
+                                <programlisting>
+git clone https://github.com/stackforge/murano-dashboard
+                                </programlisting>
+                        </listitem>
+                    </itemizedlist>
+                </listitem>
+                <listitem>
+                    <para>
+                        Make sure that required system packages are installed.
+                        Check list from <link linkend="prerequisites"> prerequisites page</link>
+                    </para>
+                </listitem>
+                <listitem>
+                        <para>
+                            Execute a script in the <filename>tools</filename> directory
+                                to create virtual environment automatically:
+                            <programlisting>
+$ python tools/install_venv.py
+                            </programlisting>
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        For <emphasis role="bold"> Murano Dashboard </emphasis>additional installation need to be done:
+                        <itemizedlist>
+                            <listitem>
+                                <para>
+                                    Openstack dashboard (horizon).:
+                                    <programlisting>
+./tools/with_venv.sh pip install https://github.com/openstack/horizon/archive/grizzly-2.tar.gz
+                                    </programlisting>
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    Install openstack-dashboard dependency:
+                                    <itemizedlist>
+                                        <listitem>
+                                            <para>
+                                                <emphasis>Ubuntu</emphasis>
+                                                <programlisting>
+# apt-get install nodejs
+                                                </programlisting>
+                                            </para>
+                                        </listitem>
+                                        <listitem>
+                                            <para>
+                                                <emphasis>CentOS</emphasis>
+                                                <programlisting>
+# yum install nodejs
+                                                </programlisting>
+                                            </para>
+                                        </listitem>
+                                    </itemizedlist>
+
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para>
+                                    Customized Djblets package to support datagrid element (installation by pip is not supported):
+                                <programlisting>
+./tools/with_venv.sh easy_install https://github.com/tsufiev/djblets/archive/master.zip
+                                </programlisting>
+                                </para>
+                            </listitem>
+
+                        </itemizedlist>
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        Config files for the development infrastructure of murano-api and murano-conductor can be found at <filename>etc</filename>
+                        under folder with component repository. Follow the links to see how config files should be configured:
+                        <link linkend="configure_api">Murano API</link> and <link linkend="configure_conductor">Murano Conductor</link>.
+                        To configure Murano Dashboard copy
+                        <programlisting>
+# cp muranodashboard/local/local_settings.py.example muranodashboard/local/local_settings.py
+                        </programlisting>
+                        set the actual IP address of the OpenStack end-point.
+                        If you haven't register murano-api service in the keystone catalog you can set MURANO_API_URL in the same settings file.
+                        Note that local murano-api service will be using by default.
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>Run Murano API:
+                        <programlisting>
+./tools/with_venv.sh python api/cmd/api.py --config-file=./etc/murano-api.conf
+                        </programlisting>
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>Run Murano Conductor:
+                        <programlisting>
+./tools/with_venv.sh python muranoconductor/cmd/run.py --config-file=./etc/conductor.conf
+                        </programlisting>
+                    </para>
+                </listitem>
+                <listitem>
+                    <para><emphasis>Run Murano Dashboard:</emphasis>
+                        To start the Murano development server use the Django
+                        manage.py utility with the context of the virtual
+                        environment:
+                        <programlisting>
+./tools/with_venv.sh ./manage.py runserver 0.0.0.0:8080
+                        </programlisting>
+                    </para>
+                </listitem>
+            </itemizedlist>
+    </section>
     <section xml:id="ssl">
         <title>SSL configuration</title>
         <para>
@@ -639,10 +779,10 @@ sh murano-dashboard/setup-centos.sh install
             </para>
             <programlisting>
                 <![CDATA[
-    [ssl]
+[ssl]
-    cert_file = PATH
+cert_file = PATH
-    key_file = PATH
+key_file = PATH
-    ca_file = PATH
+ca_file = PATH
                 ]]>
             </programlisting>
             <itemizedlist>

src/developers-guide/src/docbkx/style/developers-guide.css

@@ -7,21 +7,6 @@ img {
          font-family: luxi sans,sans-serif;
 }
 
- {
-        font-family: monospace;
-        font-size: 1em;
-        display: block;
-        padding: 10px;
-        border: 1px solid #bbb;
-        background-color: #eee;
-        color: #000;
-        overflow: auto;
-        border-radius: 2.5px;
-        -moz-border-radius: 2.5px;
-        margin: 0.5em 2em;
-
-}
-
 .programlisting ~ a,
 .programlisting,
 .screen  {

src/getting-started/src/docbkx/content/setup_lab_environment.xml

@@ -433,7 +433,7 @@
                     </para>
                 </listitem>
             </itemizedlist>
-            <programlisting>
+            <programlisting width="200">
 >$ cd /opt/image-builder/share/images
 >$ glance image-create --name ws-2012-std --disk-format qcow2           \
     --container-type bare --file ws-2012-std.qcow2 --is-public true     \