resize volume

Signed-off-by: radhikap <radhika.puthiyetath@citrix.com> Signed-off-by: Joe Brockmeier <jzb@zonker.net>
wolfhml · Feb 22, 2013 · 6250c85 · 6250c85
1 parent 667aa17
commit 6250c85
Show file tree

Hide file tree

Showing 3 changed files with 76 additions and 16 deletions.
diff --git a/docs/en-US/images/resize-volume-icon.png b/docs/en-US/images/resize-volume-icon.png
diff --git a/docs/en-US/images/resize-volume.png b/docs/en-US/images/resize-volume.png
diff --git a/docs/en-US/resizing-volumes.xml b/docs/en-US/resizing-volumes.xml
@@ -11,28 +11,88 @@
  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
- 
+ 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="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>
-        <orderedlist>
-            <listitem><para>Get the VHD from the secondary storage.</para></listitem>
-            <listitem><para>Import it into VHD Resizer.</para></listitem>
-            <listitem><para>Resize the VHD.</para></listitem>
-            <listitem><para>Upload the new VHD.</para></listitem>
-            <listitem><para>Create a new VM.</para></listitem>
-            <listitem><para>Take a snapshot, then create a new template from that snapshot.</para>
-                <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>
-        </orderedlist>
+  <title>Resizing Volumes</title>
+  <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>Log in to the &PRODUCT; UI as a user or admin.</para>
+    </listitem>
+    <listitem>
+      <para>In the left navigation bar, click Storage.</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>
-