Skip to content

Commit 6250c85

Browse files
radhikapjzb
radhikap
authored and
jzb
committed
resize volume
Signed-off-by: radhikap <radhika.puthiyetath@citrix.com> Signed-off-by: Joe Brockmeier <jzb@zonker.net>
1 parent 667aa17 commit 6250c85

3 files changed

Lines changed: 76 additions & 16 deletions

File tree

‎docs/en-US/images/resize-volume-icon.png‎

857 Bytes
Loading

‎docs/en-US/images/resize-volume.png‎

11.7 KB
Loading

‎docs/en-US/resizing-volumes.xml‎

Lines changed: 76 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -11,28 +11,88 @@
1111
to you under the Apache License, Version 2.0 (the
1212
"License"); you may not use this file except in compliance
1313
with the License. You may obtain a copy of the License at
14-
15-
http://www.apache.org/licenses/LICENSE-2.0
16-
14+
http://www.apache.org/licenses/LICENSE-2.0
1715
Unless required by applicable law or agreed to in writing,
1816
software distributed under the License is distributed on an
1917
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
2018
KIND, either express or implied. See the License for the
2119
specific language governing permissions and limitations
2220
under the License.
2321
-->
24-
2522
<section id="resizing-volumes">
26-
<title>Resizing Volumes</title>
27-
<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>
28-
<orderedlist>
29-
<listitem><para>Get the VHD from the secondary storage.</para></listitem>
30-
<listitem><para>Import it into VHD Resizer.</para></listitem>
31-
<listitem><para>Resize the VHD.</para></listitem>
32-
<listitem><para>Upload the new VHD.</para></listitem>
33-
<listitem><para>Create a new VM.</para></listitem>
34-
<listitem><para>Take a snapshot, then create a new template from that snapshot.</para>
35-
<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>
36-
</orderedlist>
23+
<title>Resizing Volumes</title>
24+
<para>&PRODUCT; provides the ability to resize data disks; &PRODUCT; controls volume size by using
25+
disk offerings. This provides &PRODUCT; administrators with the flexibility to choose how much
26+
space they want to make available to the end users. Volumes within the disk offerings with the
27+
same storage tag can be resized. For example, if you only want to offer 10, 50, and 100 GB
28+
offerings, the allowed resize should stay within those limits. That implies if you define a 10
29+
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
30+
GB. If you create a custom-sized disk offering, then you have the option to resize the volume by
31+
specifying a new, larger size. </para>
32+
<para>Additionally, using the resizeVolume API, a data volume can be moved from a static disk
33+
offering to a custom disk offering with the size specified. This functionality allows those who
34+
might be billing by certain volume sizes or disk offerings to stick to that model, while
35+
providing the flexibility to migrate to whatever custom size necessary. </para>
36+
<para>This feature is supported on KVM, XenServer, and VMware hosts. However, shrinking volumes is
37+
not supported on VMware hosts.</para>
38+
<para>Before you try to resize a volume, consider the following:</para>
39+
<itemizedlist>
40+
<listitem>
41+
<para>The VMs associated with the volume are stopped.</para>
42+
</listitem>
43+
<listitem>
44+
<para>The data disks associated with the volume are removed.</para>
45+
</listitem>
46+
<listitem>
47+
<para>When a volume is shrunk, the disk associated with it is simply truncated, and doing so
48+
would put its content at risk of data loss. Therefore, resize any partitions or file systems
49+
before you shrink a data disk so that all the data is moved off from that disk.</para>
50+
</listitem>
51+
</itemizedlist>
52+
<para>To resize a volume:</para>
53+
<orderedlist>
54+
<listitem>
55+
<para>Log in to the &PRODUCT; UI as a user or admin.</para>
56+
</listitem>
57+
<listitem>
58+
<para>In the left navigation bar, click Storage.</para>
59+
</listitem>
60+
<listitem>
61+
<para>In Select View, choose Volumes.</para>
62+
</listitem>
63+
<listitem>
64+
<para>Select the volume name in the Volumes list, then click the Resize Volume button <inlinemediaobject>
65+
<imageobject>
66+
<imagedata fileref="./images/resize-volume-icon.png"/>
67+
</imageobject>
68+
<textobject>
69+
<phrase>resize-volume-icon.png: button to display the resize volume option.</phrase>
70+
</textobject>
71+
</inlinemediaobject></para>
72+
</listitem>
73+
<listitem>
74+
<para>In the Resize Volume pop-up, choose desired characteristics for the storage.</para>
75+
<mediaobject>
76+
<imageobject>
77+
<imagedata fileref="./images/resize-volume.png"/>
78+
</imageobject>
79+
<textobject>
80+
<phrase>resize-volume.png: option to resize a volume.</phrase>
81+
</textobject>
82+
</mediaobject>
83+
<orderedlist numeration="loweralpha">
84+
<listitem>
85+
<para>If you select Custom Disk, specify a custom size.</para>
86+
</listitem>
87+
<listitem>
88+
<para>Click Shrink OK to confirm that you are reducing the size of a volume. </para>
89+
<para>This parameter protects against inadvertent shrinking of a disk, which might lead to
90+
the risk of data loss. You must sign off that you know what you are doing.</para>
91+
</listitem>
92+
</orderedlist>
93+
</listitem>
94+
<listitem>
95+
<para>Click OK.</para>
96+
</listitem>
97+
</orderedlist>
3798
</section>
38-

0 commit comments

Comments
 (0)