Sun-microsystems VIRTUALBOX VERSION 3.1.0_BETA2 Bedienungsanleitung

Sun VirtualBoxRUser ManualVersion 3.1.0_BETA2c 2004-2009 Sun Microsystems, Inc.http://www.virtualbox.org

1 First stepsYou can find a summary of VirtualBox’s capabilities in chapter 1.3, Features overview,page 12. For existing VirtualBox users who just want

7 Alternative front-ends; remote virtual machines7.4.1 Common third-party RDP viewersYou can use any standard RDP viewer to connect to such a remote v

7 Alternative front-ends; remote virtual machinesinstallation of the guest operating system, you should set its display color depthto the same value).

7 Alternative front-ends; remote virtual machinesTo have the VRDP server use the setting from the VM configuration, as the other front-ends would, use

7 Alternative front-ends; remote virtual machines5. Register the ISO file that contains the operating system installation that you wantto install later

7 Alternative front-ends; remote virtual machinesNote that rdesktop-vrdp can access USB devices only through /proc/bus/usb.Please refer to chapter 11.

7 Alternative front-ends; remote virtual machines7.4.6 RDP encryptionRDP features data stream encryption, which is based on the RC4 symmetric cipher(w

8 VBoxManage referenceWhen running VBoxManage without parameters or when supplying an invalid com-mand line, the below syntax diagram will be shown. N

8 VBoxManage reference[--bioslogofadein on|off][--bioslogofadeout on|off][--bioslogodisplaytime <msec>][--bioslogoimagepath <imagepath>][-

8 VBoxManage reference[--eula <license text>][--eulafile <filename>]VBoxManage startvm <uuid>|<name>[--type gui|sdl|vrdp|headl

8 VBoxManage referenceVBoxManage showhdinfo <uuid>|<filename>VBoxManage createhd --filename <filename>--size <megabytes>[--for

1 First steps1.2 Some terminologyWhen dealing with virtualization (and also for understanding the following chaptersof this documentation), it helps t

8 VBoxManage reference--action ignore|hold (global filters only)[--active yes|no] (yes)[--vendorid <XXXX>] (null)[--productid <XXXX>] (nul

8 VBoxManage referenceVBoxManage dhcpserver add|modify --netname <network_name> |[--ip <ip_address>--netmask <network_mask>--lowerip

8 VBoxManage reference• systemproperties displays some global VirtualBox settings, such as mini-mum and maximum guest RAM and virtual hard disk size,

8 VBoxManage referenceStorage Controller Type (1): I82078IDE Controller (0, 0): /home/user/windows.vdi (UUID: 46f6e53a-4557-460a-9b95-68b0f17d744b)IDE

8 VBoxManage referenceThe --name <name> parameter is required and must specify the name ofthe machine. Since this name is used by default as the

8 VBoxManage reference• --synthcpu on|off: This setting determines whether VirtualBox will exposea synthetic CPU to the guest to allow live migration

8 VBoxManage reference• --boot<1-4> none|floppy|dvd|disk|net: This specifies the boot orderfor the virtual machine. There are four “slots”, which

8 VBoxManage reference• --hostonlyadapter<1-N> none|<devicename>: If host-only networkinghas been enabled for a virtual network card (see

8 VBoxManage reference• --audio none|null|oss: With this option, you can set whether the VMshould have audio support.• --clipboard disabled|hosttogues

8 VBoxManage referenceIt is therefore recommended to first run the import subcommand with the--dry-run or -n option. This will then print a description

1 First steps1.3 Features overviewHere’s a brief outline of VirtualBox’s main features:• Portability. VirtualBox runs on a large number of 32-bit and

8 VBoxManage reference8.7 VBoxManage expor tThis command exports one or more virtual machines from VirtualBox into a virtualappliance in OVF format, i

8 VBoxManage referenceheadless Starts a VM without a window for remote RDP display only.8.9 VBoxManage controlvmThe controlvm subcommand allows you to

8 VBoxManage reference• nic<1-N> null|nat|bridged|intnet|hostonly: With this, you can set,for each of the VM’s virtual network cards, what type

8 VBoxManage referenceThe take operation takes a snapshot of the current state of the virtual machine.You must supply a name for the snapshot and can

8 VBoxManage reference8.13.1 VBoxManage storagectlThis command attaches/modifies/removes a storage controller. The syntax is as fol-lows:VBoxManage sto

8 VBoxManage referencestoragectl Name of the storage controller. Mandatory.port Port number to which the medium has to be attached/detached/modified.Ma

8 VBoxManage referenceVBoxManage createhd --filename <filename>--size <megabytes>[--format VDI|VMDK|VHD] (default: VDI)[--variant Standard

8 VBoxManage referenceIn addition, the modifyhd --compact command can be used to compact disk im-ages, i.e. remove blocks that only contains zeroes. F

8 VBoxManage referenceVBoxManage convertfromraw <filename> <outputfile>[--format VDI|VMDK|VHD][--variant Standard,Fixed,Split2G,Stream,ESX

8 VBoxManage referencelun Logical Unit Number of the target resource (optional). Often, this value is zero.username, password Username and password fo

1 First steps– Hardware compatibility. VirtualBox virtualizes a vast array of virtual de-vices, among them many devices that are typically provided by

8 VBoxManage reference8.21 VBoxManage setpropertyThis command is used to change global settings which affect the entire VirtualBoxinstallation. Some o

8 VBoxManage referenceWhen you modify a USB filter using usbfilter modify, you must specify thefilter by index (see the output of VBoxManage list usbfil

8 VBoxManage referenceSubcommands may apply to all objects and metrics or can be limited to one objector/and a list of metrics. If no objects or metri

8 VBoxManage reference• enumerate <vm> [-patterns <pattern>]: This lists all the guest prop-erties that are available for the given VM, in

8 VBoxManage reference• If you use internal networking for a virtual network adapter of a virtual ma-chine, use VBoxManage dhcpserver add --netname &l

9 Advanced topics9.1 VirtualBox configuration dataFor each system user, VirtualBox stores configuration data in the user’s home directory,as per the con

9 Advanced topicscases, VirtualBox backs up the old settings file in the virtual machine’s configurationdirectory. If you need to go back to the earlier

9 Advanced topics9.2 Automated Windows guest logonsWhen Windows is running in a virtual machine, it might be desirable to perform co-ordinated and aut

9 Advanced topics1. For Windows XP guests, the logon subsystem needs to be configured to use theclassic logon dialog as the VirtualBox GINA module does

9 Advanced topics• /VirtualBox/HostGuest/SysprepRet holds the exit code of sysprep.exeafter its run.• /VirtualBox/HostGuest/SysprepRC holds the return

1 First steps• Remote machine display. You can run any virtual machine in a specialVirtualBox program that acts as a server for the VirtualBox Remote

9 Advanced topicsExternal authentication is the most flexible as the external handler can both chooseto grant access to everyone (like the “null” authe

9 Advanced topics• reverse the order of byte 6 and 7.Using this conversion you will get identical results when converting the binary UUIDto the string

9 Advanced topicsAdditions automatically provide the reduced video modes. Additionally, the VESABIOS has been adjusted to duplicate its standard mode

9 Advanced topics9.7 Multiple monitors for the guestVirtualBox allows the guest to use multiple virtual monitors. Up to sixty-four virtualmonitors are

9 Advanced topicsto the VBoxSDL main thread (first entry in the ps list). For example, when switchingaway to another VT and saving the virtual machine

9 Advanced topicsThis sets up a serial port in the guest with the default settings for COM1 (IRQ 4, I/Oaddress 0x3f8) and the Location setting assumes

9 Advanced topicsarbitrary ways without having to recreate the image file that gives access to the rawdisk.To create an image that represents an entire

9 Advanced topicsAs you can see, the command is identical to the one for “full hard disk” access,except for the additional -partitions parameter. This

9 Advanced topicsFor each of the above variants, you can register the resulting image for immediateuse in VirtualBox by adding -register to the respec

9 Advanced topicsThis command would reserve the network addresses 192.168.0.0 ...192.168.254.254 for the first NAT network instance of “My VM”. The gue

1 First steps– 10.6 (Snow Leopard, 32-bit and 64-bit)Intel hardware is required; please see chapter 13, Known limitations, page 237also.• Linux hosts

9 Advanced topicsVBoxManage setextradata "Linux Guest""VBoxInternal/Devices/pcnet/0/LUN#0/Config/BindIP" "10.45.0.2"Afte

9 Advanced topicsby dragging the window, switching to fullscreen or seamless mode or sending a videomode hint using VBoxManage. This behavior is what

9 Advanced topicsdmidecode -t0and the DMI system information can be obtained withdmidecode -t19.16 Configuring the guest time stamp counter (TSC)to refl

9 Advanced topicsThe serial number is a 20 byte alphanumeric string, the firmware revision an 8 bytealphanumeric string and the model number a 40 byte

10 VirtualBox programminginterfacesVirtualBox comes with comprehensive support for third-party developers. The so-called “Main API” of VirtualBox expo

11 TroubleshootingThis chapter provides answers to commonly asked questions. In order to improve youruser experience with VirtualBox, it is recommende

11 TroubleshootingIn order to work around this problem (the true fix is to use a faster file system thatdoesn’t exhibit such unacceptable write performa

11 TroubleshootingVBoxManage setextradata VMNAME"VBoxInternal/Devices/ahci/0/LUN#[x]/Config/IgnoreFlush" 0The value [x] that selects the dis

11 TroubleshootingThese problems are all caused by a bug in the hard disk driver of Windows 2000.After issuing a hard disk request, there is a race co

11 Troubleshooting11.3 Linux and X11 guests11.3.1 Linux guests may cause a high CPU loadSome Linux guests may cause a high CPU load even if the guest

1 First steps• On a Mac OS X host, in the Finder, double-click on the “VirtualBox” item in the“Applications” folder. (You may want to drag this item o

11 TroubleshootingVBoxClient --clipboardVBoxClient --displayVBoxClient --seamlesswhen your X11 user session is started if you are using a common deskt

11 TroubleshootingCertain applications may disable this key against Microsoft’s advice. If it is set to 0,change it to 1 and reboot your system. Virtu

11 Troubleshooting11.5 Linux hosts11.5.1 Linux kernel module refuses to loadIf the VirtualBox kernel module (vboxdrv) refuses to load, i.e. you get an

11 Troubleshooting11.5.4 Linux host floppy not foundThe previous instructions (for CD and DVD drives) apply accordingly to floppy disks,except that on o

11 Troubleshootingthere are communication problems (i.e. a VirtualBox application cannot communicatewith VBoxSVC), terminate the daemons and remove th

11 Troubleshootingdomount usbfs usbdevfs /proc/bus/usb -onoexec,nosuid,nodevso that it containsdomount usbfs usbdevfs /proc/bus/usb -onoexec,nosuid,no

11 Troubleshooting11.6.2 VM aborts with out of memor y errors on Solaris 10 hostsSolaris 10 hosts (bug 1225025) requires swap space equal to, or great

12 Change logThis section summarizes the changes between VirtualBox versions. Note that thischange log is not exhaustive; not all changes are listed.V

12 Change log• Improved network performance for Linux guests by providing a virtio networkdeviceIn addition, the following items were fixed and/or adde

12 Change log• Solaris Additions: fixed as_pagelock() failed errors affecting guest properties(bug #5337)• Windows Additions: added automatic logon sup

1 First steps1.6 Creating your first virtual machineClick on the “New” button at the top of the VirtualBox window. A wizard will pop upto guide you thr

12 Change log• Linux Additions: fixed writing to files opened in O_APPEND mode (bug #3805)• Solaris Additions: fixed regression in Guest additions driver

12 Change log• Windows Additions: fixed NO_MORE_FILES error when saving to shared folders(bug #4106)• Windows Additions: fixed subdirectory creation on

12 Change log• VMM: fixed release assertion during state restore when using the Sound Blaster16 emulation (bug #5042)• Security: fixed vulnerability tha

12 Change log• VRDP: start VM even if configured VRDP port is in use• Networking: the PCnet network device stopped receiving under rare conditions(bug

12 Change log• Linux/Solaris hosts: correctly detect keyboards with fewer keys than usual (bug#4799)• Mac OS X hosts: prevent password dialogs in 32 b

12 Change log• BIOS: fixed a bug that caused the OS/2 boot manager to fail (2.1.0 regression,bug #3911)• PulseAudio: don’t hang during VM termination i

12 Change log• SUSE 11 guests: fixed Guest Additions installation (bug #4506)• Guest Additions: support Fedora 12 Alpha guests (bugs #4731, #4733 and#4

12 Change log• Shared Folders: fixed selection of a drive root directory as a shared folder hostpath in VirtualBox (Windows host only)• USB: fixed a bug

12 Change log• VMM: fixed hangs and poor performance with Kaspersky Internet Security (VT-x/AMD-V only; bug #1778)• VMM: fixed crashes when executing ce

12 Change log• Solaris host: fixed a preemption issue causing VMs to never start on Solaris 10(bug #4328).• Solaris guest: fixed mouse integration for O

1 First stepsOn the following pages, the wizard will ask you for the bare minimum of informationthat is needed to create a VM, in particular:1. A name

12 Change log• VMM: fixed hanging and unkillable VM processes (bug #4040)• VMM: fixed random infrequent guest crashes due XMM state corruption (Win64hos

12 Change log• VBoxManage: fixed incorrect partition table processing when creating VMDKfiles giving raw partition access (bug #3510)• VBoxManage: suppo

12 Change log• Web service: object-oriented bindings for JAX-WS did not exhibit interface inher-itance correctly, fixed• Web service: added support for

12 Change log• VBoxManage metrics collect: now flushes the output stream• VHD: made VBoxManage internalcommands sethduuid work for .vhdfiles (bug #3443)

12 Change log• Guest Additions: clean up properly if the X Window server terminates• Linux Additions: fixed installation path for OpenGL libraries in s

12 Change log• Networking: fixed a deadlock caused by the PCnet network device emulation(2.2.0 regression, bug #3676)• Clipboard: fixed random crashes (

12 Change log• VMM: FreeBSD guest related fix for V86 flags (bug #2342)• VMM: fixed guru meditation when booting an AsteriskNow Linux VM (bug#2342)• VMM:

12 Change log• VRDP: fixed hangs when VRDP server is enabled or disabled in runtime• Shared Folders: respect umask settings on Linux, OSX and Solaris h

12 Change log• GUI: enable the audio adapter by default for new VMs• GUI: warn if VT-x/AMD-V is not operational when starting a 64-bit guest• GUI: dea

12 Change log• Linux hosts: fixed module dependency for shipped modules (bug #3115)• Linux hosts: moved the udev rules for USB forward so that they don

1 First stepsThere are many and potentially complicated ways in which VirtualBox can pro-vide hard disk space to a VM (see chapter 5, Virtual storage,

12 Change log• USB: reduced host CPU utilization if EHCI is active• VRDP: fixed VRDP server black screen after a client reconnect (bug #1989)• VRDP: mo

12 Change log• VMM: allow running up to 1023 VMs on 64-bit hosts (used to be 127)• VMM: several FreeB SD guest related fixes (bugs #2342, #2341, #2761)

12 Change log• IDE: fixed ATAPI passthrough support (Linux hosts only; bug #2795)• Networking: fixed kernel panics due to NULL pointer dereference in Li

12 Change log• VHD: fixed error when attaching certain container files (bug #2768)• Solaris hosts: added support for serial ports (bug #1849)• Solaris h

12 Change log• Linux Additions: fixed a driver issue preventing X11 from compiling keymaps(bug #2793 and #2905)• X11 Additions: workaround in the mouse

12 Change log• VMM: deactivate VT-x and AMD-V when the host machine goes into suspendmode; reactivate when the host machine resumes (Windows, Mac OS X

12 Change log• VBoxManage: added support for VMDK and VHD image creation• VBoxManage: added support for image conversion (VDI/VMDK/VHD/RAW)• Solaris h

12 Change log• Solaris hosts: fixed inability to start more than 128 VMs• Solaris/Web services: fixed SMF script to set home directory correctly• Linux

12 Change log• Solaris hosts: fixed incompatibility between IPSEC and host interface networking• Solaris hosts: fixed a rare race condition while poweri

12 Change log• Clipboard: don’t crash when host service initialization takes longer than ex-pected (Linux hosts only; bug #2001)• Windows hosts: VBoxS

Contents1 First steps 91.1 Why is virtualization useful? . . . . . . . . . . . . . . . . . . . . . . . . 101.2 Some terminology . . . . . . . . . . .

1 First steps• A dynamically expanding file will only grow in size when the guest actu-ally stores data on its virtual hard disk. It will therefore ini

12 Change log• VMM: fixed Linux 2.6.26+ kernel crashes (used by Ubuntu 8.10 Alpha, Fedora10 Alpha; bug #1875)• VMM: fixed 64 bits Linux 2.6.26 kernel cr

12 Change log• Mac OS X hosts: added Python support• Additions: fixed a possible hang in HGCM communication after a VM reboot• Windows Additions: added

12 Change log• New-version notifier• Guest property information interface• Host Interface Networking on Mac OS X hosts• New Host Interface Networking o

12 Change log• SATA: fixed BSODs of Windows guests on a SATA disk (bug #1941)• SATA: fixed hard disk detection on Solaris 10 U5 (bug #1789)• VBoxHeadles

12 Change log• Linux Additions: fixed startup order for recent Linux distributions again (e.g.openSUSE 11)• Linux Additions: attempt to fix the autostar

12 Change log• BIOS: added SMBIOS header to make Solaris and Vista recognize the DMI data• ACPI: properly hide a disabled floppy controller• VMM: small

12 Change log• VMM: fixed starting of VMs with AMD-V enabled• VMM: massive performance enhancements for AMD-V• VMM: stability improvements for AMD-V on

12 Change log• Windows host: fixed stability during high system load (page fault in KeQueryAc-tiveProcessors)• Mac OS X host: fixed crashes under certai

12 Change log• VMM: many fixes for VT-x/SVM hardware-supported virtualization• ATA/IDE: better disk geometry compatibility with VMware images• ATA/IDE:

12 Change log12.24 Version 1.5.6 (2008-02-19)This version is a maintenance release. It adds an experimental Intel Gigabit Ethernetdevice emulation and

1 First steps1.7 Running your virtual machineYou will now see your new virtual machine in the list of virtual machines, at the left ofthe VirtualBox m

12 Change log• VRDP: install rdesktop-vrdp on Linux hosts• VBoxManage: fixed crash during clonevdi• VBoxManage: added ’list runningvms’ command• VBoxMa

12 Change log12.25 Version 1.5.4 (2007-12-29)This version is a maintenance release. It adds USB 2.0 support and a PulseAudiobackend.• GUI: fixed regist

12 Change log• Floppy: fixed handling of read-only images• USB: virtualize an EHCI controller• USB: several minor fixes• Network: fixed MAC address check

12 Change log• Linux host: make sure the tun kernel module is loaded before initializing staticTAP interfaces• Windows Additions: fixed hang during HGC

12 Change log• BIOS: expose the VM UUID in the DMI/SMBIOS area• VGA: fixed CGA video modes• VGA: fixed 8-bit DAC handling (Solaris setup)• VMM: fixed iss

12 Change log• Windows Additions: fixed issues with Additions on NT 4 guests• Windows Additions: added support for 8-bit video modes• Windows Additions

12 Change log• GUI: pass the Pause key and the PrtScrn key to the guest (Linux hosts)• GUI: increased maximum guest RAM to 2 GB (Windows host)• GUI: i

12 Change log• VMM: fixed out-of-memory errors under certain environments with enough ap-propriate memory available• API: fixed occasional crashes of th

12 Change log12.28 Version 1.4.0 (2007-06-06)• General: added support for OS X hosts• General: added support for AMD64 hosts• General: signed all exec

12 Change log• VMM: improved FreeB SD and OpenBSD support• VMM: improved performance of guests that aggressively patch kernel code (veryrecent Linux 2

1 First stepsIn detail, all this translates into the following:• Your keyboard is owned by the VM if the VM window on your host desktophas the keyboar

12 Change log• NAT: fix a potential problem with incorrect memory allocation• Internal Networking: fixed issue on Windows hosts• Host Interface Networki

12 Change log• Linux Installer: force a non-executable stack for all binaries and shared libraries• Linux Installer: make it work on SELinux-enabled s

12 Change log• Linux Additions: support Xorg 7.2.x• Linux Additions: fixed default video mode if all other modes are invalid• Linux Additions: set defa

12 Change log12.31 Version 1.3.4 (2007-02-12)• General: fixed unresolved symbol issue on Windows 2000 hosts• General: added warnings at VirtualBox star

12 Change log• Network: fixed IRQ conflict causing occasional major slowdowns with XP guests• Network: significantly improved send performance• Audio: ad

12 Change log• VMM: significant performance improvements for Linux 2.6 guests• VMM: performance improvements for Windows guests• Network: fixed issues w

12 Change log• VMM: experimental support for IBM OS/2 Warp (requires VT-x to be enabled)• USB: added support for isochronous transfers (webcams, audio

12 Change log12.36 Version 1.1.10 (2006-07-28)• IDE: added workaround for Acronis TrueImage (violates IDE specification)• IDE: resolved issues with cer

12 Change log• VBoxManage: made VRDP authentication configurable• VDI: added workaround against possible Windows host deadlocks caused by asynchronizat

12 Change log• VRDP: added client authentication through external authentication libraries(WinLogon and PAM interfaces are provided as sample code)• V

1 First stepsthere are three candidates as to who receives keyboard input: the host operating sys-tem, VirtualBox, or the guest operating system. Who

12 Change log• VMM: fixed random user mode crashes with OpenBSD guests• VMM: increased timing accuracy (PIT, RTC), reduced PIT query overhead• VMM: tam

12 Change log12.41 Version 1.0.50 (2005-12-16)Note: Guest Additions have to be updated• VMM: added support for OpenBSD guests• VMM: fixed a memory leak

12 Change log• GUI: allow creation and assignment of disk images in the New VM wizard.• USB: fixed high CPU load on certain Linux distributions• VBoxSD

12 Change log• Graphics/Additions/GUI: added dynamic resizing support• Graphics: added workaround for buggy VESA support in Windows Vista/Longhorn• VR

12 Change log• VBoxManage: restructured commands, added numerous improvements• GUI: propagate hostkey change to all running instances• GUI: perform im

12 Change log• GUI: added detailed error information dialogs• GUI: special handling of inaccessible media• API: better error message handling, provide

12 Change log• VMM: fixed several crashes and hangs while installing certain builds of Windows2000 and XP• VMM: allow guests to have more than 512MB of

13 Known limitationsThe following section describes some issues that are known not to work in VirtualBox3.1.0_BETA2. Unless marked otherwise these iss

13 Known limitations– OVF localization (multiple languages in one OVF file) is not yet supported.– Some OVF sections like StartupSection, DeploymentOpt

13 Known limitations• Guest Additions for OS/2. Shared folders are not yet supported with OS/2guests. In addition, seamless windows and automatic gues

1 First stepsThe settings are the same as would be available for the VM in the “Settings” dialogof the VirtualBox main window, but since that dialog i

14 Third-party licensesVirtualBox incorporates materials from several Open Source software projects. There-fore the use of these materials by VirtualB

14 Third-party licenses• VirtualBox may contain NSPR and XPCOM which is governed by the license inchapter 14.2.3, Mozilla Public License (MPL), page 2

14 Third-party licenses• VirtualBox may contain code from the gSOAP XML web services tools, which arelicensed under the license in chapter 14.2.14, gS

14 Third-party licensesWhen we speak of free software, we are referring to freedom, not price. Our GeneralPublic Licenses are designed to make sure th

14 Third-party licensesYou may charge a fee for the physical act of transferring a copy, and you may at youroption offer warranty protection in exchan

14 Third-party licensesc) Accompany it with the information you received as to the offer to distribute cor-responding source code. (This alternative i

14 Third-party licensesIf any portion of this section is held invalid or unenforceable under any particularcircumstance, the balance of the section is

14 Third-party licenses12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TOIN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAYM

14 Third-party licensesthe library after making changes to the library and recompiling it. And you must showthem these terms so they know their rights

14 Third-party licensesThe precise terms and conditions for copying, distribution and modification follow.Pay close attention to the difference between

1 First stepsThis is equivalent to pulling the power plug on a real computer without shuttingit down properly. If you start the machine again after po

14 Third-party licensesd) If a facility in the modified Library refers to a function or a table of data to besupplied by an application program that us

14 Third-party licenses5. A program that contains no derivative of any portion of the Library, but is de-signed to work with the Library by being comp

14 Third-party licensesc) Accompany the work with a written offer, valid for at least three years, to givethe same user the materials specified in Subs

14 Third-party licensesimpose any further restrictions on the recipients’ exercise of the rights granted herein.You are not responsible for enforcing

14 Third-party licenseswill be guided by the two goals of preserving the free status of all derivatives of ourfree software and of promoting the shari

14 Third-party licenses1.8. “License” means this document.1.8.1. “Licensable” means having the right to grant, to the maximum extent possible,whether

14 Third-party licenses(d) Notwithstanding Section 2.1(b) above, no patent license is granted: 1) for codethat You delete from the Original Code; 2) s

14 Third-party licensesSource Code version remains available even if the Electronic Distribution Mechanismis maintained by a third party.3.3. Descript

14 Third-party licensesor collateral in which You describe recipients’ rights relating to the Covered Code. Youmay distribute the Executable version o

14 Third-party licensesCOVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN “AS IS” BASIS, WITH-OUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, IN

1 First stepscurrent state of your VM is a variation based on the snapshot you took earlier.If you later take another snapshot, you will see that they

14 Third-party licenses8.4. In the event of termination under Sections 8.1 or 8.2 above, all end user licenseagreements (excluding distributors and re

14 Third-party licensesveloper permits you to utilize portions of the Covered Code under Your choice of theNPL or the alternative licenses, if any, sp

14 Third-party licenses14.2.5 X Consortium License (X11)Permission is hereby granted, free of charge, to any person obtaining a copy of thissoftware a

14 Third-party licensestextual message at program startup or in documentation (online or textual) providedwith the package.Redistribution and use in s

14 Third-party licensesCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.IN NO EVENT SHALL DANNY GASPAROVSKI OR CONTRIBUTORS BE LIABLE

14 Third-party licenses2. Altered versions must be plainly marked as such and must not be misrepresentedas being the original source.3. This Copyright

14 Third-party licensesTHE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EX-PRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIE

14 Third-party licensesIN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OROTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTH

14 Third-party licenses1.10.1. “Patent Claims” means any patent claim(s), now owned or hereafter ac-quired, including without limitation, method, proc

14 Third-party licenses(c)(d)3 DISTRIBUTION OBLIGATIONS.3.1. Application of License.The Modifications which You create or to which You contribute are g

1 First stepsBy restoring an earlier snapshot and taking more snapshots from there, it is evenpossible to create a kind of alternate reality and to sw

14 Third-party licensesdirectory) where a user would be likely to look for such a notice. If You created one ormore Modification(s) You may add your na

14 Third-party licenseschoose to use such Covered Code under the terms of any subsequent version of theLicense.6.3. Derivative Works.If You create or

14 Third-party licensesJURY OR LOSS OF HUMAN LIFE. THIS DISCLAIMER OF WARRANTY CONSTITUTESAN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY COVERED COD

14 Third-party licenses“The contents of this file are subject to the gSOAP Public License Version 1.3(the “License”); you may not use this file except i

14 Third-party licenses• Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer

14 Third-party licensesPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

14 Third-party licenses14.2.16 curl licenseCOPYRIGHT AND PERMISSION NOTICECopyright (c) 1996 - 2009, Daniel Stenberg, [email protected] rights reserv

15 VirtualBox privacy policyPolicy version 1.3, June 29, 2009This privacy policy sets out how Sun Microsystems, Inc. (“Sun”) treats personalinformatio

15 VirtualBox privacy policy§ 6 Updates. Sun may update this privacy policy by posting a new version on thewebsite. You should check this page occasio

GlossaryAACPI Advanced Configuration and Power Interface, an industry specification for BIOSand hardware extensions to configure PC hardware and perform

1 First stepsNote: The “Settings” button is disabled while a VM is either in the “running”or “saved” state. This is simply because the settings dialog

GlossaryCCOM Microsoft Component Object Model, a programming infrastructure for modularsoftware. COM allows applications to provide application progra

GlossaryIIDE Integrated Drive Electronics, an industry standard for hard disk interfaces. Seechapter 5.1, Hard disk controllers: IDE, SATA (AHCI), SCS

GlossaryRRDP Remote Desktop Protocol, a protocol developed by Microsoft as an extensionto the ITU T.128 and T.124 video conferencing protocol. With RD

GlossaryXXML The eXtensible Markup Language, a metastandard for all kinds of textual infor-mation. XML only specifies how data in the document is organ

1 First steps1.10 Deleting virtual machinesTo remove a virtual machine which you no longer need, right-click on it in the list ofvirtual machines in t

Contents2.4.5 Configuring a zone for running VirtualBox . . . . . . . . . . . . 433 Configuring virtual machines 443.1 Supported guest operating systems

1 First stepsIf VirtualBox can handle the file, a dialog similar to the following will appear:This presents the virtual machines described in the OVF fi

1 First stepsNote: OVF cannot describe every feature that VirtualBox provides for virtualmachines. For example, snapshot information gets lost on expo

2 Installation detailsAs installation of VirtualBox varies depending on your host operating system, we pro-vide installation instructions in four sepa

2 Installation detailsNetworking This package contains extra networking drivers for your Windows hostthat VirtualBox needs to support Host Interface N

2 Installation details2.2.2 UninstallationTo uninstall VirtualBox, open the disk image (dmg) file again and double-click on theuninstall icon contained

2 Installation detailsThe VirtualBox kernel module is automatically installed on your system when youinstall VirtualBox. To maintain it with future ke

2 Installation details2. The kernel of your Linux host got updated. In that case, the kernel module willneed to be reinstalled by executing (as root):

2 Installation detailssudo /etc/init.d/vboxdrv setupThis will start a second attempt to build the module.If a suitable kernel module was found in the

2 Installation detailsAfter that you need to put every user which should be able to use VirtualBox in thegroup vboxusers, either through the GUI user

2 Installation detailsmake installThe VirtualBox kernel module needs a device node to operate. The above makecommand will tell you how to create the d

Contents4.10 Hardware 2D video acceleration for Windows guests . . . . . . . . . . . 734.11 Guest properties . . . . . . . . . . . . . . . . . . . . .

2 Installation detailssudo ./VirtualBox.run uninstallor as root./VirtualBox.run uninstall. Starting with version 2.2.2, you can uninstall the .run pac

2 Installation details2.3.5 Starting VirtualBox on LinuxThe easiest way to start a VirtualBox program is by running the program of your choice(Virtual

2 Installation detailsNote: If you are using Solaris Zones, to install VirtualBox only into the currentzone and not into any other zone, use pkgadd -G

2 Installation detailsTo perform a non-interactive uninstallation, open a root terminal session and exe-cute:pkgrm -n -a /opt/VirtualBox/autoresponse

3 Configuring virtual machinesWhereas chapter 1, First steps, page 9 gave you a quick introduction to VirtualBox andhow to get your first virtual machin

3 Configuring virtual machinesSolaris 10, OpenSolaris Fully supported (32 bits and 64 bits). Guest Additions areavailable.FreeBSD Limited support. Gues

3 Configuring virtual machines3.3 General settingsIn the Settings window, under “General”, you can configure the most fundamentalaspects of the virtual

3 Configuring virtual machines3.3.3 “Description” tabHere you can enter any description for your virtual machine, if you want. This has noeffect of the

3 Configuring virtual machinesEnable I/O APIC Advanced Programmable Interrupt Controllers (APICs) are a newerx86 hardware feature that have replaced ol

3 Configuring virtual machinesIn addition, the “Enable PAE/NX” setting determines whether the PAE and NX capa-bilities of the host CPU will be exposed

Contents8.5.2 Networking settings . . . . . . . . . . . . . . . . . . . . . . . . . 1168.5.3 Serial port, audio, clipboard, VRDP and USB settings . .

3 Configuring virtual machinesYou can select for each virtual machine individually whether VirtualBox should usesoftware or hardware virtualization. Pr

3 Configuring virtual machinesOn AMD processors, nested paging has been available starting with theBarcelona (K10) architecture; Intel added support fo

3 Configuring virtual machinesIn a real PC, so-called “storage controllers” connect physical disk drives to the restof the computer. Similarly, Virtual

3 Configuring virtual machinesbelow the tree. You can then either select “Add CD/DVD device” or “Add Hard Disk”.Alternatively, right-click on the stora

3 Configuring virtual machinesTo remove a virtual disk or drive, select it and click on the “remove” icon at thebottom (or right-click on it and select

3 Configuring virtual machines3.9 Serial portsVirtualBox fully supports virtual serial ports in a virtual machine in an easy-to-usemanner.3Ever since t

3 Configuring virtual machineswill then simply redirect all data received from and sent to the virtual serialport to the physical device.• You can tell

3 Configuring virtual machinesNote:1. Be careful with USB devices that are currently in use on the host! Forexample, if you allow your guest to connect

3 Configuring virtual machines3. Remote. This setting specifies whether the device will be local only, or remoteonly (over VRDP), or either.On a Windows

3 Configuring virtual machinesreplace the legacy BIOS as the primary interface for bootstrapping computers andcertain system services later.By default,

Contents9.13.2 Configuring the boot server (next server) of a NAT network in-terface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4 Guest AdditionsThe previous chapter covered getting started with VirtualBox and installing operatingsystems in a virtual machine. For any serious an

4 Guest AdditionsFor Linux and Solaris guests, the Xorg server version 1.3 or later is required forautomatic resizing (the feature has been disabled o

4 Guest AdditionsTo disable this update check for the Guest Additions of a given virtual machine, setthe value of its /VirtualBox/GuestAdd/CheckHostVe

4 Guest Additions3. In the Virtual Disk Manager, press the “Add” button and browse your host filesystem for the VBoxGuestAdditions.iso file:• On a Windo

4 Guest Additions4.3.3 Unattended InstallationIn order to allow for completely unattended guest installations, you can specify acommand line parameter

4 Guest AdditionsWindows Guest Additions setup. Please consult chapter 4.3.4, Manual file extraction,page 64 on how to achieve this. You will then find

4 Guest Additionssudo apt-get install dkmsInstall DKMS before installing the Linux Guest Additions.2. Mount the VBoxGuestAdditions.iso file as your Lin

4 Guest Additionspage 46. You can also add your own modes to the X server configuration file. Yousimply need to add them to the “Modes” list in the “Dis

4 Guest AdditionsIf in case the CD-ROM drive on the guest doesn’t get mounted (observed onsome versions of Solaris 10), execute as root:svcadm restart

4 Guest Additionsthe host and are then shared with the guest; sharing is accomplished using a specialservice on the host and a file system driver for t

Contents11.5.7 USB not working . . . . . . . . . . . . . . . . . . . . . . . . . . 16411.5.8 PAX/grsec kernels . . . . . . . . . . . . . . . . . . . .

4 Guest Additionsnet use x: \\vboxsvr\sharenameWhile vboxsvr is a fixed name (note that vboxsrv would also work), replace“x:“ with the drive letter tha

4 Guest Additions4.8 Seamless windowsWith the “seamless windows” feature of VirtualBox, you can have the windows that aredisplayed within a virtual ma

4 Guest Additions4.9 Hardware 3D acceleration (OpenGL and Direct3D8/9)The VirtualBox Guest Additions contain experimental hardware 3D support for Win-

4 Guest AdditionsTechnically, VirtualBox implements this by installing an additional hardware 3Ddriver inside your guest when the Guest Additions are

4 Guest Additions2. In addition, arbitrary string data can be exchanged between guest and host, andin both directions.To accomplish this, VirtualBox e

4 Guest Additionstimestamp: 1229098279885027000, flags:Name: /VirtualBox/GuestAdd/Components/VBoxGuest.sys, value: 3.1.0r40720,timestamp: 122909827988

5 Virtual storageAs the virtual machine will most probably expect to see a hard disk built into its virtualcomputer, VirtualBox must be able to presen

5 Virtual storagemachine. (By default, one of these four – the secondary master – is preconfiguredto be the machine’s virtual CD-ROM/DVD drive, but thi

5 Virtual storageWarning: The entire SATA controller and the virtual disks attached to it (in-cluding those in IDE compatibility mode) will not be see

5 Virtual storage5.2 Disk image files (VDI, VMDK, VHD, HDD)Disk image files reside on the host system and are seen by the guest systems as harddisks of

Contents12.38Version 1.1.6 (2006-04-18) . . . . . . . . . . . . . . . . . . . . . . . . . 22812.39Version 1.1.4 (2006-03-09) . . . . . . . . . . . . .

5 Virtual storage5.3 The Virtual Media ManagerVirtualBox keeps an internal registry of all available hard disk, CD/DVD-ROM andfloppy disk images. This

5 Virtual storage• remove an image from the registry (and optionally delete the image file whendoing so);• “release” an image, that is, detach it from

5 Virtual storageWhile you can attach the same “normal” image to more than one virtual ma-chine, only one of these virtual machines attached to the sa

5 Virtual storagetaken a snapshot. Imagine you have accidentally infected your VM with a virus andwould like to go back to the snapshot. With a normal

5 Virtual storagenoticeable however since the tables with sector information are always kept in memoryand can be looked up quickly.Differencing images

5 Virtual storage5.6 Cloning disk imagesYou can duplicate hard disk image files on the same host to quickly produce a secondvirtual machine with the sa

5 Virtual storage5.8 iSCSI serversiSCSI stands for “Internet SCSI” and is a standard that allows for using the SCSI proto-col over Internet (TCP/IP) c

5 Virtual storageFinally the iSCSI disk must be registered with the -intnet option to tell the iSCSIinitiator to use internal networking:VBoxManage ad

6 Virtual networkingAs briefly mentioned in chapter 3.8, Network settings, page 54, VirtualBox provides upto eight virtual PCI Ethernet cards for each

6 Virtual networkingVirtualBox has limited support for so-called jumbo frames, i.e. networking packetswith more than 1500 bytes of data, provided that

1 First stepsWelcome to Sun VirtualBox!VirtualBox is a cross-platform virtualization application. What does that mean? Forone thing, it installs on yo

6 Virtual networking6.3 Network Address Translation (NAT)Network Address Translation (NAT) is the simplest way of accessing an external net-work from

6 Virtual networkinguse the same ports on the guest and on the host). You can use any ports on the hostwhich are not already in use by a service. An e

6 Virtual networkingProtocols such as GRE are unsupported: Protocols other than TCP and UDP arenot supported. This means some VPN products (e.g. PPTP

6 Virtual networkinglist at the bottom of the page, which contains the physical network interfaces of yoursystems. On a typical MacBook, for example,

6 Virtual networkingany reason, you prefer two or more VMs on the same machine to communi-cate privately, hiding their data from both the host system

6 Virtual networkingInstead, when host-only networking is used, VirtualBox creates a new software in-terface on the host which then appears next to yo

7 Alternative front-ends; remotevirtual machines7.1 IntroductionAs briefly mentioned in chapter 1.3, Features overview, page 12, VirtualBox has a veryfl

7 Alternative front-ends; remote virtual machines7.2 Using VBoxManage to control virtual machinesThis section will give you a brief introduction to VB

7 Alternative front-ends; remote virtual machines$ VBoxManage createvm --name "SUSE 10.2" --registerVirtualBox Command Line Management Inter

7 Alternative front-ends; remote virtual machinesTo start a virtual machine with VBoxSDL instead of the VirtualBox GUI, enter thefollowing on a comman