Sun VirtualBox
®
User Manual
Sun Microsystems, Inc.
Copyright © 2004-2010 Sun Microsystems, Inc.
Table of Contents
1. First steps
Why is virtualization useful?
Some terminology
Features overview
Supported host operating systems
Installing and starting VirtualBox
Creating your first virtual machine
Running your virtual machine
Keyboard and mouse support in virtual machines
Changing removable media
Saving the state of the machine
Snapshots
Virtual machine configuration
Deleting virtual machines
Importing and exporting virtual machines
Alternative front-ends
2. Installation details
Installing on Windows hosts
Prerequisites
Performing the installation
Uninstallation
Unattended installation
Installing on Mac OS X hosts
Performing the installation
Uninstallation
Unattended installation
Installing on Linux hosts
Prerequisites
The VirtualBox kernel module
USB and advanced networking support
Performing the installation
Starting VirtualBox on Linux
Installing on Solaris hosts
Performing the installation
Starting VirtualBox on Solaris
Uninstallation
Unattended installation
Configuring a zone for running VirtualBox
3. Configuring virtual machines
Supported guest operating systems
64-bit guests
General settings
"Basic" tab
"Advanced" tab
"Description" tab
System settings
"Motherboard" tab
"Processor" tab
"Acceleration" tab: hardware vs. software virtualization
Display settings
Storage settings
Audio settings
Network settings
Serial ports
USB support
USB settings
Implementation notes for Windows and Linux hosts
Shared folders
Alternative firmware (EFI)
4. Guest Additions
Introduction
Versions
Windows Guest Additions
Installing the Windows Guest Additions
Updating the Windows Guest Additions
Unattended Installation
Manual file extraction
Windows Vista networking
Linux Guest Additions
Installing the Linux Guest Additions
Video acceleration and high resolution graphics modes
Updating the Linux Guest Additions
Solaris Guest Additions
Installing the Solaris Guest Additions
Uninstalling the Solaris Guest Additions
Updating the Solaris Guest Additions
OS/2 Guest Additions
Folder sharing
Seamless windows
Hardware 3D acceleration (OpenGL and Direct3D 8/9)
Hardware 2D video acceleration for Windows guests
Guest properties
5. Virtual storage
Hard disk controllers: IDE, SATA (AHCI), SCSI
Disk image files (VDI, VMDK, VHD, HDD)
The Virtual Media Manager
Special image write modes
Differencing images
Cloning disk images
CD/DVD drive operation
Writing CDs and DVDs using the host drive
iSCSI servers
Access iSCSI targets via Internal Networking
6. Virtual networking
Virtual networking hardware
Introduction to networking modes
Network Address Translation (NAT)
Configuring port forwarding with NAT
PXE booting with NAT
NAT limitations
Bridged networking
Internal networking
Host-only networking
7. Remote virtual machines
Remote display (VRDP support)
Common third-party RDP viewers
VBoxHeadless, the VRDP-only server
Step by step: creating a virtual machine on a headless server
Remote USB
RDP authentication
RDP encryption
VRDP multiple connections
Teleporting
8. VBoxManage
Introduction
Commands overview
VBoxManage list
VBoxManage showvminfo
VBoxManage registervm / unregistervm
VBoxManage createvm
VBoxManage modifyvm
General settings
Networking settings
Serial port, audio, clipboard, VRDP and USB settings
Remote machine settings
Teleporting settings
VBoxManage import
VBoxManage export
VBoxManage startvm
VBoxManage controlvm
VBoxManage discardstate
VBoxManage snapshot
VBoxManage openmedium / closemedium
VBoxManage storagectl / storageattach
VBoxManage storagectl
VBoxManage storageattach
VBoxManage showhdinfo
VBoxManage createhd
VBoxManage modifyhd
VBoxManage clonehd
VBoxManage convertfromraw
VBoxManage addiscsidisk
VBoxManage getextradata/setextradata
VBoxManage setproperty
VBoxManage usbfilter add/modify/remove
VBoxManage sharedfolder add/remove
VBoxManage metrics
VBoxManage guestproperty
VBoxManage dhcpserver
9. Advanced topics
VirtualBox configuration data
VBoxSDL, the simplified VM displayer
Introduction
Secure labeling with VBoxSDL
Releasing modifiers with VBoxSDL on Linux
Advanced configuration for Windows guests
Automated Windows guest logons
Automated Windows system preparation
Advanced display configuration
Custom VESA resolutions
Multiple monitors for the guest
Configuring the maximum resolution of guests when using the graphical frontend
Custom external VRDP authentication
Advanced storage configuration
Using a raw host hard disk from a guest
Allowing a virtual machine to start even with unavailable CD/DVD/floppy devices
Configuring the hard disk vendor product data (VPD)
Launching more than 120 VMs on Solaris hosts
Legacy commands for using serial ports
Fine-tuning the VirtualBox NAT engine
Configuring the address of a NAT network interface
Configuring the boot server (next server) of a NAT network interface
Tuning TCP/IP buffers for NAT
Binding NAT sockets to a specific interface
Enabling DNS proxy in NAT mode
Using the host's resolver as a DNS proxy in NAT mode
Configuring the BIOS DMI information
Fine-tuning timers and time synchronization
Configuring the guest time stamp counter (TSC) to reflect guest execution
Accelerate or slow down the guest clock
Tuning the Guest Additions time synchronization parameters
Configuring multiple host-only network interfaces on Solaris hosts
Customizing the GUI
10. VirtualBox programming interfaces
11. Troubleshooting
General
Collecting debugging information
Guest shows IDE/SATA errors for file-based images on slow host file system
Responding to guest IDE/SATA flush requests
Windows guests
Windows bluescreens after changing VM configuration
Windows 0x101 bluescreens with SMP enabled (IPI timeout)
Windows 2000 installation failures
How to record bluescreen information from Windows guests
No networking in Windows Vista guests
Windows guests may cause a high CPU load
No audio in Windows Vista (64-bit) and Windows 7 guests
Linux and X11 guests
Linux guests may cause a high CPU load
AMD Barcelona CPUs
Buggy Linux 2.6 kernel versions
Shared clipboard, auto-resizing and seamless desktop in X11 guests
Windows hosts
VBoxSVC out-of-process COM server issues
CD/DVD changes not recognized
Sluggish response when using Microsoft RDP client
Running an iSCSI initiator and target on a single system
Linux hosts
Linux kernel module refuses to load
Linux host CD/DVD drive not found
Linux host CD/DVD drive not found (older distributions)
Linux host floppy not found
Strange guest IDE error messages when writing to CD/DVD
VBoxSVC IPC issues
USB not working
PAX/grsec kernels
Linux kernel vmalloc pool exhausted
Solaris hosts
Cannot start VM, not enough contiguous memory
VM aborts with out of memory errors on Solaris 10 hosts
12. Change log
Version 3.1.4 (2010-02-12)
Version 3.1.2 (2009-12-17)
Version 3.1.0 (2009-11-30)
Version 3.0.12 (2009-11-10)
Version 3.0.10 (2009-10-29)
Version 3.0.8 (2009-10-02)
Version 3.0.6 (2009-09-09)
Version 3.0.4 (2009-08-04)
Version 3.0.2 (2009-07-10)
Version 3.0.0 (2009-06-30)
Version 2.2.4 (2009-05-29)
Version 2.2.2 (2009-04-27)
Version 2.2.0 (2009-04-08)
Version 2.1.4 (2009-02-16)
Version 2.1.2 (2009-01-21)
Version 2.1.0 (2008-12-17)
Version 2.0.8 (2009-03-10)
Version 2.0.6 (2008-11-21)
Version 2.0.4 (2008-10-24)
Version 2.0.2 (2008-09-12)
Version 2.0.0 (2008-09-04)
Version 1.6.6 (2008-08-26)
Version 1.6.4 (2008-07-30)
Version 1.6.2 (2008-05-28)
Version 1.6.0 (2008-04-30)
Version 1.5.6 (2008-02-19)
Version 1.5.4 (2007-12-29)
Version 1.5.2 (2007-10-18)
Version 1.5.0 (2007-08-31)
Version 1.4.0 (2007-06-06)
Version 1.3.8 (2007-03-14)
Version 1.3.6 (2007-02-20)
Version 1.3.4 (2007-02-12)
Version 1.3.2 (2007-01-15)
Version 1.2.4 (2006-11-16)
Version 1.2.2 (2006-11-14)
Version 1.1.12 (2006-11-14)
Version 1.1.10 (2006-07-28)
Version 1.1.8 (2006-07-17)
Version 1.1.6 (2006-04-18)
Version 1.1.4 (2006-03-09)
Version 1.1.2 (2006-02-03)
Version 1.0.50 (2005-12-16)
Version 1.0.48 (2005-11-23)
Version 1.0.46 (2005-11-04)
Version 1.0.44 (2005-10-25)
Version 1.0.42 (2005-08-30)
Version 1.0.40 (2005-06-17)
Version 1.0.39 (2005-05-05)
Version 1.0.38 (2005-04-27)
Version 1.0.37 (2005-04-12)
13. Known limitations
A. Third-party materials and licenses
Materials
Licenses
GNU General Public License (GPL)
GNU Lesser General Public License (LGPL)
Mozilla Public License (MPL)
MIT License
X Consortium License (X11)
zlib license
OpenSSL license
Slirp license
liblzf license
libpng license
lwIP license
libxml license
libxslt licenses
gSOAP Public License Version 1.3a
Chromium licenses
curl license
libgd license
BSD license from Intel
B. VirtualBox privacy policy
Glossary