cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject git commit: updated refs/heads/master to dd4c236
Date Fri, 09 Aug 2013 04:01:07 GMT
Updated Branches:
  refs/heads/master 535e74d86 -> dd4c2362b

CLOUDSTACK-871. DOC. Document changing a VM's base image.


Branch: refs/heads/master
Commit: dd4c2362be43a8864d3aa33634e5ddaab04747fb
Parents: 535e74d
Author: Jessica <>
Authored: Thu Aug 8 21:00:42 2013 -0700
Committer: Jessica <>
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(+)
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" ""
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+<!-- 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
+	Unless required by applicable law or agreed to in writing,
+	software distributed under the License is distributed on an
+	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
+		created and stored in &PRODUCT;. Both cloud administrators and end users can create
+		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
+		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>
\ No newline at end of file
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="" />
     <xi:include href="attach-iso-to-vm.xml" xmlns:xi=""
+    <xi:include href="update-iso-vm.xml" xmlns:xi="" />

View raw message