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>
|
---|