1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
|
---|
4 | <!ENTITY % all.entities SYSTEM "all-entities.ent">
|
---|
5 | %all.entities;
|
---|
6 | ]>
|
---|
7 | <chapter id="KnownIssues">
|
---|
8 |
|
---|
9 | <title>Known Limitations</title>
|
---|
10 |
|
---|
11 | <sect1 id="ExperimentalFeatures">
|
---|
12 |
|
---|
13 | <title>Experimental Features</title>
|
---|
14 |
|
---|
15 | <para>
|
---|
16 | Some &product-name; features are labeled as experimental. Such
|
---|
17 | features are provided on an "as-is" basis and are not formally
|
---|
18 | supported. However, feedback and suggestions about such features
|
---|
19 | are welcome. A comprehensive list of experimental features is as
|
---|
20 | follows:
|
---|
21 | </para>
|
---|
22 |
|
---|
23 | <itemizedlist>
|
---|
24 |
|
---|
25 | <listitem>
|
---|
26 | <para>
|
---|
27 | Hardware 3D acceleration support for Windows, Linux, and
|
---|
28 | Oracle Solaris guests
|
---|
29 | </para>
|
---|
30 | </listitem>
|
---|
31 |
|
---|
32 | <listitem>
|
---|
33 | <para>
|
---|
34 | Hardware 2D video playback acceleration support for Windows
|
---|
35 | guests
|
---|
36 | </para>
|
---|
37 | </listitem>
|
---|
38 |
|
---|
39 | <listitem>
|
---|
40 | <para>
|
---|
41 | PCI pass-through (Linux hosts only)
|
---|
42 | </para>
|
---|
43 | </listitem>
|
---|
44 |
|
---|
45 | <listitem>
|
---|
46 | <para>
|
---|
47 | Mac OS X guests (Mac OS X hosts only)
|
---|
48 | </para>
|
---|
49 | </listitem>
|
---|
50 |
|
---|
51 | <listitem>
|
---|
52 | <para>
|
---|
53 | ICH9 chipset emulation
|
---|
54 | </para>
|
---|
55 | </listitem>
|
---|
56 |
|
---|
57 | <listitem>
|
---|
58 | <para>
|
---|
59 | EFI firmware
|
---|
60 | </para>
|
---|
61 | </listitem>
|
---|
62 |
|
---|
63 | <listitem>
|
---|
64 | <para>
|
---|
65 | Host CD/DVD drive pass-through
|
---|
66 | </para>
|
---|
67 | </listitem>
|
---|
68 |
|
---|
69 | <listitem>
|
---|
70 | <para>
|
---|
71 | Support of iSCSI using internal networking
|
---|
72 | </para>
|
---|
73 | </listitem>
|
---|
74 |
|
---|
75 | <listitem>
|
---|
76 | <para>
|
---|
77 | Using &product-name; and Hyper-V on the same host
|
---|
78 | </para>
|
---|
79 | </listitem>
|
---|
80 |
|
---|
81 | </itemizedlist>
|
---|
82 |
|
---|
83 | </sect1>
|
---|
84 |
|
---|
85 | <sect1 id="KnownProblems">
|
---|
86 |
|
---|
87 | <title>Known Issues</title>
|
---|
88 |
|
---|
89 | <para>
|
---|
90 | The following section describes known problems with this release
|
---|
91 | of &product-name;. Unless marked otherwise, these issues are
|
---|
92 | planned to be fixed in later releases.
|
---|
93 | </para>
|
---|
94 |
|
---|
95 | <itemizedlist>
|
---|
96 |
|
---|
97 | <listitem>
|
---|
98 | <para>
|
---|
99 | The following <emphasis role="bold">Guest SMP (multiprocessor)
|
---|
100 | limitations</emphasis> exist:
|
---|
101 | </para>
|
---|
102 |
|
---|
103 | <itemizedlist>
|
---|
104 |
|
---|
105 | <listitem>
|
---|
106 | <para>
|
---|
107 | <emphasis role="bold">Poor performance</emphasis> with
|
---|
108 | 32-bit guests on AMD CPUs. This affects mainly Windows and
|
---|
109 | Oracle Solaris guests, but possibly also some Linux kernel
|
---|
110 | revisions. Partially solved in 3.0.6 for 32-bit Windows
|
---|
111 | NT, 2000, XP, and 2003 guests. Requires Guest Additions
|
---|
112 | 3.0.6 or later to be installed.
|
---|
113 | </para>
|
---|
114 | </listitem>
|
---|
115 |
|
---|
116 | <listitem>
|
---|
117 | <para>
|
---|
118 | <emphasis role="bold">Poor performance</emphasis> with
|
---|
119 | 32-bit guests on certain Intel CPU models that do not
|
---|
120 | include virtual APIC hardware optimization support. This
|
---|
121 | affects mainly Windows and Oracle Solaris guests, but
|
---|
122 | possibly also some Linux kernel revisions. Partially
|
---|
123 | solved in 3.0.12 for 32-bit Windows NT, 2000, XP, and 2003
|
---|
124 | guests. Requires Guest Additions 3.0.12 or later to be
|
---|
125 | installed.
|
---|
126 | </para>
|
---|
127 | </listitem>
|
---|
128 |
|
---|
129 | </itemizedlist>
|
---|
130 | </listitem>
|
---|
131 |
|
---|
132 | <listitem>
|
---|
133 | <para>
|
---|
134 | <emphasis role="bold">NX (no execute, data execution
|
---|
135 | prevention)</emphasis> only works for guests running on 64-bit
|
---|
136 | hosts or guests running on 32-bit hosts with PAE enabled and
|
---|
137 | requires that hardware virtualization be enabled.
|
---|
138 | </para>
|
---|
139 | </listitem>
|
---|
140 |
|
---|
141 | <listitem>
|
---|
142 | <para>
|
---|
143 | For <emphasis role="bold">basic Direct3D support in Windows
|
---|
144 | guests</emphasis> to work, the Guest Additions must be
|
---|
145 | installed in Windows safe mode. Press F8 when the Windows
|
---|
146 | guest is booting and select <emphasis role="bold">Safe
|
---|
147 | Mode</emphasis>, then install the Guest Additions. Otherwise
|
---|
148 | the Windows file protection mechanism will interfere with the
|
---|
149 | replacement DLLs installed by &product-name; and keep
|
---|
150 | restoring the original Windows system DLLs.
|
---|
151 | </para>
|
---|
152 |
|
---|
153 | <note>
|
---|
154 | <para>
|
---|
155 | This does <emphasis>not</emphasis> apply to the WDDM
|
---|
156 | Direct3D video driver available for Vista and Windows 7
|
---|
157 | guests shipped with &product-name; 4.1.
|
---|
158 | </para>
|
---|
159 | </note>
|
---|
160 | </listitem>
|
---|
161 |
|
---|
162 | <listitem>
|
---|
163 | <para>
|
---|
164 | <emphasis role="bold">Guest control.</emphasis> On Windows
|
---|
165 | guests, a process started using the guest control execute
|
---|
166 | support will not be able to display a graphical user interface
|
---|
167 | <emphasis>unless</emphasis> the user account under which it is
|
---|
168 | running is currently logged in and has a desktop session.
|
---|
169 | </para>
|
---|
170 |
|
---|
171 | <para>
|
---|
172 | Also, to use accounts without or with an empty password, the
|
---|
173 | guest's group policy must be changed. To do so, open the group
|
---|
174 | policy editor on the command line by typing
|
---|
175 | <command>gpedit.msc</command>, open the key
|
---|
176 | <computeroutput>Computer Configuration\Windows
|
---|
177 | Settings\Security Settings\Local Policies\Security
|
---|
178 | Options</computeroutput> and change the value of
|
---|
179 | <computeroutput>Accounts: Limit local account use of blank
|
---|
180 | passwords to console logon only</computeroutput> to Disabled.
|
---|
181 | </para>
|
---|
182 | </listitem>
|
---|
183 |
|
---|
184 | <listitem>
|
---|
185 | <para>
|
---|
186 | <emphasis role="bold">Compacting virtual disk images is
|
---|
187 | limited to VDI files.</emphasis> The <command>VBoxManage
|
---|
188 | modifyhd --compact</command> command is currently only
|
---|
189 | implemented for VDI files. At the moment the only way to
|
---|
190 | optimize the size of a virtual disk images in other formats,
|
---|
191 | such as VMDK or VHD, is to clone the image and then use the
|
---|
192 | cloned image in the VM configuration.
|
---|
193 | </para>
|
---|
194 | </listitem>
|
---|
195 |
|
---|
196 | <listitem>
|
---|
197 | <para>
|
---|
198 | <emphasis role="bold">OVF import/export:</emphasis>
|
---|
199 | </para>
|
---|
200 |
|
---|
201 | <itemizedlist>
|
---|
202 |
|
---|
203 | <listitem>
|
---|
204 | <para>
|
---|
205 | OVF localization, with multiple languages in a single OVF
|
---|
206 | file, is not yet supported.
|
---|
207 | </para>
|
---|
208 | </listitem>
|
---|
209 |
|
---|
210 | <listitem>
|
---|
211 | <para>
|
---|
212 | Some OVF sections like StartupSection,
|
---|
213 | DeploymentOptionSection, and InstallSection are ignored.
|
---|
214 | </para>
|
---|
215 | </listitem>
|
---|
216 |
|
---|
217 | <listitem>
|
---|
218 | <para>
|
---|
219 | OVF environment documents, including their property
|
---|
220 | sections and appliance configuration with ISO images, are
|
---|
221 | not yet supported.
|
---|
222 | </para>
|
---|
223 | </listitem>
|
---|
224 |
|
---|
225 | <listitem>
|
---|
226 | <para>
|
---|
227 | Remote files using HTTP or other mechanisms are not yet
|
---|
228 | supported.
|
---|
229 | </para>
|
---|
230 | </listitem>
|
---|
231 |
|
---|
232 | </itemizedlist>
|
---|
233 | </listitem>
|
---|
234 |
|
---|
235 | <listitem>
|
---|
236 | <para>
|
---|
237 | Neither <emphasis role="bold">scale mode</emphasis> nor
|
---|
238 | <emphasis
|
---|
239 | role="bold">seamless mode</emphasis> work
|
---|
240 | correctly with guests using OpenGL 3D features, such as with
|
---|
241 | compiz-enabled window managers.
|
---|
242 | </para>
|
---|
243 | </listitem>
|
---|
244 |
|
---|
245 | <listitem>
|
---|
246 | <para>
|
---|
247 | The RDP server in the &product-name; extension pack supports
|
---|
248 | only audio streams in format 22.05kHz stereo 16 bit. If the
|
---|
249 | RDP client requests any other audio format there will be no
|
---|
250 | audio.
|
---|
251 | </para>
|
---|
252 | </listitem>
|
---|
253 |
|
---|
254 | <listitem>
|
---|
255 | <para>
|
---|
256 | Preserving the aspect ratio in scale mode works only on
|
---|
257 | Windows hosts and on Mac OS X hosts.
|
---|
258 | </para>
|
---|
259 | </listitem>
|
---|
260 |
|
---|
261 | <listitem>
|
---|
262 | <para>
|
---|
263 | On <emphasis role="bold">Mac OS X hosts,</emphasis> the
|
---|
264 | following features are not yet implemented:
|
---|
265 | </para>
|
---|
266 |
|
---|
267 | <itemizedlist>
|
---|
268 |
|
---|
269 | <listitem>
|
---|
270 | <para>
|
---|
271 | Numlock emulation
|
---|
272 | </para>
|
---|
273 | </listitem>
|
---|
274 |
|
---|
275 | <listitem>
|
---|
276 | <para>
|
---|
277 | CPU frequency metric
|
---|
278 | </para>
|
---|
279 | </listitem>
|
---|
280 |
|
---|
281 | <listitem>
|
---|
282 | <para>
|
---|
283 | Memory ballooning
|
---|
284 | </para>
|
---|
285 | </listitem>
|
---|
286 |
|
---|
287 | </itemizedlist>
|
---|
288 | </listitem>
|
---|
289 |
|
---|
290 | <listitem>
|
---|
291 | <para>
|
---|
292 | <emphasis role="bold">Mac OS X guests:</emphasis>
|
---|
293 | </para>
|
---|
294 |
|
---|
295 | <itemizedlist>
|
---|
296 |
|
---|
297 | <listitem>
|
---|
298 | <para>
|
---|
299 | Mac OS X guests can only run on a certain host hardware.
|
---|
300 | For details about license and host hardware limitations.
|
---|
301 | See <xref linkend="intro-macosxguests" /> and check the
|
---|
302 | Apple software license conditions.
|
---|
303 | </para>
|
---|
304 | </listitem>
|
---|
305 |
|
---|
306 | <listitem>
|
---|
307 | <para>
|
---|
308 | &product-name; does not provide Guest Additions for Mac OS
|
---|
309 | X at this time.
|
---|
310 | </para>
|
---|
311 | </listitem>
|
---|
312 |
|
---|
313 | <listitem>
|
---|
314 | <para>
|
---|
315 | The graphics resolution currently defaults to 1024x768 as
|
---|
316 | Mac OS X falls back to the built-in EFI display support.
|
---|
317 | See <xref linkend="efividmode" /> for more information on
|
---|
318 | how to change EFI video modes.
|
---|
319 | </para>
|
---|
320 | </listitem>
|
---|
321 |
|
---|
322 | <listitem>
|
---|
323 | <para>
|
---|
324 | Mac OS X guests only work with one CPU assigned to the VM.
|
---|
325 | Support for SMP will be provided in a future release.
|
---|
326 | </para>
|
---|
327 | </listitem>
|
---|
328 |
|
---|
329 | <listitem>
|
---|
330 | <para>
|
---|
331 | Depending on your system and version of Mac OS X, you
|
---|
332 | might experience guest hangs after some time. This can be
|
---|
333 | fixed by turning off energy saving. Set timeout to "Never"
|
---|
334 | in the system preferences.
|
---|
335 | </para>
|
---|
336 | </listitem>
|
---|
337 |
|
---|
338 | <listitem>
|
---|
339 | <para>
|
---|
340 | By default, the &product-name; EFI enables debug output of
|
---|
341 | the Mac OS X kernel to help you diagnose boot problems.
|
---|
342 | Note that there is a lot of output and not all errors are
|
---|
343 | fatal. They would also show when using a physical Apple
|
---|
344 | Macintosh computer. You can turn off these messages by
|
---|
345 | using the following command:
|
---|
346 | </para>
|
---|
347 |
|
---|
348 | <screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" " "</screen>
|
---|
349 |
|
---|
350 | <para>
|
---|
351 | To revert to the previous behavior, use the following
|
---|
352 | command:
|
---|
353 | </para>
|
---|
354 |
|
---|
355 | <screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" ""</screen>
|
---|
356 | </listitem>
|
---|
357 |
|
---|
358 | <listitem>
|
---|
359 | <para>
|
---|
360 | It is currently not possible to start a Mac OS X guest in
|
---|
361 | safe mode by specifying "-x" option in
|
---|
362 | "VBoxInternal2/EfiBootArgs" extradata.
|
---|
363 | </para>
|
---|
364 | </listitem>
|
---|
365 |
|
---|
366 | </itemizedlist>
|
---|
367 | </listitem>
|
---|
368 |
|
---|
369 | <listitem>
|
---|
370 | <para>
|
---|
371 | <emphasis role="bold">Oracle Solaris hosts:</emphasis>
|
---|
372 | </para>
|
---|
373 |
|
---|
374 | <itemizedlist>
|
---|
375 |
|
---|
376 | <listitem>
|
---|
377 | <para>
|
---|
378 | There is no support for USB devices connected to Oracle
|
---|
379 | Solaris 10 hosts.
|
---|
380 | </para>
|
---|
381 | </listitem>
|
---|
382 |
|
---|
383 | <listitem>
|
---|
384 | <para>
|
---|
385 | USB support on Oracle Solaris hosts requires Oracle
|
---|
386 | Solaris 11 version snv_124 or later. Webcams and other
|
---|
387 | isochronous devices are known to have poor performance.
|
---|
388 | </para>
|
---|
389 | </listitem>
|
---|
390 |
|
---|
391 | <listitem>
|
---|
392 | <para>
|
---|
393 | Host Webcam passthrough is restricted to 640x480 frames at
|
---|
394 | 20 frames per second due to limitations in the Oracle
|
---|
395 | Solaris V4L2 API. This may be addressed in a future Oracle
|
---|
396 | Solaris release.
|
---|
397 | </para>
|
---|
398 | </listitem>
|
---|
399 |
|
---|
400 | <listitem>
|
---|
401 | <para>
|
---|
402 | No ACPI information, such as battery status or power
|
---|
403 | source, is reported to the guest.
|
---|
404 | </para>
|
---|
405 | </listitem>
|
---|
406 |
|
---|
407 | <listitem>
|
---|
408 | <para>
|
---|
409 | No support for using wireless adapters with bridged
|
---|
410 | networking.
|
---|
411 | </para>
|
---|
412 | </listitem>
|
---|
413 |
|
---|
414 | <listitem>
|
---|
415 | <para>
|
---|
416 | Crossbow-based bridged networking on Oracle Solaris 11
|
---|
417 | hosts does not work directly with aggregate links.
|
---|
418 | However, you can use
|
---|
419 | <computeroutput>dladm</computeroutput> to manually create
|
---|
420 | a VNIC over the aggregate link and use that with a VM.
|
---|
421 | This limitation does not exist in Oracle Solaris 11u1
|
---|
422 | build 17 and newer.
|
---|
423 | </para>
|
---|
424 | </listitem>
|
---|
425 |
|
---|
426 | </itemizedlist>
|
---|
427 | </listitem>
|
---|
428 |
|
---|
429 | <listitem>
|
---|
430 | <para>
|
---|
431 | <emphasis role="bold">Guest Additions of version 4.1, 4.1.2
|
---|
432 | and 4.1.4 for Windows.</emphasis> The &product-name; WDDM
|
---|
433 | Video driver may be installed and remain in the guest system
|
---|
434 | when Guest additions uninstallation is performed. This is
|
---|
435 | caused by a bug in Guest Additions uninstaller.
|
---|
436 | </para>
|
---|
437 |
|
---|
438 | <note>
|
---|
439 | <para>
|
---|
440 | This does <emphasis>not</emphasis> apply to a Guest
|
---|
441 | Additions update. Installing one version of Guest Additions
|
---|
442 | on top of another works correctly.
|
---|
443 | </para>
|
---|
444 | </note>
|
---|
445 |
|
---|
446 | <para>
|
---|
447 | To solve this problem, uninstall the &product-name; WDDM Video
|
---|
448 | driver manually. Open Device Manager, and check whether the
|
---|
449 | Display Adapter is named "&product-name; Graphics Adapter ..".
|
---|
450 | If not, there is nothing to be done. If it is, right-click the
|
---|
451 | &product-name; Graphics Adapter in Device Manager, select
|
---|
452 | <emphasis role="bold">Uninstall</emphasis>, check
|
---|
453 | <emphasis role="bold">Delete the Driver Software for this
|
---|
454 | Device</emphasis> and click
|
---|
455 | <emphasis role="bold">OK</emphasis>. Once uninstallation is
|
---|
456 | done, start Device Manager, go to the
|
---|
457 | <emphasis role="bold">Action</emphasis> menu and select
|
---|
458 | <emphasis role="bold">Scan for Hardware Change</emphasis>s to
|
---|
459 | ensure that the correct Windows default driver be picked up
|
---|
460 | for the Graphics adapter.
|
---|
461 | </para>
|
---|
462 | </listitem>
|
---|
463 |
|
---|
464 | <listitem>
|
---|
465 | <para>
|
---|
466 | Neither <emphasis>virtio</emphasis> nor <emphasis>Intel
|
---|
467 | PRO/1000 </emphasis> drivers for <emphasis role="bold">Windows
|
---|
468 | XP guests</emphasis> support segmentation offloading.
|
---|
469 | Therefore Windows XP guests have slower transmission rates
|
---|
470 | comparing to other guest types. Refer to MS Knowledge base
|
---|
471 | article 842264 for additional information.
|
---|
472 | </para>
|
---|
473 | </listitem>
|
---|
474 |
|
---|
475 | <listitem>
|
---|
476 | <para>
|
---|
477 | <emphasis role="bold">Guest Additions for OS/2.</emphasis>
|
---|
478 | Seamless windows and automatic guest resizing will probably
|
---|
479 | never be implemented due to inherent limitations of the OS/2
|
---|
480 | graphics system.
|
---|
481 | </para>
|
---|
482 | </listitem>
|
---|
483 |
|
---|
484 | <listitem>
|
---|
485 | <para>
|
---|
486 | Some guest operating systems predating ATAPI CD-ROMs may
|
---|
487 | exhibit long delays or entirely fail to boot in certain
|
---|
488 | configurations. This is most likely to happen when an
|
---|
489 | IDE/ATAPI CD-ROM exists alone on a primary or secondary IDE
|
---|
490 | channel.
|
---|
491 | </para>
|
---|
492 |
|
---|
493 | <para>
|
---|
494 | Affected operating systems are MS OS/2 1.21: fails to boot
|
---|
495 | with an error message referencing COUNTRY.SYS and MS OS/2 1.3:
|
---|
496 | long boot delays. To avoid such problems, disable the emulated
|
---|
497 | IDE/ATAPI CD-ROM. The guest OS cannot use this device, anyway.
|
---|
498 | </para>
|
---|
499 | </listitem>
|
---|
500 |
|
---|
501 | </itemizedlist>
|
---|
502 |
|
---|
503 | </sect1>
|
---|
504 |
|
---|
505 | </chapter>
|
---|