| 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 passthrough (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 passthrough
|
|---|
| 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 for 32-bit Windows NT, 2000,
|
|---|
| 111 | XP, and 2003 guests. Requires the Guest Additions to be
|
|---|
| 112 | 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 for 32-bit Windows NT, 2000, XP, and 2003 guests.
|
|---|
| 124 | Requires the Guest Additions to be installed.
|
|---|
| 125 | </para>
|
|---|
| 126 | </listitem>
|
|---|
| 127 |
|
|---|
| 128 | </itemizedlist>
|
|---|
| 129 | </listitem>
|
|---|
| 130 |
|
|---|
| 131 | <listitem>
|
|---|
| 132 | <para>
|
|---|
| 133 | <emphasis role="bold">NX (no execute, data execution
|
|---|
| 134 | prevention)</emphasis> only works for guests running on 64-bit
|
|---|
| 135 | hosts and requires that hardware virtualization be enabled.
|
|---|
| 136 | </para>
|
|---|
| 137 | </listitem>
|
|---|
| 138 |
|
|---|
| 139 | <listitem>
|
|---|
| 140 | <para>
|
|---|
| 141 | <emphasis role="bold">Guest control.</emphasis> On Windows
|
|---|
| 142 | guests, a process started using the guest control execute
|
|---|
| 143 | support will not be able to display a graphical user interface
|
|---|
| 144 | <emphasis>unless</emphasis> the user account under which it is
|
|---|
| 145 | running is currently logged in and has a desktop session.
|
|---|
| 146 | </para>
|
|---|
| 147 |
|
|---|
| 148 | <para>
|
|---|
| 149 | Also, to use accounts without or with an empty password, the
|
|---|
| 150 | guest's group policy must be changed. To do so, open the group
|
|---|
| 151 | policy editor on the command line by typing
|
|---|
| 152 | <command>gpedit.msc</command>, open the key <literal>Computer
|
|---|
| 153 | Configuration\Windows Settings\Security Settings\Local
|
|---|
| 154 | Policies\Security Options</literal> and change the value of
|
|---|
| 155 | <literal>Accounts: Limit local account use of blank passwords
|
|---|
| 156 | to console logon only</literal> to Disabled.
|
|---|
| 157 | </para>
|
|---|
| 158 | </listitem>
|
|---|
| 159 |
|
|---|
| 160 | <listitem>
|
|---|
| 161 | <para>
|
|---|
| 162 | <emphasis role="bold">Compacting virtual disk images is
|
|---|
| 163 | limited to VDI files.</emphasis> The <command>VBoxManage
|
|---|
| 164 | modifymedium --compact</command> command is currently only
|
|---|
| 165 | implemented for VDI files. At the moment the only way to
|
|---|
| 166 | optimize the size of a virtual disk images in other formats,
|
|---|
| 167 | such as VMDK or VHD, is to clone the image and then use the
|
|---|
| 168 | cloned image in the VM configuration.
|
|---|
| 169 | </para>
|
|---|
| 170 | </listitem>
|
|---|
| 171 |
|
|---|
| 172 | <listitem>
|
|---|
| 173 | <para>
|
|---|
| 174 | <emphasis role="bold">OVF import/export:</emphasis>
|
|---|
| 175 | </para>
|
|---|
| 176 |
|
|---|
| 177 | <itemizedlist>
|
|---|
| 178 |
|
|---|
| 179 | <listitem>
|
|---|
| 180 | <para>
|
|---|
| 181 | OVF localization, with multiple languages in a single OVF
|
|---|
| 182 | file, is not yet supported.
|
|---|
| 183 | </para>
|
|---|
| 184 | </listitem>
|
|---|
| 185 |
|
|---|
| 186 | <listitem>
|
|---|
| 187 | <para>
|
|---|
| 188 | Some OVF sections like StartupSection,
|
|---|
| 189 | DeploymentOptionSection, and InstallSection are ignored.
|
|---|
| 190 | </para>
|
|---|
| 191 | </listitem>
|
|---|
| 192 |
|
|---|
| 193 | <listitem>
|
|---|
| 194 | <para>
|
|---|
| 195 | OVF environment documents, including their property
|
|---|
| 196 | sections and appliance configuration with ISO images, are
|
|---|
| 197 | not yet supported.
|
|---|
| 198 | </para>
|
|---|
| 199 | </listitem>
|
|---|
| 200 |
|
|---|
| 201 | <listitem>
|
|---|
| 202 | <para>
|
|---|
| 203 | Remote files using HTTP or other mechanisms are not yet
|
|---|
| 204 | supported.
|
|---|
| 205 | </para>
|
|---|
| 206 | </listitem>
|
|---|
| 207 |
|
|---|
| 208 | </itemizedlist>
|
|---|
| 209 | </listitem>
|
|---|
| 210 |
|
|---|
| 211 | <listitem>
|
|---|
| 212 | <para>
|
|---|
| 213 | Neither <emphasis role="bold">scale mode</emphasis> nor
|
|---|
| 214 | <emphasis role="bold">seamless mode</emphasis> work correctly
|
|---|
| 215 | with guests using OpenGL 3D features, such as with
|
|---|
| 216 | Compiz-enabled window managers.
|
|---|
| 217 | </para>
|
|---|
| 218 | </listitem>
|
|---|
| 219 |
|
|---|
| 220 | <listitem>
|
|---|
| 221 | <para>
|
|---|
| 222 | The RDP server in the &product-name; extension pack supports
|
|---|
| 223 | only audio streams in format 22.05kHz stereo 16-bit. If the
|
|---|
| 224 | RDP client requests any other audio format there will be no
|
|---|
| 225 | audio.
|
|---|
| 226 | </para>
|
|---|
| 227 | </listitem>
|
|---|
| 228 |
|
|---|
| 229 | <listitem>
|
|---|
| 230 | <para>
|
|---|
| 231 | Preserving the aspect ratio in scale mode works only on
|
|---|
| 232 | Windows hosts and on Mac OS X hosts.
|
|---|
| 233 | </para>
|
|---|
| 234 | </listitem>
|
|---|
| 235 |
|
|---|
| 236 | <listitem>
|
|---|
| 237 | <para>
|
|---|
| 238 | On <emphasis role="bold">Mac OS X hosts,</emphasis> the
|
|---|
| 239 | following features are not yet implemented:
|
|---|
| 240 | </para>
|
|---|
| 241 |
|
|---|
| 242 | <itemizedlist>
|
|---|
| 243 |
|
|---|
| 244 | <listitem>
|
|---|
| 245 | <para>
|
|---|
| 246 | Numlock emulation
|
|---|
| 247 | </para>
|
|---|
| 248 | </listitem>
|
|---|
| 249 |
|
|---|
| 250 | <listitem>
|
|---|
| 251 | <para>
|
|---|
| 252 | CPU frequency metric
|
|---|
| 253 | </para>
|
|---|
| 254 | </listitem>
|
|---|
| 255 |
|
|---|
| 256 | <listitem>
|
|---|
| 257 | <para>
|
|---|
| 258 | Memory ballooning
|
|---|
| 259 | </para>
|
|---|
| 260 | </listitem>
|
|---|
| 261 |
|
|---|
| 262 | </itemizedlist>
|
|---|
| 263 | </listitem>
|
|---|
| 264 |
|
|---|
| 265 | <listitem>
|
|---|
| 266 | <para>
|
|---|
| 267 | <emphasis role="bold">Mac OS X guests:</emphasis>
|
|---|
| 268 | </para>
|
|---|
| 269 |
|
|---|
| 270 | <itemizedlist>
|
|---|
| 271 |
|
|---|
| 272 | <listitem>
|
|---|
| 273 | <para>
|
|---|
| 274 | Mac OS X guests can only run on a certain host hardware.
|
|---|
| 275 | For details about license and host hardware limitations.
|
|---|
| 276 | See <xref linkend="intro-macosxguests" /> and check the
|
|---|
| 277 | Apple software license conditions.
|
|---|
| 278 | </para>
|
|---|
| 279 | </listitem>
|
|---|
| 280 |
|
|---|
| 281 | <listitem>
|
|---|
| 282 | <para>
|
|---|
| 283 | &product-name; does not provide Guest Additions for Mac OS
|
|---|
| 284 | X at this time.
|
|---|
| 285 | </para>
|
|---|
| 286 | </listitem>
|
|---|
| 287 |
|
|---|
| 288 | <listitem>
|
|---|
| 289 | <para>
|
|---|
| 290 | The graphics resolution currently defaults to 1024x768 as
|
|---|
| 291 | Mac OS X falls back to the built-in EFI display support.
|
|---|
| 292 | See <xref linkend="efividmode" /> for more information on
|
|---|
| 293 | how to change EFI video modes.
|
|---|
| 294 | </para>
|
|---|
| 295 | </listitem>
|
|---|
| 296 |
|
|---|
| 297 | <listitem>
|
|---|
| 298 | <para>
|
|---|
| 299 | Mac OS X guests only work with one CPU assigned to the VM.
|
|---|
| 300 | Support for SMP will be provided in a future release.
|
|---|
| 301 | </para>
|
|---|
| 302 | </listitem>
|
|---|
| 303 |
|
|---|
| 304 | <listitem>
|
|---|
| 305 | <para>
|
|---|
| 306 | Depending on your system and version of Mac OS X, you
|
|---|
| 307 | might experience guest hangs after some time. This can be
|
|---|
| 308 | fixed by turning off energy saving. Set the timeout to
|
|---|
| 309 | "Never" in the system preferences.
|
|---|
| 310 | </para>
|
|---|
| 311 | </listitem>
|
|---|
| 312 |
|
|---|
| 313 | <listitem>
|
|---|
| 314 | <para>
|
|---|
| 315 | By default, the &product-name; EFI enables debug output of
|
|---|
| 316 | the Mac OS X kernel to help you diagnose boot problems.
|
|---|
| 317 | Note that there is a lot of output and not all errors are
|
|---|
| 318 | fatal. They would also show when using a physical Apple
|
|---|
| 319 | Macintosh computer. You can turn off these messages by
|
|---|
| 320 | using the following command:
|
|---|
| 321 | </para>
|
|---|
| 322 |
|
|---|
| 323 | <screen>$ VBoxManage setextradata <replaceable>VM-name</replaceable> "VBoxInternal2/EfiBootArgs" " "</screen>
|
|---|
| 324 |
|
|---|
| 325 | <para>
|
|---|
| 326 | To revert to the previous behavior, use the following
|
|---|
| 327 | command:
|
|---|
| 328 | </para>
|
|---|
| 329 |
|
|---|
| 330 | <screen>$ VBoxManage setextradata <replaceable>VM-name</replaceable> "VBoxInternal2/EfiBootArgs" ""</screen>
|
|---|
| 331 | </listitem>
|
|---|
| 332 |
|
|---|
| 333 | <listitem>
|
|---|
| 334 | <para>
|
|---|
| 335 | It is currently not possible to start a Mac OS X guest in
|
|---|
| 336 | safe mode by specifying the <option>-x</option> option in
|
|---|
| 337 | <literal>VBoxInternal2/EfiBootArgs</literal> extradata.
|
|---|
| 338 | </para>
|
|---|
| 339 | </listitem>
|
|---|
| 340 |
|
|---|
| 341 | </itemizedlist>
|
|---|
| 342 | </listitem>
|
|---|
| 343 |
|
|---|
| 344 | <listitem>
|
|---|
| 345 | <para>
|
|---|
| 346 | <emphasis role="bold">Oracle Solaris hosts:</emphasis>
|
|---|
| 347 | </para>
|
|---|
| 348 |
|
|---|
| 349 | <itemizedlist>
|
|---|
| 350 |
|
|---|
| 351 | <listitem>
|
|---|
| 352 | <para>
|
|---|
| 353 | USB support on Oracle Solaris hosts requires Oracle
|
|---|
| 354 | Solaris 11 version snv_124 or later. Webcams and other
|
|---|
| 355 | isochronous devices are known to have poor performance.
|
|---|
| 356 | </para>
|
|---|
| 357 | </listitem>
|
|---|
| 358 |
|
|---|
| 359 | <listitem>
|
|---|
| 360 | <para>
|
|---|
| 361 | Host Webcam passthrough is restricted to 640x480 frames at
|
|---|
| 362 | 20 frames per second due to limitations in the Oracle
|
|---|
| 363 | Solaris V4L2 API. This may be addressed in a future Oracle
|
|---|
| 364 | Solaris release.
|
|---|
| 365 | </para>
|
|---|
| 366 | </listitem>
|
|---|
| 367 |
|
|---|
| 368 | <listitem>
|
|---|
| 369 | <para>
|
|---|
| 370 | No ACPI information, such as battery status or power
|
|---|
| 371 | source, is reported to the guest.
|
|---|
| 372 | </para>
|
|---|
| 373 | </listitem>
|
|---|
| 374 |
|
|---|
| 375 | <listitem>
|
|---|
| 376 | <para>
|
|---|
| 377 | No support for using wireless adapters with bridged
|
|---|
| 378 | networking.
|
|---|
| 379 | </para>
|
|---|
| 380 | </listitem>
|
|---|
| 381 |
|
|---|
| 382 | <listitem>
|
|---|
| 383 | <para>
|
|---|
| 384 | Crossbow-based bridged networking on Oracle Solaris 11
|
|---|
| 385 | hosts does not work directly with aggregate links.
|
|---|
| 386 | However, you can use <command>dladm</command> to manually
|
|---|
| 387 | create a VNIC over the aggregate link and use that with a
|
|---|
| 388 | VM. This limitation does not exist in Oracle Solaris 11u1
|
|---|
| 389 | build 17 and later.
|
|---|
| 390 | </para>
|
|---|
| 391 | </listitem>
|
|---|
| 392 |
|
|---|
| 393 | </itemizedlist>
|
|---|
| 394 | </listitem>
|
|---|
| 395 |
|
|---|
| 396 | <listitem>
|
|---|
| 397 | <para>
|
|---|
| 398 | Neither virtio nor Intel PRO/1000 drivers for
|
|---|
| 399 | <emphasis role="bold">Windows XP guests</emphasis> support
|
|---|
| 400 | segmentation offloading. Therefore Windows XP guests have
|
|---|
| 401 | slower transmission rates comparing to other guest types.
|
|---|
| 402 | Refer to MS Knowledge base article 842264 for additional
|
|---|
| 403 | information.
|
|---|
| 404 | </para>
|
|---|
| 405 | </listitem>
|
|---|
| 406 |
|
|---|
| 407 | <listitem>
|
|---|
| 408 | <para>
|
|---|
| 409 | <emphasis role="bold">Guest Additions for OS/2.</emphasis>
|
|---|
| 410 | Seamless windows and automatic guest resizing will probably
|
|---|
| 411 | never be implemented due to inherent limitations of the OS/2
|
|---|
| 412 | graphics system.
|
|---|
| 413 | </para>
|
|---|
| 414 | </listitem>
|
|---|
| 415 |
|
|---|
| 416 | <listitem>
|
|---|
| 417 | <para>
|
|---|
| 418 | Some guest operating systems predating ATAPI CD-ROMs may
|
|---|
| 419 | exhibit long delays or entirely fail to boot in certain
|
|---|
| 420 | configurations. This is most likely to happen when an
|
|---|
| 421 | IDE/ATAPI CD-ROM exists alone on a primary or secondary IDE
|
|---|
| 422 | channel.
|
|---|
| 423 | </para>
|
|---|
| 424 |
|
|---|
| 425 | <para>
|
|---|
| 426 | Affected operating systems are MS OS/2 1.21: fails to boot
|
|---|
| 427 | with an error message referencing COUNTRY.SYS and MS OS/2 1.3:
|
|---|
| 428 | long boot delays. To avoid such problems, disable the emulated
|
|---|
| 429 | IDE/ATAPI CD-ROM. The guest OS cannot use this device, anyway.
|
|---|
| 430 | </para>
|
|---|
| 431 | </listitem>
|
|---|
| 432 |
|
|---|
| 433 | </itemizedlist>
|
|---|
| 434 |
|
|---|
| 435 | </sect1>
|
|---|
| 436 |
|
|---|
| 437 | </chapter>
|
|---|
