1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
---|
4 | <chapter id="KnownIssues">
|
---|
5 | <title>Known limitations</title>
|
---|
6 | <sect1 id="ExperimentalFeatures">
|
---|
7 | <title>Experimental Features</title>
|
---|
8 | <para>Some VirtualBox features are labeled as experimental. Such
|
---|
9 | features are provided on an "as-is" basis and are not formally
|
---|
10 | supported. However, feedback and suggestions about such features are
|
---|
11 | welcome. A comprehensive list of experimental features follows:</para>
|
---|
12 | <itemizedlist>
|
---|
13 | <listitem>
|
---|
14 | WDDM Direct3D video driver for Windows guests
|
---|
15 | </listitem>
|
---|
16 | <listitem>
|
---|
17 | Hardware 3D acceleration support for Windows, Linux, and Solaris
|
---|
18 | guests
|
---|
19 | </listitem>
|
---|
20 | <listitem>
|
---|
21 | Hardware 2D video playback acceleration support for Windows
|
---|
22 | guests
|
---|
23 | </listitem>
|
---|
24 | <listitem>
|
---|
25 | PCI pass-through (Linux hosts only)
|
---|
26 | </listitem>
|
---|
27 | <listitem>
|
---|
28 | Mac OS X guests (Mac hosts only)
|
---|
29 | </listitem>
|
---|
30 | <listitem>
|
---|
31 | ICH9 chipset emulation
|
---|
32 | </listitem>
|
---|
33 | <listitem>
|
---|
34 | NDIS6 host drivers
|
---|
35 | </listitem>
|
---|
36 | <listitem>
|
---|
37 | EFI firmware
|
---|
38 | </listitem>
|
---|
39 | <listitem>
|
---|
40 | Host CD/DVD drive pass-through
|
---|
41 | </listitem>
|
---|
42 | <listitem>
|
---|
43 | Support of iSCSI via internal networking
|
---|
44 | </listitem>
|
---|
45 | <listitem>
|
---|
46 | Synthetic CPU reporting
|
---|
47 | </listitem>
|
---|
48 | </itemizedlist>
|
---|
49 | </sect1>
|
---|
50 | <sect1 id="KnownProblems">
|
---|
51 | <title>Known Issues</title>
|
---|
52 | <para>The following section describes known problems with VirtualBox
|
---|
53 | $VBOX_VERSION_STRING. Unless marked otherwise, these issues are planned to
|
---|
54 | be fixed in later releases.</para>
|
---|
55 |
|
---|
56 | <itemizedlist>
|
---|
57 | <listitem>
|
---|
58 | <para>The following <emphasis role="bold">Guest SMP (multiprocessor)
|
---|
59 | limitations</emphasis> exist:<itemizedlist>
|
---|
60 | <listitem>
|
---|
61 | <para><emphasis role="bold">Poor performance</emphasis> with
|
---|
62 | 32-bit guests on AMD CPUs. This affects mainly Windows and Solaris
|
---|
63 | guests, but possibly also some Linux kernel revisions. Partially
|
---|
64 | solved in 3.0.6 for 32 bits Windows NT, 2000, XP and 2003 guests.
|
---|
65 | Requires 3.0.6 or higher Guest Additions to be installed.</para>
|
---|
66 | </listitem>
|
---|
67 |
|
---|
68 | <listitem>
|
---|
69 | <para><emphasis role="bold">Poor performance</emphasis> with
|
---|
70 | 32-bit guests on certain Intel CPU models that do not include
|
---|
71 | virtual APIC hardware optimization support. This affects mainly
|
---|
72 | Windows and Solaris guests, but possibly also some Linux kernel
|
---|
73 | revisions. Partially solved in 3.0.12 for 32 bits Windows NT,
|
---|
74 | 2000, XP and 2003 guests. Requires 3.0.12 or higher Guest
|
---|
75 | Additions to be installed.</para>
|
---|
76 | </listitem>
|
---|
77 | </itemizedlist></para>
|
---|
78 | </listitem>
|
---|
79 |
|
---|
80 | <listitem>
|
---|
81 | <para><emphasis role="bold">NX (no execute, data execution
|
---|
82 | prevention)</emphasis> only works for guests running on 64-bit hosts
|
---|
83 | or guests running on 32-bit hosts with PAE enabled and requires that
|
---|
84 | hardware virtualization be enabled.</para>
|
---|
85 | </listitem>
|
---|
86 |
|
---|
87 | <listitem>
|
---|
88 | <para>For <emphasis role="bold">basic Direct3D support in Windows
|
---|
89 | guests</emphasis> to work, the Guest Additions must be installed in
|
---|
90 | Windows "safe mode". Press F8 when the Windows guest is booting and
|
---|
91 | select "Safe mode", then install the Guest Additions. Otherwise Windows'
|
---|
92 | file protection mechanism will interfere with the replacement DLLs
|
---|
93 | installed by VirtualBox and keep restoring the original Windows system
|
---|
94 | DLLs. <note>
|
---|
95 | <para>This does <emphasis role="bold">not</emphasis> apply to the
|
---|
96 | experimental WDDM Direct3D video
|
---|
97 | driver available for Vista and Windows 7 guests shipped with
|
---|
98 | VirtualBox 4.1.</para>
|
---|
99 | </note></para>
|
---|
100 | </listitem>
|
---|
101 |
|
---|
102 | <listitem>
|
---|
103 | <para><emphasis role="bold">Guest control.</emphasis> On Windows guests,
|
---|
104 | a process lauched via the guest control execute support will not be able
|
---|
105 | to display a graphical user interface <emphasis>unless</emphasis> the
|
---|
106 | user account under which it is running is currently logged in and has a
|
---|
107 | desktop session.</para>
|
---|
108 |
|
---|
109 | <para>Also, to use accounts without or with an empty password, the
|
---|
110 | guest's group policy must be changed. To do so, open the group policy
|
---|
111 | editor on the command line by typing
|
---|
112 | <computeroutput>gpedit.msc</computeroutput>, open the key
|
---|
113 | <emphasis>Computer Configuration\Windows Settings\Security
|
---|
114 | Settings\Local Policies\Security Options</emphasis> and change the value
|
---|
115 | of <emphasis>Accounts: Limit local account use of blank passwords to
|
---|
116 | console logon only</emphasis> to <emphasis>Disabled</emphasis>.</para>
|
---|
117 | </listitem>
|
---|
118 |
|
---|
119 | <listitem>
|
---|
120 | <para><emphasis role="bold">Compacting virtual disk images is limited to
|
---|
121 | VDI files.</emphasis> The <code>VBoxManage modifyhd --compact</code>
|
---|
122 | command is currently only implemented for VDI files. At the moment the
|
---|
123 | only way to optimize the size of a virtual disk images in other formats
|
---|
124 | (VMDK, VHD) is to clone the image and then use the cloned image in the
|
---|
125 | VM configuration.</para>
|
---|
126 | </listitem>
|
---|
127 |
|
---|
128 | <listitem>
|
---|
129 | <para><emphasis role="bold">OVF import/export:</emphasis><itemizedlist>
|
---|
130 | <listitem>
|
---|
131 | <para>OVF localization (multiple languages in one OVF file) is not
|
---|
132 | yet supported.</para>
|
---|
133 | </listitem>
|
---|
134 |
|
---|
135 | <listitem>
|
---|
136 | <para>Some OVF sections like StartupSection,
|
---|
137 | DeploymentOptionSection and InstallSection are ignored.</para>
|
---|
138 | </listitem>
|
---|
139 |
|
---|
140 | <listitem>
|
---|
141 | <para>OVF environment documents, including their property sections
|
---|
142 | and appliance configuration with ISO images, are not yet
|
---|
143 | supported.</para>
|
---|
144 | </listitem>
|
---|
145 |
|
---|
146 | <listitem>
|
---|
147 | <para>Remote files via HTTP or other mechanisms are not yet
|
---|
148 | supported.</para>
|
---|
149 | </listitem>
|
---|
150 | </itemizedlist></para>
|
---|
151 | </listitem>
|
---|
152 |
|
---|
153 | <listitem>
|
---|
154 | <para>Neither <emphasis role="bold">scale mode</emphasis> nor <emphasis
|
---|
155 | role="bold">seamless mode</emphasis> work correctly with guests using
|
---|
156 | OpenGL 3D features (such as with compiz-enabled window managers).</para>
|
---|
157 | </listitem>
|
---|
158 |
|
---|
159 | <listitem>
|
---|
160 | <para>The RDP server in the VirtualBox extension pack supports only
|
---|
161 | audio streams in format 22.05kHz stereo 16 bit. If the RDP client
|
---|
162 | requests any other audio format there will be no audio.</para>
|
---|
163 | </listitem>
|
---|
164 |
|
---|
165 | <listitem>
|
---|
166 | <para>Preserving the aspect ratio in scale mode works only on Windows
|
---|
167 | hosts and on Mac OS X hosts.</para>
|
---|
168 | </listitem>
|
---|
169 |
|
---|
170 | <listitem>
|
---|
171 | <para>On <emphasis role="bold">Mac OS X hosts,</emphasis> the following
|
---|
172 | features are not yet implemented:</para>
|
---|
173 |
|
---|
174 | <para><itemizedlist>
|
---|
175 | <listitem>
|
---|
176 | <para>Numlock emulation</para>
|
---|
177 | </listitem>
|
---|
178 |
|
---|
179 | <listitem>
|
---|
180 | <para>CPU frequency metric</para>
|
---|
181 | </listitem>
|
---|
182 |
|
---|
183 | <listitem>
|
---|
184 | <para>Memory ballooning</para>
|
---|
185 | </listitem>
|
---|
186 | </itemizedlist></para>
|
---|
187 | </listitem>
|
---|
188 |
|
---|
189 | <listitem>
|
---|
190 | <para><emphasis role="bold">Mac OS X guests:</emphasis>
|
---|
191 | <itemizedlist>
|
---|
192 | <listitem>
|
---|
193 | <para>Mac OS X guests can only run on a certain host hardware.
|
---|
194 | For details about license and host hardware limitations, please
|
---|
195 | see <xref linkend="intro-macosxguests" /> and check the Apple
|
---|
196 | software license conditions.</para>
|
---|
197 | </listitem>
|
---|
198 |
|
---|
199 | <listitem>
|
---|
200 | <para>VirtualBox does not provide Guest Additions for Mac OS X
|
---|
201 | at this time.</para>
|
---|
202 | </listitem>
|
---|
203 |
|
---|
204 | <listitem>
|
---|
205 | <para>The graphics resolution currently defaults to 1024x768 as
|
---|
206 | Mac OS X falls back to the built-in EFI display support. See
|
---|
207 | <xref linkend="efividmode" /> for more information on how to
|
---|
208 | change EFI video modes.</para>
|
---|
209 | </listitem>
|
---|
210 |
|
---|
211 | <listitem>
|
---|
212 | <para>Mac OS X guests only work with one CPU assigned to the
|
---|
213 | VM. Support for SMP will be provided in a future release.</para>
|
---|
214 | </listitem>
|
---|
215 |
|
---|
216 | <listitem>
|
---|
217 | <para>Depending on your system and version of Mac OS X, you
|
---|
218 | might experience guest hangs after some time. This can be fixed
|
---|
219 | by turning off energy saving (set timeout to "Never") in the
|
---|
220 | system preferences.</para>
|
---|
221 | </listitem>
|
---|
222 |
|
---|
223 | <listitem>
|
---|
224 | <para>By default, the VirtualBox EFI enables debug output of the
|
---|
225 | Mac OS X kernel to help you diagnose boot problems. Note that
|
---|
226 | there is a lot of output and not all errors are fatal (they
|
---|
227 | would also show on your physical Mac). You can turn off these
|
---|
228 | messages by issuing this command:<screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" " "</screen>To
|
---|
229 | revert to the previous behavior, use:<screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" ""</screen></para>
|
---|
230 | </listitem>
|
---|
231 |
|
---|
232 | <listitem>
|
---|
233 | <para>It is currently not possible to start a Mac OS X guest in safe mode by specifying "-x" option
|
---|
234 | in "VBoxInternal2/EfiBootArgs" extradata.</para>
|
---|
235 | </listitem>
|
---|
236 | </itemizedlist></para>
|
---|
237 | </listitem>
|
---|
238 |
|
---|
239 | <listitem>
|
---|
240 | <para><emphasis role="bold">Solaris hosts:</emphasis> <itemizedlist>
|
---|
241 | <listitem>
|
---|
242 | <para>There is no support for USB devices connected to Solaris 10
|
---|
243 | hosts.</para>
|
---|
244 | </listitem>
|
---|
245 |
|
---|
246 | <listitem>
|
---|
247 | <para>USB support on Solaris hosts requires Solaris 11 version
|
---|
248 | snv_124 or higher. Webcams and other isochronous devices are known
|
---|
249 | to have poor performance.</para>
|
---|
250 | </listitem>
|
---|
251 |
|
---|
252 | <listitem>
|
---|
253 | <para>Host Webcam passthrough is restricted to 640x480 frames at
|
---|
254 | 20 frames per second due to limitations in the Solaris V4L2 API.
|
---|
255 | This may be addressed in a future Solaris release.</para>
|
---|
256 | </listitem>
|
---|
257 |
|
---|
258 | <listitem>
|
---|
259 | <para>No ACPI information (battery status, power source) is
|
---|
260 | reported to the guest.</para>
|
---|
261 | </listitem>
|
---|
262 |
|
---|
263 | <listitem>
|
---|
264 | <para>No support for using wireless adapters with bridged
|
---|
265 | networking.</para>
|
---|
266 | </listitem>
|
---|
267 |
|
---|
268 | <listitem>
|
---|
269 | <para>Crossbow-based bridged networking on Solaris 11 hosts does
|
---|
270 | not work directly with aggregate links. However, you can manually
|
---|
271 | create a VNIC (using <computeroutput>dladm</computeroutput>) over
|
---|
272 | the aggregate link and use that with a VM. This limitation does
|
---|
273 | not exist in Solaris 11u1 build 17 and newer.</para>
|
---|
274 | </listitem>
|
---|
275 | </itemizedlist></para>
|
---|
276 | </listitem>
|
---|
277 |
|
---|
278 | <listitem>
|
---|
279 | <para><emphasis role="bold">Guest Additions of version 4.1, 4.1.2 and 4.1.4 for Windows</emphasis>
|
---|
280 | Thus VirtualBox WDDM Video driver may be installed and kept in guest system
|
---|
281 | if Guest additions uninstallation is performed.
|
---|
282 | This is caused by a bug in Guest Additions uninstaller.
|
---|
283 | <note>
|
---|
284 | <para>This does <emphasis role="bold">not</emphasis> apply to Guest Additions update,
|
---|
285 | i.e. installing a one version of Guest Additions on top of another works correctly.</para>
|
---|
286 | </note>
|
---|
287 | To solve this problem, one should uninstall the VirtualBox WDDM Video driver manually.
|
---|
288 | To do that open Device Manager, and check whether the Display Adapter is named
|
---|
289 | "VirtualBox Graphics Adapter ..". If no - there is nothing to be done. If yes - right-click
|
---|
290 | the VirtualBox Graphics Adapter in Device Manager, select "Uninstall", check "Delete the driver software for this device"
|
---|
291 | and click "OK". Once uninstallation is done - in Device Manager go to menu "Action" and select
|
---|
292 | "Scan for hardware changes" to make the propper (Windows default) driver be picked up for the Graphics adapter.
|
---|
293 | </para>
|
---|
294 | </listitem>
|
---|
295 |
|
---|
296 | <listitem>
|
---|
297 | <para>Neither <emphasis>virtio</emphasis> nor <emphasis>Intel PRO/1000
|
---|
298 | </emphasis> drivers for <emphasis role="bold">Windows XP guests
|
---|
299 | </emphasis> support segmentation offloading. Therefore
|
---|
300 | Windows XP guests have slower transmission rates comparing to other
|
---|
301 | guest types. Refer to MS Knowledge base article 842264 for additional
|
---|
302 | information.</para>
|
---|
303 | </listitem>
|
---|
304 |
|
---|
305 | <listitem>
|
---|
306 | <para><emphasis role="bold">Guest Additions for OS/2.</emphasis> Shared
|
---|
307 | folders are not yet supported with OS/2 guests. In addition, seamless
|
---|
308 | windows and automatic guest resizing will probably never be implemented
|
---|
309 | due to inherent limitations of the OS/2 graphics system.</para>
|
---|
310 | </listitem>
|
---|
311 | </itemizedlist>
|
---|
312 | </sect1>
|
---|
313 | </chapter>
|
---|