Professional Documents
Culture Documents
UserManual - Kopya
UserManual - Kopya
R
VM
VirtualBox
R
User Manual
Version 6.1.12
c 2004-2020 Oracle Corporation
http://www.virtualbox.org
Contents
Preface i
1 First Steps 1
1.1 Why is Virtualization Useful? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Some Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 Features Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.4 Supported Host Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4.1 Host CPU Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.5 Installing Oracle VM VirtualBox and Extension Packs . . . . . . . . . . . . . . . 6
1.6 Starting Oracle VM VirtualBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.7 Creating Your First Virtual Machine . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.8 Running Your Virtual Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.8.1 Starting a New VM for the First Time . . . . . . . . . . . . . . . . . . . 11
1.8.2 Capturing and Releasing Keyboard and Mouse . . . . . . . . . . . . . . 12
1.8.3 Typing Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.8.4 Changing Removable Media . . . . . . . . . . . . . . . . . . . . . . . . 13
1.8.5 Resizing the Machine’s Window . . . . . . . . . . . . . . . . . . . . . . 14
1.8.6 Saving the State of the Machine . . . . . . . . . . . . . . . . . . . . . . 14
1.9 Using VM Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.10 Snapshots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.10.1 Taking, Restoring, and Deleting Snapshots . . . . . . . . . . . . . . . . 16
1.10.2 Snapshot Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.11 Virtual Machine Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.12 Removing and Moving Virtual Machines . . . . . . . . . . . . . . . . . . . . . . 19
1.13 Cloning Virtual Machines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.14 Importing and Exporting Virtual Machines . . . . . . . . . . . . . . . . . . . . . 21
1.14.1 About the OVF Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
1.14.2 Importing an Appliance in OVF Format . . . . . . . . . . . . . . . . . . 22
1.14.3 Exporting an Appliance in OVF Format . . . . . . . . . . . . . . . . . . 23
1.14.4 Preparing for Oracle Cloud Infrastructure Integration . . . . . . . . . . 23
1.14.5 Exporting an Appliance to Oracle Cloud Infrastructure . . . . . . . . . . 24
1.14.6 Importing an Instance from Oracle Cloud Infrastructure . . . . . . . . . 26
1.14.7 The Cloud Profile Manager . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.14.8 Creating New Cloud Instances from a Custom Image . . . . . . . . . . . 29
1.15 Global Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.16 Alternative Front-Ends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.17 Soft Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.17.1 Using the Soft Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.17.2 Creating a Custom Keyboard Layout . . . . . . . . . . . . . . . . . . . . 32
2 Installation Details 33
2.1 Installing on Windows Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
2.1.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
2.1.2 Performing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . 33
2.1.3 Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.1.4 Unattended Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2
Contents
4 Guest Additions 67
4.1 Introduction to Guest Additions . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
3
Contents
5 Virtual Storage 88
5.1 Hard Disk Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
5.2 Disk Image Files (VDI, VMDK, VHD, HDD) . . . . . . . . . . . . . . . . . . . . . 91
5.3 The Virtual Media Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
5.4 Special Image Write Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
5.5 Differencing Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
5.6 Cloning Disk Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
5.7 Host Input/Output Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
5.8 Limiting Bandwidth for Disk Images . . . . . . . . . . . . . . . . . . . . . . . . . 99
5.9 CD/DVD Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
5.10 iSCSI Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
5.11 vboximg-mount: A Utility for FUSE Mounting a Virtual Disk Image . . . . . . . . 101
5.11.1 Viewing Detailed Information About a Virtual Disk Image . . . . . . . . 101
5.11.2 Mounting a Virtual Disk Image . . . . . . . . . . . . . . . . . . . . . . . 102
4
Contents
8 VBoxManage 129
8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
8.2 Commands Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
8.3 General Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
8.4 VBoxManage list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
8.5 VBoxManage showvminfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
8.6 VBoxManage registervm/unregistervm . . . . . . . . . . . . . . . . . . . . . . . 144
8.7 VBoxManage createvm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
8.8 VBoxManage modifyvm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
8.8.1 General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
8.8.2 Networking Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
8.8.3 Miscellaneous Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
8.8.4 Recording Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
8.8.5 Remote Machine Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 154
8.8.6 Teleporting Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
8.8.7 Debugging Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
8.8.8 USB Card Reader Settings . . . . . . . . . . . . . . . . . . . . . . . . . 157
8.8.9 Autostarting VMs During Host System Boot . . . . . . . . . . . . . . . . 157
8.9 VBoxManage movevm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.10 VBoxManage import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.10.1 Import from OVF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.10.2 Import from Oracle Cloud Infrastructure . . . . . . . . . . . . . . . . . 159
8.11 VBoxManage export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
8.11.1 Export to OVF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
8.11.2 Export to Oracle Cloud Infrastructure . . . . . . . . . . . . . . . . . . . 161
8.12 VBoxManage startvm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
8.13 VBoxManage controlvm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
8.14 VBoxManage discardstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8.15 VBoxManage adoptstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8.16 VBoxManage closemedium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8.17 VBoxManage storageattach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
8.18 VBoxManage storagectl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
8.19 VBoxManage bandwidthctl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
8.20 VBoxManage showmediuminfo . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
8.21 VBoxManage createmedium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
8.22 VBoxManage modifymedium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
8.23 VBoxManage clonemedium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.24 VBoxManage mediumproperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
8.25 VBoxManage encryptmedium . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5
Contents
6
Contents
7
Contents
12 Troubleshooting 311
12.1 Procedures and Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
12.1.1 Categorizing and Isolating Problems . . . . . . . . . . . . . . . . . . . . 311
12.1.2 Collecting Debugging Information . . . . . . . . . . . . . . . . . . . . . 312
12.1.3 Using the VBoxBugReport Command to Collect Debug Information
Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
12.1.4 The Built-In VM Debugger . . . . . . . . . . . . . . . . . . . . . . . . . 313
12.1.5 VM Core Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
12.2 General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
12.2.1 Guest Shows IDE/SATA Errors for File-Based Images on Slow Host
File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
12.2.2 Responding to Guest IDE/SATA Flush Requests . . . . . . . . . . . . . . 316
12.2.3 Performance Variation with Frequency Boosting . . . . . . . . . . . . . 317
12.2.4 Frequency Scaling Effect on CPU Usage . . . . . . . . . . . . . . . . . . 317
12.2.5 Inaccurate Windows CPU Usage Reporting . . . . . . . . . . . . . . . . 317
12.2.6 Poor Performance Caused by Host Power Management . . . . . . . . . 317
12.2.7 GUI: 2D Video Acceleration Option is Grayed Out . . . . . . . . . . . . 318
12.3 Windows Guests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
12.3.1 No USB 3.0 Support in Windows 7 Guests . . . . . . . . . . . . . . . . . 318
12.3.2 Windows Bluescreens After Changing VM Configuration . . . . . . . . . 318
12.3.3 Windows 0x101 Bluescreens with SMP Enabled (IPI Timeout) . . . . . 319
12.3.4 Windows 2000 Installation Failures . . . . . . . . . . . . . . . . . . . . 319
12.3.5 How to Record Bluescreen Information from Windows Guests . . . . . 319
12.3.6 No Networking in Windows Vista Guests . . . . . . . . . . . . . . . . . 319
12.3.7 Windows Guests may Cause a High CPU Load . . . . . . . . . . . . . . 320
12.3.8 Long Delays When Accessing Shared Folders . . . . . . . . . . . . . . . 320
12.3.9 USB Tablet Coordinates Wrong in Windows 98 Guests . . . . . . . . . . 320
12.3.10 Windows Guests are Removed From an Active Directory Domain
After Restoring a Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . 320
12.3.11 Windows 3.x Limited to 64 MB RAM . . . . . . . . . . . . . . . . . . . 320