resize volume

Signed-off-by: radhikap <radhika.puthiyetath@citrix.com>
Signed-off-by: Joe Brockmeier <jzb@zonker.net>

docs/en-US/resizing-volumes.xml

@@ -11,9 +11,7 @@
  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
@@ -21,18 +19,80 @@
  specific language governing permissions and limitations
  under the License.
 -->
-
 <section id="resizing-volumes">
   <title>Resizing Volumes</title>
-        <para>&PRODUCT; does not provide the ability to resize root disks or data disks; the disk size is fixed based on the template used to create the VM. However, the tool <ulink url="http://vmtoolkit.com/files/folders/converters/entry87.aspx/"> VHD Resizer</ulink>), while not officially supported by Cloud.com or Citrix, might provide a workaround. To increase disk size with VHD Resizer:</para>
+  <para>&PRODUCT; provides the ability to resize data disks; &PRODUCT; controls volume size by using
+    disk offerings. This provides &PRODUCT; administrators with the flexibility to choose how much
+    space they want to make available to the end users. Volumes within the disk offerings with the
+    same storage tag can be resized. For example, if you only want to offer 10, 50, and 100 GB
+    offerings, the allowed resize should stay within those limits. That implies if you define a 10
+    GB, a 50 GB and a 100 GB disk offerings, a user can upgrade from 10 GB to 50 GB, or 50 GB to 100
+    GB. If you create a custom-sized disk offering, then you have the option to resize the volume by
+    specifying a new, larger size. </para>
+  <para>Additionally, using the resizeVolume API, a data volume can be moved from a static disk
+    offering to a custom disk offering with the size specified. This functionality allows those who
+    might be billing by certain volume sizes or disk offerings to stick to that model, while
+    providing the flexibility to migrate to whatever custom size necessary. </para>
+  <para>This feature is supported on KVM, XenServer, and VMware hosts. However, shrinking volumes is
+    not supported on VMware hosts.</para>
+  <para>Before you try to resize a volume, consider the following:</para>
+  <itemizedlist>
+    <listitem>
+      <para>The VMs associated with the volume are stopped.</para>
+    </listitem>
+    <listitem>
+      <para>The data disks associated with the volume are removed.</para>
+    </listitem>
+    <listitem>
+      <para>When a volume is shrunk, the disk associated with it is simply truncated, and doing so
+        would put its content at risk of data loss. Therefore, resize any partitions or file systems
+        before you shrink a data disk so that all the data is moved off from that disk.</para>
+    </listitem>
+  </itemizedlist>
+  <para>To resize a volume:</para>
   <orderedlist>
-            <listitem><para>Get the VHD from the secondary storage.</para></listitem>
+    <listitem>
-            <listitem><para>Import it into VHD Resizer.</para></listitem>
+      <para>Log in to the &PRODUCT; UI as a user or admin.</para>
-            <listitem><para>Resize the VHD.</para></listitem>
+    </listitem>
-            <listitem><para>Upload the new VHD.</para></listitem>
+    <listitem>
-            <listitem><para>Create a new VM.</para></listitem>
+      <para>In the left navigation bar, click Storage.</para>
-            <listitem><para>Take a snapshot, then create a new template from that snapshot.</para>
+    </listitem>
-                <para>For more information, see <ulink url="http://support.citrix.com/article/CTX118608/"> How to Resize a Provisioning Server 5 Virtual Disk </ulink> at the Citrix Knowledge Center </para></listitem>
+    <listitem>
+      <para>In Select View, choose Volumes.</para>
+    </listitem>
+    <listitem>
+      <para>Select the volume name in the Volumes list, then click the Resize Volume button <inlinemediaobject>
+          <imageobject>
+            <imagedata fileref="./images/resize-volume-icon.png"/>
+          </imageobject>
+          <textobject>
+            <phrase>resize-volume-icon.png: button to display the resize volume option.</phrase>
+          </textobject>
+        </inlinemediaobject></para>
+    </listitem>
+    <listitem>
+      <para>In the Resize Volume pop-up, choose desired characteristics for the storage.</para>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="./images/resize-volume.png"/>
+        </imageobject>
+        <textobject>
+          <phrase>resize-volume.png: option to resize a volume.</phrase>
+        </textobject>
+      </mediaobject>
+      <orderedlist numeration="loweralpha">
+        <listitem>
+          <para>If you select Custom Disk, specify a custom size.</para>
+        </listitem>
+        <listitem>
+          <para>Click Shrink OK to confirm that you are reducing the size of a volume. </para>
+          <para>This parameter protects against inadvertent shrinking of a disk, which might lead to
+            the risk of data loss. You must sign off that you know what you are doing.</para>
+        </listitem>
+      </orderedlist>
+    </listitem>
+    <listitem>
+      <para>Click OK.</para>
+    </listitem>
   </orderedlist>
 </section>
-