You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jz...@apache.org on 2013/02/22 15:55:08 UTC
git commit: refs/heads/4.1 - resize volume
Updated Branches:
refs/heads/4.1 7da92314a -> f0fb2e0f7
resize volume
Signed-off-by: radhikap <ra...@citrix.com>
Signed-off-by: Joe Brockmeier <jz...@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 <ra...@citrix.com>
Authored: Wed Feb 20 18:01:24 2013 +0530
Committer: Joe Brockmeier <jz...@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>
-