Updates to the 'Launch a stack' section

Updated the following:
- Included new procedure to 'Manage a stack'.
- New steps to select the template and environment sources for the stack.
Partial-Bug: #1307860

Change-Id: I5fab0587ce7a81e5092f9e089b4cbb2197c7b8d0
This commit is contained in:
Deepti Navale 2014-05-07 14:28:28 +10:00
parent 6ad68cfa97
commit 740f1c2bce

View File

@ -4,7 +4,7 @@
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="dashboard_stacks">
<title>Launch and manage stacks</title>
<?dbhtml stop-chunking?>
<para>OpenStack Orchestration is a service that you can use to
orchestrate multiple composite cloud applications. This
service supports use of both the Amazon Web Services (AWS)
@ -30,55 +30,77 @@
<title>Launch a stack</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and
click <guibutton>Stacks</guibutton> in the
<guilabel>Orchestration</guilabel> category on
the <guilabel>Projects</guilabel> tab.</para>
<para>Log in to the dashboard, choose a project, and click
<guibutton>Stacks</guibutton> in the
<guilabel>Orchestration</guilabel> category on the
<guilabel>Projects</guilabel> tab.</para>
</step>
<step>
<para>Click <guibutton>Launch
Stack</guibutton>.</para>
<para>Click <guibutton>Launch Stack</guibutton>.</para>
<para/>
</step>
<step>
<para>In the Select Template dialog box, choose the
source of the template from the list.</para>
<para>In the <guilabel>Select Template</guilabel> dialog box,
specify the following values.</para>
<informaltable rules="all" width="75%">
<col width="30%"/>
<col width="70%"/>
<tbody>
<tr>
<td><para><guilabel>Template Source</guilabel></para></td>
<td><para>Choose the source of the template from the list.</para></td>
</tr>
<tr>
<td><para><guilabel>Template URL/File/Data</guilabel></para></td>
<td><para>Depending on the source that you selected, enter
the URL, browse to the file location, or directly include
the template.</para></td>
</tr>
<tr>
<td><para><guilabel>Environment Source</guilabel></para></td>
<td><para>Choose the source of the environment from the list.
The environment files contain additional settings for
the stack.</para></td>
</tr>
<tr>
<td><para><guilabel>Environment URL/File/Data</guilabel></para></td>
<td><para>Depending on the source that you selected, enter
the URL, browse to the file location, or directly include
the environment.</para></td>
</tr>
</tbody>
</informaltable>
</step>
<step>
<para>Depending on the source that you selected, enter
the URL, browse to the file location, or directly
include the template.</para>
<para>Click <guibutton>Next</guibutton>.
</para>
</step>
<step>
<para>In the Launch Stack dialog box,
specify the following values.</para>
<para>In the <guilabel>Launch Stack</guilabel> dialog box, specify
the following values.</para>
<informaltable rules="all" width="75%">
<col width="30%"/>
<col width="70%"/>
<tbody>
<tr>
<td><para><guilabel>Stack
Name</guilabel></para></td>
<td><para><guilabel>Stack Name</guilabel></para></td>
<td><para>Enter a name to identify the stack.</para></td>
</tr>
<tr>
<td><para><guilabel>Creation Timeout
(minutes)</guilabel></para></td>
<td><para>Specify the number of minutes that can elapse before the launch
of the stack times out.</para></td>
<td><para><guilabel>Creation Timeout (minutes)</guilabel></para></td>
<td><para>Specify the number of minutes that can
elapse before the launch of the stack times out.</para></td>
</tr>
<tr>
<td><para><guilabel>Rollback On
Failure</guilabel></para></td>
<td><para>Select this check box if you want if you want the service to
roll back changes if the stack
fails to launch.</para></td>
<td><para><guilabel>Rollback On Failure</guilabel></para></td>
<td><para>Select this check box if you want if you
want the service to roll back changes if the stack
fails to launch.</para></td>
</tr>
<tr>
<td><para><guilabel>Password for user
"demo"</guilabel></para></td>
<td><para>Specify the password that the default user will use when the
stack is created.</para></td>
<td><para><guilabel>Password for user "demo"</guilabel></para></td>
<td><para>Specify the password that the default user
uses when the stack is created.</para></td>
</tr>
<tr>
<td><para><guilabel>DBUsername</guilabel></para></td>
@ -86,8 +108,8 @@
</tr>
<tr>
<td><para><guilabel>LinuxDistribution</guilabel></para></td>
<td><para>Specify the Linux distribution that will be used in the
stack.</para></td>
<td><para>Specify the Linux distribution that is
used in the stack.</para></td>
</tr>
<tr>
<td><para><guilabel>DBRootPassword</guilabel></para></td>
@ -95,8 +117,8 @@
</tr>
<tr>
<td><para><guilabel>KeyName</guilabel></para></td>
<td><para>Specify the name of the key pair that will be used to log into
the stack.</para></td>
<td><para>Specify the name of the key pair to use to
log in to the stack.</para></td>
</tr>
<tr>
<td><para><guilabel>DBName</guilabel></para></td>
@ -118,12 +140,11 @@
stack.</para>
</step>
<step>
<para>The dashboard shows the stack on the
<guilabel>Stacks</guilabel> tab.</para>
<para>The <guilabel>Stacks</guilabel> tab shows the stack.</para>
</step>
</procedure>
<para>After the stack is created, click on the stack name to
see the following details:</para>
<para>After the stack is created, click on the stack name to see the
following details:</para>
<variablelist>
<varlistentry>
<term><guilabel>Topology</guilabel></term>
@ -134,8 +155,7 @@
<varlistentry>
<term><guilabel>Overview</guilabel></term>
<listitem>
<para>The parameters and details of the
stack.</para>
<para>The parameters and details of the stack.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -152,10 +172,38 @@
</varlistentry>
</variablelist>
</section>
<section xml:id="dashboard_manage_stacks">
<title>Manage a stack</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and
click <guilabel>Stacks</guilabel>.</para>
</step>
<step>
<para>Select the stack that you want to update.</para>
</step>
<step>
<para>Click <guibutton>Change Stack Template</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Select Template</guilabel> dialog box,
select the new template source or environment source.</para>
</step>
<step>
<para>Click <guibutton>Next</guibutton>.</para>
<para>The <guilabel>Update Stack Parameters</guilabel> window appears.</para>
</step>
<step>
<para>Enter new values for any parameters that you want to update.</para>
</step>
<step>
<para>Click <guibutton>Update</guibutton>.</para>
</step>
</procedure>
</section>
<section xml:id="dashboard_delete_stacks">
<title>Delete a stack</title>
<para>When you delete a stack, you cannot undo this
action.</para>
<para>When you delete a stack, you cannot undo this action.</para>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and