You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jt...@apache.org on 2013/08/09 02:15:07 UTC
git commit: updated refs/heads/4.2 to a5ca05f
Updated Branches:
refs/heads/4.2 2be315b9d -> a5ca05fde
CLOUDSTACK-2402. DOC. Document volume snapshot enhancements for VMware.
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/a5ca05fd
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/a5ca05fd
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/a5ca05fd
Branch: refs/heads/4.2
Commit: a5ca05fdeaeb9ccc21b153698b02d33004f6e187
Parents: 2be315b
Author: Jessica <je...@citrix.com>
Authored: Thu Aug 8 17:14:45 2013 -0700
Committer: Jessica <je...@citrix.com>
Committed: Thu Aug 8 17:14:57 2013 -0700
----------------------------------------------------------------------
docs/en-US/snapshot-performance-vmware.xml | 39 +++++++++++++++++++++++++
docs/en-US/working-with-snapshots.xml | 3 +-
2 files changed, 41 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/a5ca05fd/docs/en-US/snapshot-performance-vmware.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/snapshot-performance-vmware.xml b/docs/en-US/snapshot-performance-vmware.xml
new file mode 100644
index 0000000..9ccb235
--- /dev/null
+++ b/docs/en-US/snapshot-performance-vmware.xml
@@ -0,0 +1,39 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ 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
+
+ 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
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="snapshot-performance-vmware">
+ <title>VMware Volume Snapshot Performance</title>
+ <para>When you take a snapshot of a data volume on VMware, &PRODUCT; uses an
+ efficient storage technique to improve performance.</para>
+ <para>A snapshot is not immediately exported from vCenter to a mounted NFS
+ share and packaged into an OVA file format. This operation would consume time and resources.
+ Instead, the original file formats (e.g., VMDK) provided by vCenter are
+ retained. An OVA file will only be created as needed, on demand. To generate the OVA,
+ &PRODUCT; uses information in a properties file (*.ova.meta) which it stored along with
+ the original snapshot data. </para>
+ <note><para>For upgrading customers: This process applies only to newly created snapshots after upgrade to &PRODUCT;
+ 4.2. Snapshots that have already been taken and stored in OVA format will continue to
+ exist in that format, and will continue to work as expected.</para></note>
+ <para/>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/a5ca05fd/docs/en-US/working-with-snapshots.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/working-with-snapshots.xml b/docs/en-US/working-with-snapshots.xml
index b984439..2d8cada 100644
--- a/docs/en-US/working-with-snapshots.xml
+++ b/docs/en-US/working-with-snapshots.xml
@@ -28,9 +28,10 @@
<para>Snapshots may be taken for volumes, including both root and data disks. The administrator places a limit on the number of stored snapshots per user. Users can create new volumes from the snapshot for recovery of particular files and they can create templates from snapshots to boot from a restored disk.</para>
<para>Users can create snapshots manually or by setting up automatic recurring snapshot policies. Users can also create disk volumes from snapshots, which may be attached to a VM like any other disk volume. Snapshots of both root disks and data disks are supported. However, &PRODUCT; does not currently support booting a VM from a recovered root disk. A disk recovered from snapshot of a root disk is treated as a regular data disk; the data on recovered disk can be accessed by attaching the disk to a VM.</para>
<para>A completed snapshot is copied from primary storage to secondary storage, where it is stored until deleted or purged by newer snapshot.</para>
- <xi:include href="snapshot-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="automatic-snapshot-creation-retention.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="incremental-snapshots-backup.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="volume-status.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="snapshot-restore.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="snapshot-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="snapshot-performance-vmware.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</section>