Add installation from venv chapter
Change-Id: I0ba51450abc310f6dd76c5e2238e308ab66e99ec
This commit is contained in:
Ekaterina Fedorova
@@ -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>
|
||||
|
||||
@@ -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 <NAME> --is-public true \
|
||||
--disk-format qcow2 --container-format bare --file <IMAGE_FILE> \
|
||||
--property <IMAGE_METADATA></screen>
|
||||
<screen>>$ glance image-create --name <NAME> \
|
||||
--is-public true --disk-format qcow2 \
|
||||
--container-format bare \
|
||||
--file <IMAGE_FILE> \
|
||||
--property <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"><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>
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
10
src/administrators-guide/src/docbkx/style/config.xsl
Normal file
10
src/administrators-guide/src/docbkx/style/config.xsl
Normal file
@@ -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>
|
||||
@@ -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]
|
||||
cert_file = PATH
|
||||
key_file = PATH
|
||||
ca_file = PATH
|
||||
[ssl]
|
||||
cert_file = PATH
|
||||
key_file = PATH
|
||||
ca_file = PATH
|
||||
]]>
|
||||
</programlisting>
|
||||
<itemizedlist>
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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 \
|
||||
|
||||
Reference in New Issue
Block a user