Update user-guide with Murano Repository
Change-Id: I805730167c382b13407418ff2ee0b54f1fdb8f92
@ -21,23 +21,33 @@
|
|||||||
xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd
|
xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd
|
||||||
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>Murano dashboard plugin</title>
|
<title>Environments</title>
|
||||||
<para>
|
<para>
|
||||||
To use Murano you should be familiar with Openstack. Murano Dashboard is just a plugin to Openstack dashboard - Horizon.
|
<emphasis role="bold"> Murano Environment </emphasis> - a virtual unit to store different services (applications).
|
||||||
Please visit
|
They can be connected with each other or be individual. The following actions with environment are available:
|
||||||
<link xlink:href="http://docs.openstack.org/user-guide/content/"> horizon user guide </link>
|
<itemizedlist>
|
||||||
first to see how dashboard is organized and how to login to it.
|
<listitem>
|
||||||
|
<para>Create;</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Delete;</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Deploy.</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
More information about actions with environment are described in this chapter.
|
||||||
</para>
|
</para>
|
||||||
<section>
|
<section>
|
||||||
<title>Creating environment</title>
|
<title>Creating environment</title>
|
||||||
<para> Once you installed all Murano components and login to horizon dashboard successfully you will see Environments panel:</para>
|
<para>Once you installed all Murano components and logged-in to horizon dashboard successfully you will see Murano tab:</para>
|
||||||
<mediaobject>
|
<mediaobject>
|
||||||
<imageobject role="fo">
|
<imageobject role="fo">
|
||||||
<imagedata fileref="../images/env_panel.png" scalefit="1" width="100%" contentdepth="100%"/>
|
<imagedata fileref="../images/env_panel.png" scalefit="1" width="100%" contentdepth="100%"/>
|
||||||
</imageobject>
|
</imageobject>
|
||||||
</mediaobject>
|
</mediaobject>
|
||||||
<para>
|
<para>
|
||||||
First thing you need to do is to create an environment - virtual Windows Data Center which will contain different Windows services.
|
First thing you need to do is to create an environment.
|
||||||
To do this, navigate to the "Environments" page and click the "Create Environment". After setting name to your virtual environment it will be created.
|
To do this, navigate to the "Environments" page and click the "Create Environment". After setting name to your virtual environment it will be created.
|
||||||
</para>
|
</para>
|
||||||
<mediaobject>
|
<mediaobject>
|
||||||
@ -59,8 +69,7 @@
|
|||||||
<section>
|
<section>
|
||||||
<title>Creating service prototype</title>
|
<title>Creating service prototype</title>
|
||||||
<para >
|
<para >
|
||||||
All services should be created in the context of Environment
|
All services should be created in the context of Environment. After Environment is created, you need to create service prototypes
|
||||||
- virtual Windows Data Center. After Environment is created, you need to create services prototypes
|
|
||||||
and then deploy the Environment. When deploy process is done instances
|
and then deploy the Environment. When deploy process is done instances
|
||||||
with your services will be spawned in Openstack.
|
with your services will be spawned in Openstack.
|
||||||
To create a service prototype navigate to page with the list of environment services by
|
To create a service prototype navigate to page with the list of environment services by
|
||||||
@ -86,6 +95,26 @@
|
|||||||
To see more information about filling the form for a specific service follow one of the link below:
|
To see more information about filling the form for a specific service follow one of the link below:
|
||||||
</para>
|
</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<emphasis role="bold">
|
||||||
|
<link linkend="ASP">ASP.NET Service:</link>
|
||||||
|
</emphasis>
|
||||||
|
is a server-side Web application framework designed for Web
|
||||||
|
development to produce dynamic Web pages. Service is able
|
||||||
|
to install custom application onto one IIS Web Server. Murano installs
|
||||||
|
all needed components and makes proper configuration.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<emphasis role="bold">
|
||||||
|
<link linkend="ASPfarm">ASP.NET Farm Service:</link>
|
||||||
|
</emphasis>
|
||||||
|
ASP.NET Farm Service installs a custom application on a
|
||||||
|
load-balanced array of IIS servers.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis role="bold"><link linkend="AD">Active Directory:</link></emphasis>
|
<emphasis role="bold"><link linkend="AD">Active Directory:</link></emphasis>
|
||||||
@ -95,6 +124,22 @@
|
|||||||
Any other services you are intending to create can be
|
Any other services you are intending to create can be
|
||||||
joined to that domain.
|
joined to that domain.
|
||||||
</para>
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<emphasis role="bold">
|
||||||
|
<link linkend="Apache">Apache Service:</link></emphasis>
|
||||||
|
Apache HTTP Server is a web server application notable for playing a key role in the initial growth of the World Wide Web.
|
||||||
|
This service can install Apache with PHP module or without it.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<emphasis role="bold">
|
||||||
|
<link linkend="Demo">Demo Service:</link></emphasis>
|
||||||
|
Installs test service that demonstrates how to Murano interconnects with Murano Demo Agent.
|
||||||
|
For this service light-weight Linux Cirros image can be used.
|
||||||
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
@ -115,22 +160,9 @@
|
|||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis role="bold">
|
<emphasis role="bold"><link linkend="Telnet">Linux Telnet:</link></emphasis>
|
||||||
<link linkend="ASP">ASP.NET Service:</link>
|
Telnet - is a network protocol used to provide a bidirectional interactive
|
||||||
</emphasis>
|
text-oriented communication facility using a virtual terminal connection.
|
||||||
is a server-side Web application framework designed for Web
|
|
||||||
development to produce dynamic Web pages. Service is able
|
|
||||||
to install custom application onto one IIS Web Server. Murano installs
|
|
||||||
all needed components and makes proper configuration.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
<listitem>
|
|
||||||
<para>
|
|
||||||
<emphasis role="bold">
|
|
||||||
<link linkend="ASPfarm">ASP.NET Farm Service:</link>
|
|
||||||
</emphasis>
|
|
||||||
ASP.NET Farm Service installs a custom application on a
|
|
||||||
load-balanced array of IIS servers
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
@ -142,7 +174,7 @@
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis role="bold">
|
<emphasis role="bold">
|
||||||
<link linkend="SQLfarm">SQL Server Failover Cluster:</link>
|
<link linkend="SQLfarm">MS SQL Server Failover Cluster:</link>
|
||||||
</emphasis>
|
</emphasis>
|
||||||
Murano installs all needed components and configures your
|
Murano installs all needed components and configures your
|
||||||
SQL Server Cluster the way you want.
|
SQL Server Cluster the way you want.
|
||||||
@ -304,7 +336,7 @@
|
|||||||
</mediaobject>
|
</mediaobject>
|
||||||
</section>
|
</section>
|
||||||
<section xml:id="SQLfarm">
|
<section xml:id="SQLfarm">
|
||||||
<title>SQL Server Failover Cluster</title>
|
<title>MS SQL Server Failover Cluster</title>
|
||||||
<mediaobject>
|
<mediaobject>
|
||||||
<imageobject role="fo">
|
<imageobject role="fo">
|
||||||
<imagedata fileref="../images/cluster1.png" scalefit="1" width="100%" contentdepth="100%"/>
|
<imagedata fileref="../images/cluster1.png" scalefit="1" width="100%" contentdepth="100%"/>
|
||||||
@ -442,6 +474,114 @@
|
|||||||
</imageobject>
|
</imageobject>
|
||||||
</mediaobject>
|
</mediaobject>
|
||||||
</section>
|
</section>
|
||||||
|
<section xml:id="Apache">
|
||||||
|
<title>Linux Apache Service</title>
|
||||||
|
<mediaobject>
|
||||||
|
<imageobject role="fo">
|
||||||
|
<imagedata fileref="../images/apache.png" scalefit="1" width="100%" contentdepth="100%"/>
|
||||||
|
</imageobject>
|
||||||
|
</mediaobject>
|
||||||
|
<informaltable rules="all" frame="border" width="100%" cellpadding="3"
|
||||||
|
cellspacing="3">
|
||||||
|
<col width="25%" align="left" style="font-weight:bold"
|
||||||
|
valign="top"/>
|
||||||
|
<col width="70%" style="padding:6px"/>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Service Name</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Enter a desired name for a service. Just A-Z,
|
||||||
|
a-z, 0-9, dash and underline are allowed.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>PHP module</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
PHP module can be installed with Apache.
|
||||||
|
Enable or disable this options via checkbox.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Key Pair</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Select SSH Key Pair from the existing to
|
||||||
|
control access to your instance.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Hostname</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Machine hostname.
|
||||||
|
If blank - random name will be used.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</informaltable>
|
||||||
|
</section>
|
||||||
|
<section xml:id="Telnet">
|
||||||
|
<title>Linux Telnet Service</title>
|
||||||
|
<mediaobject>
|
||||||
|
<imageobject role="fo">
|
||||||
|
<imagedata fileref="../images/telnet.png" scalefit="1" width="100%" contentdepth="100%"/>
|
||||||
|
</imageobject>
|
||||||
|
</mediaobject>
|
||||||
|
<informaltable rules="all" frame="border" width="100%" cellpadding="3"
|
||||||
|
cellspacing="3">
|
||||||
|
<col width="25%" align="left" style="font-weight:bold"
|
||||||
|
valign="top"/>
|
||||||
|
<col width="70%" style="padding:6px"/>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Service Name</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Enter a desired name for a service. Just A-Z,
|
||||||
|
a-z, 0-9, dash and underline are allowed.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Key Pair</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Select SSH Key Pair from the existing.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Hostname</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Machine hostname.
|
||||||
|
If blank - random name will be used.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</informaltable>
|
||||||
|
</section>
|
||||||
</section>
|
</section>
|
||||||
<section>
|
<section>
|
||||||
<title>Deploying environment</title>
|
<title>Deploying environment</title>
|
||||||
@ -752,4 +892,4 @@ initctl start murano-api
|
|||||||
This pip version problem. Need to install pip 1.4 and after that reinstall murano-client, murano-common and murano-api.
|
This pip version problem. Need to install pip 1.4 and after that reinstall murano-client, murano-common and murano-api.
|
||||||
</para>
|
</para>
|
||||||
</section>
|
</section>
|
||||||
</chapter>
|
</chapter>
|
105
src/user-guide/src/docbkx/content/images.xml
Normal file
@ -0,0 +1,105 @@
|
|||||||
|
<?xml version='1.0' encoding='UTF-8'?>
|
||||||
|
<!--
|
||||||
|
Copyright (c) 2013 Mirantis, Inc. Licensed under the Apache License,
|
||||||
|
Version 2.0 (the "License"); you may not use this file
|
||||||
|
except in compliance with the License. You may obtain a copy of the
|
||||||
|
License at http://www.apache.org/licenses/LICENSE-2.0 Unless required
|
||||||
|
by applicable law or agreed to in writing, software distributed under
|
||||||
|
the License is distributed on an "AS IS" BASIS, WITHOUT
|
||||||
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See
|
||||||
|
the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
||||||
|
-->
|
||||||
|
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
version="5.0" xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd">
|
||||||
|
<title>Images</title>
|
||||||
|
<para>
|
||||||
|
Murano uses preconfigured images for spawning instances. Image
|
||||||
|
suitable for Murano should have Murano Agent installed at least. See
|
||||||
|
<link xlink:href="http://murano-docs.github.io/latest/administrators-guide/content/ch03.html">
|
||||||
|
here</link> how to build Murano images and upload it to Glance. Since Murano
|
||||||
|
supports different operating systems it's not possible to use
|
||||||
|
one image to build every single application. To classify images
|
||||||
|
Metadata property of Glance image is used. Murano Dashboard allows to
|
||||||
|
add that property from a separate view. Navigate to the Murano tab
|
||||||
|
and go to
|
||||||
|
<filename>Images</filename>
|
||||||
|
panel.
|
||||||
|
<warning>
|
||||||
|
<para>To operate with Glance Images you need to have admin
|
||||||
|
rights!</para>
|
||||||
|
</warning>
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Images/index.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
You are browsing Glance images with correctly set
|
||||||
|
"murano_image_info" property - image metadata. From this
|
||||||
|
view you are able to:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Delete an existing image metadata with <filename>"Delete
|
||||||
|
Metadata"</filename> button (only image's property get deleted,
|
||||||
|
the image itself stays in Glance)</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Add new murano metadata to an image that is already registered
|
||||||
|
in Glance by clicking on <filename>"Mark
|
||||||
|
Image"</filename> button</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
Take a look at the "Mark Image" form:
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Images/mark_image.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
<informaltable cellpadding="3" cellspacing="3" frame="border" rules="all" width="100%">
|
||||||
|
<col align="left" style="font-weight:bold" valign="top" width="25%"/>
|
||||||
|
<col style="padding:6px" width="70%"/>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Image</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>From all images registered in Glance pick one that was created with
|
||||||
|
<link linked="http://murano-docs.github.io/latest/administrators-guide/content/ch03.html">Murano Image Builder</link>.</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Title</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>Set name for a selected image to recognize it easier during
|
||||||
|
service creation.</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Type</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
For now there are three supported types:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Windows Server 2012 - used to build Windows-based
|
||||||
|
applications</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Murano Demo - light-weight Linux Cirros image with
|
||||||
|
Murano Demo Agent</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Generic Linux - used to build Linux-based
|
||||||
|
applications</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</informaltable>
|
||||||
|
</para>
|
||||||
|
</chapter>
|
208
src/user-guide/src/docbkx/content/metadata.xml
Normal file
@ -0,0 +1,208 @@
|
|||||||
|
<?xml version='1.0' encoding='UTF-8'?>
|
||||||
|
<!--
|
||||||
|
Copyright (c) 2013 Mirantis, Inc. Licensed under the Apache License,
|
||||||
|
Version 2.0 (the &quot;License&quot;); you may not use this
|
||||||
|
file except in compliance with the License. You may obtain a copy of
|
||||||
|
the License at http://www.apache.org/licenses/LICENSE-2.0 Unless
|
||||||
|
required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an &quot;AS
|
||||||
|
IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
|
||||||
|
either express or implied. See the License for the specific language
|
||||||
|
governing permissions and limitations under the License.
|
||||||
|
-->
|
||||||
|
<chapter xmlns="http://docbook.org/ns/docbook"
|
||||||
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
version="5.0" xsi:schemaLocation="http://docbook.org/ns/docbook
|
||||||
|
http://www.docbook.org/xml/5.0/xsd/docbook.xsd
|
||||||
|
http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd">
|
||||||
|
<title>Metadata Repository</title>
|
||||||
|
<para>This chapter describes how to operate with Murano Metadata
|
||||||
|
Repository via UI. </para>
|
||||||
|
<para>
|
||||||
|
Metadata Repository is a REST API server stores all data
|
||||||
|
necessary for a service deployment. Information about service and
|
||||||
|
it's dependencies is called <emphasis>service definition</emphasis>
|
||||||
|
or <emphasis>manifest</emphasis>. Murano Conductor and Dashboard will
|
||||||
|
load these service definitions and service or application will be available
|
||||||
|
for creation. Besides manifests Murano Repository stores this types
|
||||||
|
of data:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para><emphasis>ui</emphasis> - UI definitions for Murano
|
||||||
|
dashboard</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><emphasis>workflows</emphasis> - set of rules for Murano
|
||||||
|
Conductor</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><emphasis>heat</emphasis> - templates for spawning instance
|
||||||
|
with Heat</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><emphasis>agent</emphasis> - Murano Agent templates</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><emphasis>scripts</emphasis> - Murano Execution Plans</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
In "Murano" tab go to the <filename>"Service Definitions"</filename> panel:
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/index.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
From this view you are able to perform the following actions:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Compose Service</filename> provides a form for
|
||||||
|
creating new service manifest. After this operation is complete new service
|
||||||
|
will appear in Service Definitions table and you will be allowed
|
||||||
|
to download this service definition, modify or delete it.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Upload Service</filename> provides a form for
|
||||||
|
uploading tar.gz archive with already composed service manifest and
|
||||||
|
other dependency files.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Manage Files</filename> button will redirect you to
|
||||||
|
a view where you can manipulate with all files stored in Metadata
|
||||||
|
Repository: download, delete or upload new ones.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Toggle Active</filename> button will make service
|
||||||
|
active or inactive depending on the current state.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Modify Service</filename> gives you opportunity to
|
||||||
|
modify attributes of service definition.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Manage Service</filename> redirects you to a view
|
||||||
|
with information about selected service and service files for all
|
||||||
|
data types that Murano Repository supports. From here you can
|
||||||
|
upload file and add it to service dependency in one click.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Download Service</filename> saves archive with all
|
||||||
|
files used by specified service.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para><filename>Delete Service</filename> removes service manifest
|
||||||
|
and all dependencies that are not used by other services from
|
||||||
|
Murano Repository server.</para>
|
||||||
|
<para/>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
<section>
|
||||||
|
<title>
|
||||||
|
Compose Service
|
||||||
|
</title>
|
||||||
|
<para>
|
||||||
|
Let's review service creation in details.
|
||||||
|
After clicking on "Compose Service" button from "Service Definitions" view you'll see the following form:
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/compose_service1.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
It consists of several tabs. On the first tab you need to fill up general information about service.
|
||||||
|
On the next tab select one of the UI definitions you want to use for this service.
|
||||||
|
You can upload new definition in the <emphasis><link linked="manage_files">Manage Files</link></emphasis> view.
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/compose_service2.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
All other tabs correspond to data types. Navigate to desired tab and select files for service dependency.
|
||||||
|
The only mandatory requirement for a new service is a UI definition file - if a service doesn't reference any, it won't be shown in the
|
||||||
|
<filename>"Create Service"</filename> form. All other tabs refer to a files required for a service's deployment phase.
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/compose_service3.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
<section xml:id="manage_files">
|
||||||
|
<title>Manage Files</title>
|
||||||
|
<para>
|
||||||
|
Murano Repository table shows all files stored in Metadata
|
||||||
|
Repository. Files are divided into categories by data types.
|
||||||
|
Button name of each category also contains the number of files in that category.
|
||||||
|
Click on the type name to browse all files of this type.
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/manage_files.png " scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
The following actions are available:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Download file,</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Delete file,</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Upload file.</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
To upload file to repository you need to fill up this form:
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/manage_files_upload.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
<informaltable cellpadding="3" cellspacing="3" frame="border" rules="all" width="100%">
|
||||||
|
<col align="left" style="font-weight:bold" valign="top" width="25%"/>
|
||||||
|
<col style="padding:6px" width="70%"/>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>Murano Repository File</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>Select file for uploading. It should be not bigger than 5Mb.</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td style="font-weight:bold">
|
||||||
|
<para>File Type</para>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<para>
|
||||||
|
Select one of supported type. It will be loaded directly to a directory that stores corresponding file types.
|
||||||
|
</para>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</informaltable>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
<section>
|
||||||
|
<title>
|
||||||
|
Manage Service
|
||||||
|
</title>
|
||||||
|
<para>
|
||||||
|
Manage Service view displays general information about service and list of file dependency grouped by a separate tables.
|
||||||
|
<mediaobject><imageobject role="fo">
|
||||||
|
<imagedata contentdepth="100%" fileref="../images/Metadata/manage_service.png" scalefit="1" width="100%"/>
|
||||||
|
</imageobject></mediaobject>
|
||||||
|
In the following view these actions are available:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
View service detail information.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Download File.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
Delete file.
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Upload file of the exact type by pressing the <File type>" button in the appropriate table.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
</chapter>
|
@ -24,32 +24,52 @@
|
|||||||
<title>How can I use Murano Service?</title>
|
<title>How can I use Murano Service?</title>
|
||||||
<para>
|
<para>
|
||||||
Murano is intended to get opportunity for non-experienced
|
Murano is intended to get opportunity for non-experienced
|
||||||
users to deploy reliable Windows-based environments extremely simple.
|
users to deploy different kinds of applications extremely simple.
|
||||||
This document describes process of creation virtual Windows Environment with different services.
|
To use Murano you should be familiar with Openstack.
|
||||||
|
Murano Dashboard is just a plugin to Openstack dashboard - Horizon.
|
||||||
|
Please visit horizon user guide first to see how dashboard is organized and how to login into it.
|
||||||
|
This document describes Murano Dashboard usage in detail.
|
||||||
</para>
|
</para>
|
||||||
<section>
|
<section>
|
||||||
<title>Document change history</title>
|
<title>Document change history</title>
|
||||||
<para>The following table describes the most recent changes:</para>
|
<para>The following table describes the most recent changes:</para>
|
||||||
<informaltable rules="all">
|
<informaltable rules="all">
|
||||||
<thead>
|
<tgroup cols='2'>
|
||||||
<tr>
|
<colspec colname="col1" colnum="1" colwidth="1*"/>
|
||||||
<td align="center" colspan="1">Revision Date</td>
|
<colspec colname="col2" colnum="2" colwidth="1*"/>
|
||||||
<td align="center" colspan="4">Summary of Changes</td>
|
<thead>
|
||||||
</tr>
|
<row>
|
||||||
</thead>
|
<entry>Revision Date</entry>
|
||||||
<tbody>
|
<entry>Summary of Changes</entry>
|
||||||
<tr>
|
</row>
|
||||||
<td colspan="1" align="center">September. 4, 2013</td>
|
</thead>
|
||||||
<td colspan="4">
|
<tbody>
|
||||||
<itemizedlist>
|
<row>
|
||||||
<listitem>
|
<entry>
|
||||||
<para>Initial document creation.</para>
|
September. 4, 2013
|
||||||
</listitem>
|
</entry>
|
||||||
</itemizedlist>
|
<entry>
|
||||||
</td>
|
<itemizedlist spacing="compact">
|
||||||
</tr>
|
<listitem>
|
||||||
</tbody>
|
<para>Update for Release-0.2</para>
|
||||||
</informaltable>
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>
|
||||||
|
December. 9, 2013
|
||||||
|
</entry>
|
||||||
|
<entry>
|
||||||
|
<itemizedlist spacing="compact">
|
||||||
|
<listitem>
|
||||||
|
<para>Update for Release-0.4</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</entry>
|
||||||
|
</row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</informaltable>
|
||||||
</section>
|
</section>
|
||||||
|
</chapter>
|
||||||
</chapter>
|
|
||||||
|
BIN
src/user-guide/src/docbkx/images/Images/Image 13.png
Normal file
After Width: | Height: | Size: 33 KiB |
BIN
src/user-guide/src/docbkx/images/Images/index.png
Normal file
After Width: | Height: | Size: 30 KiB |
BIN
src/user-guide/src/docbkx/images/Images/mark_image.png
Normal file
After Width: | Height: | Size: 18 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/compose_service1.png
Normal file
After Width: | Height: | Size: 20 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/compose_service2.png
Normal file
After Width: | Height: | Size: 23 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/compose_service3.png
Normal file
After Width: | Height: | Size: 20 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/index.png
Normal file
After Width: | Height: | Size: 71 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/manage_files.png
Normal file
After Width: | Height: | Size: 67 KiB |
After Width: | Height: | Size: 25 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/manage_service.png
Normal file
After Width: | Height: | Size: 92 KiB |
BIN
src/user-guide/src/docbkx/images/Metadata/upload_tofile.png
Normal file
After Width: | Height: | Size: 9.7 KiB |
BIN
src/user-guide/src/docbkx/images/apache.png
Normal file
After Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 45 KiB |
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 21 KiB |
Before Width: | Height: | Size: 34 KiB After Width: | Height: | Size: 27 KiB |
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 21 KiB |
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 15 KiB |
BIN
src/user-guide/src/docbkx/images/telnet.png
Normal file
After Width: | Height: | Size: 29 KiB |
@ -24,7 +24,7 @@
|
|||||||
version="5.0">
|
version="5.0">
|
||||||
<title>Murano User Guide</title>
|
<title>Murano User Guide</title>
|
||||||
<info>
|
<info>
|
||||||
<releaseinfo>v0.3</releaseinfo>
|
<releaseinfo>v0.4</releaseinfo>
|
||||||
<legalnotice role="apache2">
|
<legalnotice role="apache2">
|
||||||
<annotation>
|
<annotation>
|
||||||
<remark>Copyright details are filled in by the template. Change
|
<remark>Copyright details are filled in by the template. Change
|
||||||
@ -35,5 +35,7 @@
|
|||||||
</legalnotice>
|
</legalnotice>
|
||||||
</info>
|
</info>
|
||||||
<xi:include href="./content/overview.xml" xlink:title="Overview" />
|
<xi:include href="./content/overview.xml" xlink:title="Overview" />
|
||||||
<xi:include href="./content/murano-dashboard.xml" xlink:title="Murano Dashboard" />
|
<xi:include href="./content/images.xml" xlink:title="Murano Images" />
|
||||||
|
<xi:include href="./content/environments.xml" xlink:title="Murano Environments"/>
|
||||||
|
<xi:include href="./content/metadata.xml" xlink:title="Murano Metadata"/>
|
||||||
</book>
|
</book>
|
||||||
|