incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject git commit: refs/heads/master - resize volume
Date Fri, 22 Feb 2013 15:08:36 GMT
Updated Branches:
  refs/heads/master 667aa1751 -> 6250c8591

resize volume

Signed-off-by: radhikap <>
Signed-off-by: Joe Brockmeier <>


Branch: refs/heads/master
Commit: 6250c859120c4959e82ad60ae77a8736042fddb5
Parents: 667aa17
Author: radhikap <>
Authored: Wed Feb 20 18:01:24 2013 +0530
Committer: Joe Brockmeier <>
Committed: Fri Feb 22 09:08:09 2013 -0600

 docs/en-US/images/resize-volume-icon.png |  Bin 0 -> 857 bytes
 docs/en-US/images/resize-volume.png      |  Bin 0 -> 11995 bytes
 docs/en-US/resizing-volumes.xml          |   92 ++++++++++++++++++++----
 3 files changed, 76 insertions(+), 16 deletions(-)
diff --git a/docs/en-US/images/resize-volume-icon.png b/docs/en-US/images/resize-volume-icon.png
new file mode 100644
index 0000000..4849902
Binary files /dev/null and b/docs/en-US/images/resize-volume-icon.png differ
diff --git a/docs/en-US/images/resize-volume.png b/docs/en-US/images/resize-volume.png
new file mode 100644
index 0000000..6195623
Binary files /dev/null and b/docs/en-US/images/resize-volume.png differ
diff --git a/docs/en-US/resizing-volumes.xml b/docs/en-US/resizing-volumes.xml
index 471411d..42b584b 100644
--- a/docs/en-US/resizing-volumes.xml
+++ b/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
  Unless required by applicable law or agreed to in writing,
  software distributed under the License is distributed on an
@@ -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=""> VHD Resizer</ulink>),
while not officially supported by 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="">
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
+    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
+        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>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>

View raw message