VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/clone.dita@ 105289

Last change on this file since 105289 was 105289, checked in by vboxsync, 7 months ago

Docs: bugref:10705. Merging current changes to dita files from docs team's repo. (r6123, r6120, r6117)

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.3 KB
Line 
1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3<topic xml:lang="en-us" id="clone">
4 <title>Cloning Virtual Machines</title>
5
6 <body>
7 <p>You can create a full copy or a linked copy of an existing VM. This copy is called a <i>clone</i>. You might use
8 a cloned VM to experiment with a VM configuration, to test different guest OS levels, or to back up a VM. </p>
9 <p>The <b outputclass="bold">Clone Virtual Machine</b> wizard guides you through the cloning process. </p>
10 <p>You can start the Clone Virtual Machine wizard in one of the following ways: </p>
11 <ul>
12 <li>
13 <p>Click the VM name in the machine list and then select <b outputclass="bold">Clone</b> from the <b
14 outputclass="bold">Machine</b> menu. </p>
15 </li>
16 <li>
17 <p>Click <b outputclass="bold">Clone</b> in the <b outputclass="bold">Snapshots</b> window for the selected VM. </p>
18 </li>
19 </ul>
20 <note>
21 <p>The <b outputclass="bold">Clone</b> menu item is disabled while a virtual machine is running. </p>
22 </note>
23 <p>The <b outputclass="bold">New Machine Name and Path</b> page is displayed. </p>
24 <fig id="fig-clone-wizard-name-path">
25 <title>Clone Virtual Machine Wizard: New Machine Name and Path</title>
26 <xref href="images/clone-vm-1.png" format="png" platform="htmlhelp">
27 <image href="images/clone-vm-1.png" width="10cm" placement="break">
28 <alt>Clone Virtual Machine Wizard: New Machine Name and Path</alt>
29 </image>
30 </xref>
31 <image href="images/clone-vm-1.png" width="10cm" placement="break" platform="ohc">
32 <alt>Clone Virtual Machine Wizard: New Machine Name and Path</alt>
33 </image>
34 </fig>
35 <p>The following clone options are available: </p>
36 <ul>
37 <li>
38 <p><b outputclass="bold">Name:</b> A name for the cloned
39 machine.
40 </p>
41 </li>
42 <li>
43 <p><b outputclass="bold">Path:</b> Choose a location for
44 the cloned virtual machine, otherwise <ph conkeyref="vbox-conkeyref-phrases/product-name"/> uses the
45 default machines folder.
46 </p>
47 </li>
48 <li>
49 <p><b outputclass="bold">MAC Address Policy:</b> Specifies
50 whether to retain network card MAC addresses when cloning the
51 VM.
52 </p>
53 <p>
54 For example, the <b outputclass="bold">Generate New MAC
55 Addresses For All Network Adapters</b> value assigns a
56 new MAC address to each network card during cloning. This is
57 the default setting. This is the best option when both the
58 source VM and the cloned VM must operate on the same network.
59 Other values enable you to retain the existing MAC addresses
60 in the cloned VM.
61 </p>
62 </li>
63 <li>
64 <p><b outputclass="bold">Keep Disk Names:</b> Retains the
65 disk image names when cloning the VM.
66 </p>
67 </li>
68 <li>
69 <p><b outputclass="bold">Keep Hardware UUIDs:</b> Retains
70 the hardware universally unique identifiers (UUIDs) when
71 cloning the VM.
72 </p>
73 </li>
74 </ul>
75 <p>Click <b outputclass="bold">Next</b>. The <b outputclass="bold">Clone Type</b> page is displayed. </p>
76 <fig id="fig-clone-type">
77 <title>Clone Virtual Machine Wizard: Clone Type</title>
78 <xref href="images/clone-vm-2.png" format="png" platform="htmlhelp">
79 <image href="images/clone-vm-2.png" width="10cm" placement="break">
80 <alt>Clone Virtual Machine Wizard: Clone Type</alt>
81 </image>
82 </xref>
83 <image href="images/clone-vm-2.png" width="10cm" placement="break" platform="ohc">
84 <alt>Clone Virtual Machine Wizard: Clone Type</alt>
85 </image>
86 </fig>
87 <p>The <b outputclass="bold">Clone Type</b> option specifies whether to create a clone that is linked to the source
88 VM or to create a fully independent clone: </p>
89 <ul>
90 <li>
91 <p><b outputclass="bold">Full Clone:</b> Copies all
92 dependent disk images to the new VM folder. A full clone can
93 operate fully without the source VM.
94 </p>
95 </li>
96 <li>
97 <p><b outputclass="bold">Linked Clone:</b> Creates new
98 differencing disk images based on the source VM disk images.
99 If you select the current state of the source VM as the clone
100 point, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> creates a new snapshot.
101 </p>
102 </li>
103 </ul>
104 <p>
105 (Optional) Click <b outputclass="bold">Next</b>. The
106 <b outputclass="bold">Snapshots</b> page is displayed.
107 </p>
108 <note>
109 <p>The Snapshots page is only displayed for machines that have snapshots and the selected clone type is <b
110 outputclass="bold">Full Clone</b>. </p>
111 </note>
112 <fig id="fig-clone-wizard-snapshots">
113 <title>Clone Virtual Machine Wizard: Snapshots</title>
114 <xref href="images/clone-vm-3.png" format="png" platform="htmlhelp">
115 <image href="images/clone-vm-3.png" width="10cm" placement="break">
116 <alt>Clone Virtual Machine Wizard: Snapshots</alt>
117 </image>
118 </xref>
119 <image href="images/clone-vm-3.png" width="10cm" placement="break" platform="ohc">
120 <alt>Clone Virtual Machine Wizard: Snapshots</alt>
121 </image>
122 </fig>
123 <p>You use this page to select which parts of the snapshot tree to include in the clone. The available options are
124 as follows: </p>
125 <ul>
126 <li>
127 <p><b outputclass="bold">Current Machine State:</b> Clones
128 the current state of the VM. Snapshots are not included.
129 </p>
130 </li>
131 <li>
132 <p><b outputclass="bold">Everything:</b> Clones the
133 current machine state and all its snapshots.
134 </p>
135 </li>
136 </ul>
137 <p>
138 Click <b outputclass="bold">Finish</b> to start the clone
139 operation.
140 </p>
141 <p>
142 The duration of the clone operation depends on the size and number
143 of attached disk images. In addition, the clone operation saves
144 all the differencing disk images of a snapshot.
145 </p>
146 <p>
147 You can also use the <userinput>VBoxManage clonevm</userinput> command to clone a VM. See
148 <xref href="vboxmanage-clonevm.dita"/>.
149 </p>
150 </body>
151
152</topic>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette