File: virtual-media-manager.dita

package info (click to toggle)
virtualbox 7.1.12-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 565,672 kB
  • sloc: ansic: 2,330,854; cpp: 2,193,228; asm: 230,777; python: 223,895; xml: 86,771; sh: 25,541; makefile: 8,158; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,782; javascript: 1,692; objc: 1,131; lex: 931; php: 906; sed: 899; yacc: 707
file content (154 lines) | stat: -rw-r--r-- 8,913 bytes parent folder | download
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
<?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><ph conkeyref="vbox-conkeyref-phrases/product-name"/> 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 <ph
            conkeyref="vbox-conkeyref-phrases/product-name"/> 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 <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. </p>
               <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 <ph conkeyref="vbox-conkeyref-phrases/product-name"/>'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, <ph
            conkeyref="vbox-conkeyref-phrases/product-name"/> 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 <ph
              conkeyref="vbox-conkeyref-phrases/product-name"/> 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, <ph
          conkeyref="vbox-conkeyref-phrases/product-name"/> issues an error because <ph
          conkeyref="vbox-conkeyref-phrases/product-name"/> 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 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> import and
        export features. See <xref href="ovf.dita#ovf"/>. </p>
               </note>
            </body>
            
            
            
         </topic>