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 06:01:07 UTC
git commit: updated refs/heads/master to dd4c236
Updated Branches:
refs/heads/master 535e74d86 -> dd4c2362b
CLOUDSTACK-871. DOC. Document changing a VM's base image.
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/dd4c2362
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/dd4c2362
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/dd4c2362
Branch: refs/heads/master
Commit: dd4c2362be43a8864d3aa33634e5ddaab04747fb
Parents: 535e74d
Author: Jessica <je...@citrix.com>
Authored: Thu Aug 8 21:00:42 2013 -0700
Committer: Jessica <je...@citrix.com>
Committed: Thu Aug 8 21:00:42 2013 -0700
----------------------------------------------------------------------
docs/en-US/update-iso-vm.xml | 41 ++++++++++++++++++++++++++++++++++++
docs/en-US/working-with-iso.xml | 1 +
2 files changed, 42 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/dd4c2362/docs/en-US/update-iso-vm.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/update-iso-vm.xml b/docs/en-US/update-iso-vm.xml
new file mode 100644
index 0000000..8aa9b25
--- /dev/null
+++ b/docs/en-US/update-iso-vm.xml
@@ -0,0 +1,41 @@
+<?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="update-iso-vm">
+ <!-- CLOUDSTACK-667 -->
+ <title>Changing a VM's Base Image</title>
+ <para>Every VM is created from a base image, which is a template or ISO which has been
+ created and stored in &PRODUCT;. Both cloud administrators and end users can create and
+ modify templates, ISOs, and VMs.</para>
+ <para>In &PRODUCT;, you can change an
+ existing VM's base image. For example, suppose there is a template based
+ on a particular operating system, and the OS vendor releases a software patch. The
+ administrator or user naturally wants to apply the patch and then make sure existing VMs
+ start using it. Whether a software update is involved or not, it's also possible to simply
+ switch a VM from its current template to any other desired template.</para>
+ <para>To change a VM's base image, call the restoreVirtualMachine API command and pass in the virtual machine
+ ID and a new template ID. The template ID parameter may refer to either a template or an
+ ISO. When this call occurs, the VM's root disk is first destroyed, then a new root disk is
+ created from the source designated in the template ID parameter. The new root disk is
+ attached to the VM, and now the VM is based on the new template.</para>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/dd4c2362/docs/en-US/working-with-iso.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/working-with-iso.xml b/docs/en-US/working-with-iso.xml
index 03e18ee..9872106 100644
--- a/docs/en-US/working-with-iso.xml
+++ b/docs/en-US/working-with-iso.xml
@@ -29,4 +29,5 @@
<para>ISO images may be stored in the system and made available with a privacy level similar to templates. ISO images are classified as either bootable or not bootable. A bootable ISO image is one that contains an OS image. &PRODUCT; allows a user to boot a guest VM off of an ISO image. Users can also attach ISO images to guest VMs. For example, this enables installing PV drivers into Windows. ISO images are not hypervisor-specific.</para>
<xi:include href="add-iso.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="attach-iso-to-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="update-iso-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</section>