resize volume Signed-off-by: radhikap <[email protected]> Signed-off-by: Joe Brockmeier <[email protected]>
Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/6250c859 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/6250c859 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/6250c859 Branch: refs/heads/cisco-vnmc-api-integration Commit: 6250c859120c4959e82ad60ae77a8736042fddb5 Parents: 667aa17 Author: radhikap <[email protected]> Authored: Wed Feb 20 18:01:24 2013 +0530 Committer: Joe Brockmeier <[email protected]> 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(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/6250c859/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/6250c859/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/6250c859/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> -
