VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/hdimagewrites.dita@ 105145

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

Docs: bugref:10705. This is a merge commit to introduce doc team's changes in the user manual dita files. The following files
are excluded from this process:

  • Files whose names satrt with "viso", "vboxmanage", "man_", "vboximg", "vboxheadless", or "user_isomakercmd-man".

And general notes about this merge are as follows:

  • For now I leave glossentry-*dita file as they are since we use different enclosing dita elements
  • in hdimagewrites.dita we have <note type="attention"> while doc team's copy has <note type="caution">. Not sure if this is significant.

For now I copy doc team's version over.

  • I have not modified our UserManual.ditamap file. This will be done in a follow up commit.

The list of commits we have merged are as follows:

r3392: 7.1 new features; add comments to some DITA topics
r3730: VBP-283: Update supported platforms; 7.0 and 7.1
r3980: 7.1: reset menu option; add note
r3992: ARM hosts; add draft topic on limitations; add container topic for ARM-based subtopics
r3993: ARM create new VM wizard: add some dummy topics
r4014: ER 34784410 DOCUMENT THE VIRTUAL MACHINE TASKBAR ICONS: port topic and icon graphics from 7.0 tree
r4026: VBP-378: status bar icons; remove any mention of task bar; ported from 7.0
r4034: Cloning a cloud VM; add draft topic
r4035: Cloning a cloud VM;typo
r4036: Cloning a cloud VM;add xref from intro topic
r4050: Reset operation; add instructions
r4051: Amend comment
r4052: Ditaval markup for images
r4056: Add ditaval markup for images
r4057: Add ditaval markup for images
r4058: Add ditaval markup for images
r4073: UI experience level: add dummy topic
r4075: Subtype: option for VM settings General tab and Create VM wizard
r4094: Cloud VM reset; add to relnotes
r4095: Reset VM; use main Machine menu, rather than right-click menu
r4099: ARM hosts; draft revisions to cover different wizard screens
r4134: Cloud VMs: file manager menu option; add comment
r4214: Settings page, Motherboard tab: Chipset option for Arm VMs; add note
r4306: Terminology checker: clear up Errors; Installation chapter
r4307: Terminology checker: clear up Errors; Config settings/GA chapters
r4308: Terminology checker: clear up Errors; Storage, networking, remote VM chapters
r4311: Terminology checker: clear up Errors: various
r4324: Prefences and settings; potential areas for change in 7.1
r4356: r160214: Monitoring cloud VM performance; add new topic
r4358: r160214: Monitoring cloud VM performance; add new topic
r4364: r160214: Monitoring cloud VM performance; redraft topic
r4374: Experience levels; update user manual topic
r4377: Experience levels; Preferences window: add note re. availability of all possible settings
r4378: Experience levels; Preferences window: add note re. availability of all possible settingsLp
r4379: Typos and add remark re. Global menu changes
r4387: Preferences, Display: some settings introduced post-7.0: font scaling and extended features
r4388: Performance monitoring: add cloud VM instances to intro para
r4389: Experience levels: selecting a level, add graphic of icon
r4391: Resource monitoring; add CLI example to show CPU usage for a cloud instance
r4395: Experience levels; apply to menu items only
r4398: Experience levels; add notes
r4401: Experience levels; remove pics of global tools menu/machine tools menu; number of menu items can vary
r4402: Experience levels; remove image files for global tools menu/machine tools menu
r4525: Experience levels: minor redraft
r4528: Typo
r4538: Experience levels: selected level applies throughout VirtualBox Manager GUI
r4543: GUI topics; add notes for required changes
r4544: VISO Creator changes
r4563: r160714: unattended guest install example; now has user-password option
r4569: Terminology: front end, not front-end
r4570: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4571: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4623: Cloud VM monitoring: Compute Instance Monitoring plugin must be enabled; add note
r4625: CPU activity icon; update, now has solid bar
r4626: GUI changes; various, from Serkan; includes new pic for soft keyboard
r4629: separate mode: add some draft topics, will need to get technical review at a later stage
r4634: GUI; various notes and updates
r4655: Typo
r4703: Arm host platform limitations; redraft and add topic to host OS section
r4724: VISO creator; add notes re. ISO import
r4725: Separate mode: edits
r4863: r161176; Python 2.x no longer supported for API
r4899: Arm host support: limitations
r4910: Create VM wizard: settings may vary x86 vs. Arm hosts
r4911: Guest OS support; add note re. supported aarch64 OSes
r4973: r161445: Remove mention of parallel port support
r5004: Cloud VM monitoring: detailed data graphs and Activity Overview
r5038: Cloud VM monitoring: export to file
r5214: r161947: Solaris non-Global zone configuration
r5215: r161947: Solaris non-Global zone configuration; typo
r5230: Glossary: fix title for I/O APIC topic
r5341: Experience levels; can be selected from welcome screen in VirtualBox Manager; need replacement pic
r5345: Experience levels; add note on Welcome screen option
r5346: Arm host limitations; unavailable System settings
r5434: r162377: shared folders; symlinks behaviour
r5565: Cloud VM list in VirtualBox Manager; show mixed VM types; screenshot from Klaus
r5627: Obfuscate UUID data in screen shot
r5628: Delete legacy cloudvm pic; use mixed VMs example
r5654: Clean up comments in source files; redraft VM activity section
r5672: 7.1 changes; add comments
r5683: 7.1 changes; add comments for Arm topics
r5687: 7.1 changes; GUI; add comments
r5703: Oracle notices; include up to date versions in preface-* topics for User Guide
r5707: r162904: Windows install directory requirements; redraft
r5781: updated GNU version from 2 to 3 as per r163272
r5812: started removal of screenshots and updating tasks VBP-807
r5818: Further updates to creating a VM VBP-807
r5822: Restructured topics and made task based VBP-807
r5824: Removed files during restructure VBP-807
r5834: Fixed formatting of note and caution VBP-807
r5836: Updated supported host OS list VBP-825
r5837: updated USB topics for VBP-823
r5842: changes as per legal request re supported guests VBP-843
r5853: Updated versions following review. VBP-825


  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 9.1 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="hdimagewrites">
