VirtualBox

source: vbox/trunk/doc/manual/en_US/user_KnownIssues.xml@ 99216

Last change on this file since 99216 was 98103, checked in by vboxsync, 2 years ago

Copyright year updates by scm.

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