You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jt...@apache.org on 2013/08/09 08:13:34 UTC
git commit: updated refs/heads/4.2 to 26f1eab
Updated Branches:
refs/heads/4.2 8bdd69251 -> 26f1eab32
CLOUDSTACK-1682. DOC. Document reset root volume on VM reboot.
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/26f1eab3
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/26f1eab3
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/26f1eab3
Branch: refs/heads/4.2
Commit: 26f1eab323672d54f2a7dfa5da89c779c9d8f5c2
Parents: 8bdd692
Author: Jessica <je...@citrix.com>
Authored: Thu Aug 8 23:13:12 2013 -0700
Committer: Jessica <je...@citrix.com>
Committed: Thu Aug 8 23:13:12 2013 -0700
----------------------------------------------------------------------
docs/en-US/creating-compute-offerings.xml | 4 ++++
docs/en-US/reset-volume-on-reboot.xml | 32 ++++++++++++++++++++++++++
docs/en-US/virtual-machines.xml | 5 ++++
docs/en-US/working-with-volumes.xml | 1 +
4 files changed, 42 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/26f1eab3/docs/en-US/creating-compute-offerings.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/creating-compute-offerings.xml b/docs/en-US/creating-compute-offerings.xml
index 31f9741..5c5033a 100644
--- a/docs/en-US/creating-compute-offerings.xml
+++ b/docs/en-US/creating-compute-offerings.xml
@@ -54,6 +54,10 @@
hosts</para></listitem>
<listitem><para><emphasis role="bold">CPU cap</emphasis>: Whether to limit the level of CPU usage even if
spare capacity is available.</para></listitem>
+ <listitem><para><emphasis role="bold">isVolatile</emphasis>: If checked, VMs created from this service
+ offering will have their root disks reset upon reboot. This is useful for
+ secure environments that need a fresh start on every boot and for desktops
+ that should not retain state. </para></listitem>
<listitem><para><emphasis role="bold">Public</emphasis>: Indicate whether the service offering should be
available all domains or only some domains. Choose Yes to make it available
to all domains. Choose No to limit the scope to a subdomain; &PRODUCT;
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/26f1eab3/docs/en-US/reset-volume-on-reboot.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/reset-volume-on-reboot.xml b/docs/en-US/reset-volume-on-reboot.xml
new file mode 100644
index 0000000..4214f67
--- /dev/null
+++ b/docs/en-US/reset-volume-on-reboot.xml
@@ -0,0 +1,32 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you 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.
+-->
+<section id="reset-vm-reboot">
+ <!-- CLOUDSTACK-745 -->
+ <title>Reset VM to New Root Disk on Reboot</title>
+ <para>You can specify that you want to discard the root disk and create a new one whenever a given
+ VM is rebooted. This is useful for secure environments that need a fresh start on every boot and
+ for desktops that should not retain state. The IP address of the VM will not change due to this
+ operation.</para>
+ <para><emphasis role="bold">To enable root disk reset on VM reboot:</emphasis></para>
+ <para>When creating a new service offering, set the parameter Volatile VM to True. VMs created
+ from this service offering will have their disks reset upon reboot. </para>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/26f1eab3/docs/en-US/virtual-machines.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/virtual-machines.xml b/docs/en-US/virtual-machines.xml
index 802e8e1..0effb97 100644
--- a/docs/en-US/virtual-machines.xml
+++ b/docs/en-US/virtual-machines.xml
@@ -30,6 +30,11 @@
<xi:include href="changing-vm-name-os-group.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="append-displayname-vms.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="changing-service-offering-for-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <section id="reset-volume-on-reboot-vm">
+ <title>Resetting the Virtual Machine Root Volume on Reboot</title>
+ <para>For secure environments, and to ensure that VM state is not persisted across reboots,
+ you can reset the root disk. For more information, see <xref linkend="reset-vm-reboot"/>.</para>
+ </section>
<xi:include href="manual-live-migration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="deleting-vms.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="working-with-iso.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/26f1eab3/docs/en-US/working-with-volumes.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/working-with-volumes.xml b/docs/en-US/working-with-volumes.xml
index 6832cff..5de5e6c 100644
--- a/docs/en-US/working-with-volumes.xml
+++ b/docs/en-US/working-with-volumes.xml
@@ -47,6 +47,7 @@
<xi:include href="detach-move-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="vm-storage-migration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="resizing-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="reset-volume-on-reboot.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="volume-deletion-garbage-collection.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</section>