4 <title>Special Image Write Modes</title>
5
6 <body>
7 <p>
8 For each virtual disk image supported by <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, you can
9 determine separately how it should be affected by write operations
10 from a virtual machine and snapshot operations. This applies to
11 all of the aforementioned image formats (VDI, VMDK, VHD, or HDD)
12 and irrespective of whether an image is fixed-size or dynamically
13 allocated.
14 </p>
15 <p> By default, images are in <i>normal</i> mode. To mark an existing image with one of the
16 nonstandard modes listed below, use <userinput>VBoxManage modifymedium</userinput>. See <xref
17 href="vboxmanage-modifymedium.dita"/>. Alternatively, use <userinput>VBoxManage
18 storageattach</userinput> to attach the image to a VM and specify the
19 <codeph>--mtype</codeph> argument. See <xref href="vboxmanage-storageattach.dita"/>. </p>
20 <p>
21 The available virtual disk image modes are as follows:
22 </p>
23 <ul>
24 <li>
25 <p><b outputclass="bold">Normal images</b> have no
26 restrictions on how guests can read from and write to the
27 disk. This is the default image mode.
28 </p>
29 <p>
30 When you take a snapshot of your virtual machine as described
31 in <xref href="snapshots.dita#snapshots"/>, the state of a normal hard
32 disk is recorded together with the snapshot, and when
33 reverting to the snapshot, its state will be fully reset.
34 </p>
35 <p>
36 The image file itself is not reset. Instead, when a snapshot
37 is taken, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> <i>freezes</i> the
38 image file and no longer writes to it. For the write
39 operations from the VM, a second,
40 <i>differencing</i> image file is created which
41 receives only the changes to the original image. See
42 <xref href="diffimages.dita#diffimages"/>.
43 </p>
44 <p>
45 While you can attach the same normal image to more than one
46 virtual machine, only one of these virtual machines attached
47 to the same image file can be executed simultaneously, as
48 otherwise there would be conflicts if several machines write
49 to the same image file.
50 </p>
51 </li>
52 <li>
53 <p><b outputclass="bold">Write-through hard disks</b> are
54 completely unaffected by snapshots. Their state is
55 <i>not</i> saved when a snapshot is taken, and
56 not restored when a snapshot is restored.
57 </p>
58 </li>
59 <li>
60 <p><b outputclass="bold">Shareable hard disks</b> are a
61 variant of write-through hard disks. In principle they behave
62 exactly the same. Their state is <i>not</i>
63 saved when a snapshot is taken, and not restored when a
64 snapshot is restored. The difference only shows if you attach
65 such disks to several VMs. Shareable disks may be attached to
66 several VMs which may run concurrently. This makes them
67 suitable for use by cluster filesystems between VMs and
68 similar applications which are explicitly prepared to access a
69 disk concurrently. Only fixed size images can be used in this
70 way, and dynamically allocated images are rejected.
71 </p>
72 <note type="caution">
73 <p>
74 This is an expert feature, and misuse can lead to data loss,
75 as regular filesystems are not prepared to handle
76 simultaneous changes by several parties.
77 </p>
78 </note>
79 </li>
80 <li>
81 <p><b outputclass="bold">Immutable images</b> only
82 remember write accesses temporarily while the virtual machine
83 is running. All changes are lost when the virtual machine is
84 powered on the next time. As a result, as opposed to Normal
85 images, the same immutable image can be used with several
86 virtual machines without restrictions.
87 </p>
88 <p>
89 Creating an immutable image makes little sense since it would
90 be initially empty and lose its contents with every machine
91 restart. You would have a disk that is always unformatted when
92 the machine starts up. Instead, you can first create a normal
93 image and then later mark it as immutable when you decide that
94 the contents are useful.
95 </p>
96 <p>
97 If you take a snapshot of a machine with immutable images,
98 then on every machine power-up, those images are reset to the
99 state of the last (current) snapshot, instead of the state of
100 the original immutable image.
101 </p>
102 <note>
103 <p>
104 As a special exception, immutable images are
105 <i>not</i> reset if they are attached to a
106 machine in a saved state or whose last snapshot was taken
107 while the machine was running. This is called an
108 <i>online snapshot</i>. As a result, if the
109 machine's current snapshot is an online snapshot, its
110 immutable images behave exactly like the a normal image. To
111 reenable the automatic resetting of such images, delete the
112 current snapshot of the machine.
113 </p>
114 </note>
115 <p>
116 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> never writes to an immutable image directly at
117 all. All write operations from the machine are directed to a
118 differencing image. The next time the VM is powered on, the
119 differencing image is reset so that every time the VM starts,
120 its immutable images have exactly the same content.
121 </p>
122 <p>
123 The differencing image is only reset when the machine is
124 powered on from within <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, not when you reboot by
125 requesting a reboot from within the machine. This is also why
126 immutable images behave as described above when snapshots are
127 also present, which use differencing images as well.
128 </p>
129 <p> If the automatic discarding of the differencing image on VM startup does not fit your
130 needs, you can turn it off using the <codeph>autoreset</codeph> parameter of
131 <userinput>VBoxManage modifymedium</userinput>. See <xref
132 href="vboxmanage-modifymedium.dita"/>. </p>
133 </li>
134 <li>
135 <p><b outputclass="bold">Multiattach mode images</b> can
136 be attached to more than one virtual machine at the same time,
137 even if these machines are running simultaneously. For each
138 virtual machine to which such an image is attached, a
139 differencing image is created. As a result, data that is
140 written to such a virtual disk by one machine is not seen by
141 the other machines to which the image is attached. Each
142 machine creates its own write history of the multiattach
143 image.
144 </p>
145 <p>
146 Technically, a multiattach image behaves identically to an
147 immutable image except the differencing image is not reset
148 every time the machine starts.
149 </p>
150 <p>
151 This mode is useful for sharing files which are almost never
152 written, for instance picture galleries, where every guest
153 changes only a small amount of data and the majority of the
154 disk content remains unchanged. The modified blocks are stored
155 in differencing images which remain relatively small and the
156 shared content is stored only once at the host.
157 </p>
158 </li>
159 <li>
160 <p><b outputclass="bold">Read-only images</b> are used
161 automatically for CD/DVD images, since CDs/DVDs can never be
162 written to.
163 </p>
164 </li>
165 </ul>
166 <p>
167 The following scenario illustrates the differences between the
168 various image modes, with respect to snapshots.
169 </p>
170 <p>
171 Assume you have installed your guest OS in your VM, and you have
172 taken a snapshot. Later, your VM is infected with a virus and you
173 would like to go back to the snapshot. With a normal hard disk
174 image, you simply restore the snapshot, and the earlier state of
175 your hard disk image will be restored as well and your virus
176 infection will be undone. With an immutable hard disk, all it
177 takes is to shut down and power on your VM, and the virus
178 infection will be discarded. With a write-through image however,
179 you cannot easily undo the virus infection by means of
180 virtualization, but will have to disinfect your virtual machine
181 like a real computer.
182 </p>
183 <p>
184 You might find write-through images useful if you want to preserve
185 critical data irrespective of snapshots. As you can attach more
186 than one image to a VM, you may want to have one immutable image
187 for the OS and one write-through image for your data files.
188 </p>
189 </body>
190
191</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