summaryrefslogtreecommitdiff
path: root/doc/manual/en_US/dita/topics/virtual-media-manager.dita
blob: a6b51e79bcf6d8613a531c4879353d3ee9332066 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
  PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="virtual-media-manager">
            <title>The Virtual Media Manager</title>
            
            <body>
               <p>
      Oracle VM VirtualBox keeps track of all the hard disk, CD/DVD-ROM, and
      floppy disk images which are in use by virtual machines. These are
      often referred to as <i>known media</i> and come
      from two sources:
    </p>
               <ul>
                  <li>
                     <p>
          All media currently attached to virtual machines.
        </p>
                  </li>
                  <li>
                     <p>
          Registered media, for compatibility with legacy Oracle VM VirtualBox
          versions.
        </p>
                  </li>
               </ul>
               <p>
      The known media can be viewed and changed using the
      <b outputclass="bold">Virtual Media Manager</b> tool, which
      you access by clicking <b outputclass="bold">Media</b> on
      the global <b outputclass="bold">Tools</b> menu in
      VirtualBox Manager.
    </p>
              <fig id="fig-virtual-media-manager">
                <title>The Virtual Media Manager, Showing Hard Disk Images</title>
                <xref href="images/virtual-disk-manager.png" format="png" platform="htmlhelp">
                  <image href="images/virtual-disk-manager.png" width="12cm" placement="break">
                    <alt>The Virtual Media Manager, Showing Hard Disk Images</alt>
                  </image>
                </xref>
                <image platform="ohc" href="images/virtual-disk-manager.png" width="12cm" placement="break">
                  <alt>The Virtual Media Manager, Showing Hard Disk Images</alt>
                </image>
              </fig>
               <p>
      The known media are conveniently grouped in separate tabs for the
      supported formats. These formats are:
    </p>
               <ul>
                  <li>
                     <p>
          Hard disk images, either in Oracle VM VirtualBox's own Virtual Disk
          Image (VDI) format, or in the third-party formats listed in
          <xref href="vdidetails.dita#vdidetails"/>.
        </p>
                  </li>
                  <li>
                     <p>
          CD/DVD images in standard ISO format.
        </p>
                  </li>
                  <li>
                     <p>
          Floppy images in standard RAW format.
        </p>
                  </li>
               </ul>
               <p>
      For each image, the Virtual Media Manager shows you the full path
      of the image file and other information, such as the virtual
      machine the image is currently attached to.
    </p>
               <p>
      The Virtual Media Manager enables you to do the following:
    </p>
               <ul>
                  <li>
                     <p>
                        <b outputclass="bold">Add</b> an image to the known
          media.
        </p>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Create</b> a new disk image.
        </p>
                     <ul>
                        <li>
                           <p>
              For hard disks, the <b outputclass="bold">Create Virtual
              Hard Disk</b> wizard is shown. See
              <xref href="create-virtual-hard-disk-image.dita#create-virtual-hard-disk-image"/>.
            </p>
                        </li>
                        <li>
                           <p>
              For optical disks, the <b outputclass="bold">VISO
              Creator</b> tool is shown. See
              <xref href="create-optical-disk-image.dita#create-optical-disk-image"/>.
            </p>
                        </li>
                        <li>
                           <p>
              For floppy disks, the <b outputclass="bold">Floppy Disk
              Creator</b> tool is shown. See
              <xref href="create-floppy-disk-image.dita#create-floppy-disk-image"/>.
            </p>
                        </li>
                     </ul>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Copy</b> an image to create
          another one.
        </p>
                     <p>
          For virtual hard disks, you can specify one of the following
          target types: VDI, VHD, or VMDK.
        </p>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Move</b> an image to another
          location.
        </p>
                     <p>
          A file dialog prompts you for the new image file location.
        </p>
                     <p>
          When you use the Virtual Media Manager to move a disk image,
          Oracle VM VirtualBox updates all related configuration files
          automatically.
        </p>
                     <note>
                        <p>
            Always use the Virtual Media Manager or the
            <userinput>VBoxManage modifymedium</userinput> command to move a
            disk image.
          </p>
                        <p>
            If you use a file management feature of the host OS to move
            a disk image to a new location, run the <userinput>VBoxManage
              modifymedium --setlocation</userinput>                       
            command to configure the new path of the disk image on the
            host file system. This command updates the Oracle VM VirtualBox
            configuration automatically.
          </p>
                     </note>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Remove</b> an image from the
          known media. You can optionally delete the image file when
          removing the image.
        </p>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Release</b> an image to detach it
          from a VM. This action only applies if the image is currently
          attached to a VM as a virtual hard disk.
        </p>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Clear</b> all inaccessible disk
          images from the list. The disk images are released from the
          VMs they are attached to and removed from the known media.
        </p>
                     <note>
                        <p>
            This option is for optical disks and floppy disks only.
          </p>
                     </note>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Search</b> for an image by name
          or UUID.
        </p>
                  </li>
                  <li>
                     <p>
          View and edit the <b outputclass="bold">Properties</b>
          of a disk image.
        </p>
                     <p>
          Available properties include the following:
        </p>
                     <ul>
                        <li>
                           <p>
                              <b outputclass="bold">Type:</b> Specifies the
              snapshot behavior of the disk. See
              <xref href="hdimagewrites.dita#hdimagewrites"/>.
            </p>
                        </li>
                        <li>
                           <p>
                              <b outputclass="bold">Location:</b> Specifies the
              location of the disk image file on the host system. You
              can use a file dialog to browse for the disk image
              location.
            </p>
                        </li>
                        <li>
                           <p>
                              <b outputclass="bold">Description:</b> Specifies a
              short description of the disk image.
            </p>
                        </li>
                        <li>
                           <p>
                              <b outputclass="bold">Size:</b> Specifies the size
              of the disk image. You can use the slider to increase or
              decrease the disk image size.
            </p>
                        </li>
                        <li>
                           <p>
                              <b outputclass="bold">Information:</b> Specifies
              detailed information about the disk image.
            </p>
                        </li>
                     </ul>
                  </li>
                  <li>
                     <p>
                        <b outputclass="bold">Refresh</b> the property values
          of the selected disk image.
        </p>
                  </li>
               </ul>
               <p>
      To perform these actions, highlight the medium in the Virtual
      Media Manager and then do one of the following:
    </p>
               <ul>
                  <li>
                     <p>
          Click an icon in the Virtual Media Manager toolbar.
        </p>
                  </li>
                  <li>
                     <p>
          Right-click the medium and select an option.
        </p>
                  </li>
               </ul>
               <p>
      Use the <b outputclass="bold">Storage</b> page in a VM's
      <b outputclass="bold">Settings</b> window to create a new
      disk image. By default, disk images are stored in the VM's folder.
    </p>
               <p>
      You can copy hard disk image files to other host systems and then
      import them in to VMs from the host system. However, some Windows
      guest OSes may require that you configure the new VM in a similar
      way to the old one.
    </p>
               <note>
                  <p>
        Do not simply make copies of virtual disk images. If you import
        such a second copy into a VM, Oracle VM VirtualBox issues an error
        because Oracle VM VirtualBox assigns a universally unique identifier
        (UUID) to each disk image to ensure that it is only used one
        time. See <xref href="cloningvdis.dita#cloningvdis"/>. Also, if you want to
        copy a VM to another system, use the Oracle VM VirtualBox import and
        export features. See <xref href="ovf.dita#ovf"/>.
      </p>
               </note>
            </body>
            
            
            
         </topic>