cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject git commit: updated refs/heads/master to 2cc1391
Date Fri, 09 Aug 2013 06:09:18 GMT
Updated Branches:
  refs/heads/master 30a08e5f9 -> 2cc13918a

CLOUDSTACK-1682. DOC. Document reset root volume on VM reboot.


Branch: refs/heads/master
Commit: 2cc13918aca3e2bfd64040c4eaf5a1e4880e8037
Parents: 30a08e5
Author: Jessica <>
Authored: Thu Aug 8 23:08:51 2013 -0700
Committer: Jessica <>
Committed: Thu Aug 8 23:08:51 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(+)
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 @@
             <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
                         to all domains. Choose No to limit the scope to a subdomain; &PRODUCT;
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" ""
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+<!-- 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
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ 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>
\ No newline at end of file
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=""/>
   <xi:include href="append-displayname-vms.xml" xmlns:xi=""/>
   <xi:include href="changing-service-offering-for-vm.xml" xmlns:xi=""/>
+  <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
+      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=""/>
   <xi:include href="deleting-vms.xml" xmlns:xi=""/>
   <xi:include href="working-with-iso.xml" xmlns:xi=""/>
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=""/>
   <xi:include href="vm-storage-migration.xml" xmlns:xi=""/>
   <xi:include href="resizing-volumes.xml" xmlns:xi=""/>
+  <xi:include href="reset-volume-on-reboot.xml" xmlns:xi=""/>
   <xi:include href="volume-deletion-garbage-collection.xml"

View raw message