incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject git commit: refs/heads/4.1 - resize volume
Date Fri, 22 Feb 2013 14:55:08 GMT
Updated Branches:
  refs/heads/4.1 7da92314a -> f0fb2e0f7


resize volume

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


Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/f0fb2e0f
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/f0fb2e0f
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/f0fb2e0f

Branch: refs/heads/4.1
Commit: f0fb2e0f7dd9eff5021769182f7cada0f1e377e5
Parents: 7da9231
Author: radhikap <radhika.puthiyetath@citrix.com>
Authored: Wed Feb 20 18:01:24 2013 +0530
Committer: Joe Brockmeier <jzb@zonker.net>
Committed: Fri Feb 22 08:52:05 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(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/f0fb2e0f/docs/en-US/images/resize-volume-icon.png
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/f0fb2e0f/docs/en-US/images/resize-volume.png
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/f0fb2e0f/docs/en-US/resizing-volumes.xml
----------------------------------------------------------------------
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
- 
-   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
@@ -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>
-        <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>
-


Mime
View raw message