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

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;

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>

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"/>

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>