user_Introduction.xml revision 6728a36898fd2be125a28e84d2115d19aa4923ed
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
<chapter>
<title id="Introduction">Premières étapes</title>
<para>Bienvenu sur $VBOX_PRODUCT!</para>
<para>VirtualBox est une application de virtualisation de machines
inter-plateformes. Qu'est-ce que cela veut dire ? Premièrement, il
s'installe sur vos ordinateurs existants basés sur Intel ou AMD, qu'ils
exécutent les systèmes d'exploitation Windows, Mac, Linux ou Solaris.
Deuxièmement, il étend augmente les capacités de votre ordinateur existant de
telle sorte qu'il puisse exécuter plusieurs systèmes d'exploitation à la fois
(au sein de plusieurs machines virtuelles). Donc, par exemple, vous pouvez
lancer Windows et Linux sur votre Mac, lancer Windows Server 2008 sur votre
serveur Linux, lancer Linux sur votre PC Windows, etc., tout en laissant
ouvertes vos applications existantes. Vous pouvez installer et exécuter
autant de machines virtuelles que vous le voulez ; les seules limites
pratiques sont l'espace disque et la mémoire.</para>
<para>VirtualBox est tout autant simple que puissant. Il peut se lancer
depuis n'importe où, sur de petits systèmes embarqués ou des machines de
bureau jusqu'au déploiement tout autant que sur des centres de données de
développement et mêmes dans des environnements <quote>Cloud</quote> dit en
nuages.</para>
<para>L'aperçu suivant vous montre comment VirtualBox, installé sur une machine
Linux, lance Windows 7 dans une fenêtre de machine virtuelle :</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject></para>
<para>Dans ce manuel de l'utilisateur, nous allons simplement commencer par une
rapide introduction à la virtualisation et sur la façon de lancer votre
première machine virtuelle avec l'interface graphique VirtualBox facile à
utiliser. Les chapitres suivants donneront beaucoup plus de détails
concernant des outils et des fonctionnalités plus puissants, mais heureusement,
il n'est pas nécessaire de lire tout le manuel de l'utilisateur avant de
pouvoir utiliser VirtualBox.</para>
<para>Vous pouvez trouver un résumé des possibilités de VirtualBox au <xref
linkend="features-overview" />. Pour les utilisateurs qui ont déjà VirtualBox
et qui veulent seulement savoir ce qu'il y a de nouveau dans cette version, il
y a une liste détaillée au <xref linkend="ChangeLog" />.</para>
<sect1>
<title>Pourquoi la virtualisation est-elle utile ?</title>
<para>Les techniques et les fonctionnalités fournies par VirtualBox sont
utiles pour plusieurs scénarii :</para>
<itemizedlist>
<listitem>
<para><emphasis role="bold">Support du système d'exploitation.</emphasis>
Avec VirtualBox, on peut lancer un logiciel écrit pour un système
d'exploitation sur un autre (par exemple, un logiciel Windows sur Linux
ou un Mac) sans avoir à redémarrer pour l'utiliser. Comme vous pouvez
configurer les types de matériel qui devraient être présentés à chaque
machine virtuelle, vous pouvez même installer un vieux système
d'exploitation comme DOS ou OS/2 dans une machine virtuelle si le
matériel de votre ordinateur n'est plus supporté par ce système
d'exploitation.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Tester et réparer un dommage.</emphasis>
Une fois installée, on peut considérer une machine virtuelle et ses
disques virtuels comme un <quote>container</quote> que vous pouvez de
façon arbitraire figer, réveiller, copier, sauvegarder et transporter
entre les hôtes.</para>
<para>Au surplus, avec l'utilisation d'une autre
caractéristique de VirtualBox appelée <quote>prise</quote>, vous pouvez
sauvegarder un état particulier de la machine virtuelle et revenir vers
à cet état si nécessaire. De cette façon, vous pouvez expérimenter
librement en divers environnements de travail. Si quelque chose ne va
pas (comme un logiciel qui ne se comporte pas bien après avoir été
installé ou un virus qui a infecté la machine invité), vous pouvez
facilement revenir à un dépôt précédent et éviter de devoir sauvegarder
et restaurer souvent.</para>
<para>Vous pouvez créer n'importe quel nombre de dépôts,
ce qui vous permet de voyager en arrière et dans le temps des machines
virtuelles. Vous pouvez effacer des dépôts alors qu'une VM est en
fonction pour récupérer de l'espace disque.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Consolidation de l'infrastructure..</emphasis>
La virtualisation peut réduire significativement les coûts de matériel
et d'électricité. Aujourd'hui, les serveurs tournent se lancent
typiquement avec des charges système très faibles et sont rarement
utilisés dans leur plein potentiel. Beaucoup de potentiel du matériel et
d'électricité est ainsi gaspillé. Alors, au lieu de lancer plusieurs
ordinateurs physiques qui ne sont que partiellement utilisés, vous pouvez
englober beaucoup de machines virtuelles au sein de quelques hôtes
puissants et équilibrer les charges entre eux.</para>
<para>Avec VirtualBox, vous
pouvez même lancer des machines virtuelles en tant que purs serveurs
pour le VirtualBox Remote Desktop Protocol (VRDP) (protocole de bureau
distant de VirtualBox), avec un support complet du client USB. Cela
permet de consolider les machines de bureau dans une entreprise sur à
peine quelques serveurs RDP, tandis que les clients finals ne doivent
qu'être capables d'afficher des données VRDP.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Installations plus faciles de logiciels.</emphasis>
Les machines virtuelles peuvent être utilisées par des vendeurs de
logiciels pour livrer porter des configurations globales entières de
logiciels. Par exemple, la solution d'installer un serveur de messagerie
complet sur une machine réelle peut être une tâche ennuyeuse. Avec la
virtualisation, il devient possible de livrer une solution logicielle
globale entière, consistant éventuellement en plusieurs composants
différents, dans une machine virtuelle, ce qui s'appelle alors le plus
souvent l'<quote>appliance</quote>. Installer et lancer un serveur de
messagerie devient aussi facile que d'importer un tel service (appliance)
dans VirtualBox.</para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title id="virtintro">Un peu de terminologie</title>
<para>Quand on parle de virtualisation (et aussi pour comprendre les
chapitres suivants de cette documentation), il est utile de se familiariser
un peu avec une terminologie fondamentale, surtout les termes suivants :</para>
<glosslist>
<glossentry>
<glossterm>Système d'exploitation hôte (host OS) :</glossterm>
<glossdef>
<para>le système d'exploitation de l'ordinateur physique sur lequel
VirtualBox a été installé. Il existe des versions de VirtualBox pour
les hôtes Windows, Mac OS X, Linux et Solaris ; pour plus de
détails, merci de consulter le <xref linkend="hostossupport" />.
Tandis que les diverses versions de VirtualBox sont généralement
traitées ensemble dans ce document, il peut y avoir des différences
propres aux plateformes sur lesquelles nous reviendrons aux endroits
adéquats.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>Système d'exploitation invité (guest OS) :</glossterm>
<glossdef>
<para>le système d'exploitation qui est exécuté à l'intérieur de la
machine virtuelle. En théorie, VirtualBox peut exécuter n'importe quel
système d'exploitation x86 (DOS, Windows, OS/2, FreeBSD, OpenBSD), mais
pour obtenir du code invité les performances les plus proches d'une
installation native sur votre machine, nous avons dû effectuer un grand
nombre d'optimisations spécifiques à certains systèmes d'exploitation.
Donc si votre système d'exploitation <emphasis>peut</emphasis>
s'exécuter comme un invité,
nous supportons et optimisons officiellement quelques uns qui sont
sélectionnés (ce qui comprend néanmoins la plupart de ceux courants).</para>
<para>Voir <xref linkend="guestossupport" /> pour des détails.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>Machine virtuelle (VM).</glossterm>
<glossdef>
<para>Lorsqu'elle est exécutée, une VM est l'environnement spécial
que VirtualBox crée pour votre système d'exploitation invité. Donc, en
d'autres termes, vous lancez votre système d'exploitation invité
<quote>dans</quote> une VM. Normalement, une VM apparaîtra comme une
fenêtre sur le bureau de votre ordinateur, mais selon le front-ends
de VirtualBox que vous utilisez, il peut être affiché en mode plein
écran ou à distance en utilisant le VirtualBox Remote Desktop Protocol
(VRDP).</para>
<para>Parfois nous utilisons aussi le terme <quote>machine virtuelle</quote> d'une
façon plus abstraite : en interne, VirtualBox considère comme une
VM un ensemble de paramètres qui déterminent son comportement. Ils
comprennent tant les réglages matériels (combien de mémoire doit avoir
la VM, quels disques durs VirtualBox doit virtualiser parmi les
containers de fichiers, quel CDs sont montés etc.) que des informations
d'état (si la VM est actuellement en fonction, sauvegardée, ses prises
etc.).</para>
<para>Ces paramètres se reflètent aussi bien dans l'interface graphique
que dans le programme <computeroutput>VBoxManage</computeroutput> en
ligne de commande ; voir le chapitre <xref linkend="vboxmanage" />.
En d'autres termes, une VM est aussi ce que vous pouvez voir dans la
boîte de dialogue de ses paramètres.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>Suppléments invité.</glossterm>
<glossdef>
<para>Avec les <quote>Suppléments invité</quote>, nous faisons
référence à des paquets de logiciel spéciaux qui sont fournis avec
VirtualBox. Même s'ils font partie de VirtualBox, ils sont faits pour
être installés à l'intérieur d'une VM pour améliorer la performance de
l'OS invité et pour ajouter des fonctionnalités supplémentaires. Ceci
est décrit en détail au chapitre <xref linkend="guestadditions" />.</para>
</glossdef>
</glossentry>
</glosslist>
</sect1>
<sect1 id="features-overview">
<title>Aperçu des fonctionnalités</title>
<para>Voici un bref résumé des principales fonctionnalités de
VirtualBox :</para>
<itemizedlist>
<listitem>
<para><emphasis role="bold">Portabilité.</emphasis> VirtualBox s'exécute
sur un grand nombre de systèmes d'exploitation hôtes 32 bits et 64 bits
(de nouveau, voir le <xref linkend="hostossupport" /> pour des détails).
VirtualBox est ce qu'on appelle un hyperviseur <quote>hébergé</quote>
(parfois désigné comme un hyperviseur de <quote>type 2</quote>). Alors
qu'un hyperviseur <quote>bare-metal</quote> ou de <quote>type 1</quote>
s'exécuterait directement sur du matériel, VirtualBox exige qu'un système
d'exploitation soit installé. Il peut ainsi s'exécuter avec aux côtés
d'applications existantes sur cet hôte.</para>
<para>Dans une large mesure, VirtualBox
est, au plan fonctionnel, identique sur toutes les plateformes hôtes et
les mêmes formats de fichiers et d'images sont utilisés. Cela vous permet
de lancer des machines virtuelles créées sur un hôte sur un autre hôte
au système d'exploitation hôte différent ; par exemple vous pouvez
créer une machine virtuelle sur Windows puis la lancer sous Linux.</para>
<para>En outre, les machines virtuelles peuvent être importées et exportées
facilement en utilisant l'Open Virtualization Format (OVF, voir
<xref linkend="ovf" />), une technologie standard créée à cette fin.
Vous pouvez même importer des OVFs qui ont été créés avec un logiciel de
virtualisation différent.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Pas besoin de virtualiser du matériel.</emphasis>
Dans la plupart des scénarii, VirtualBox n'exige pas que les
fonctionnalités du processeur soit construites dans le nouveau matériel
comme Intel VT-x ou AMD-V. Contrairement à bien d'autres solutions de
virtualisation, vous pouvez ainsi utiliser VirtualBox même sur du
matériel ancien où ces fonctionnalités ne sont pas présentes. Vous
pouvez trouver plus de détails au chapitre <xref
linkend="hwvirt" />.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Suppléments invité : dossiers partagés,
fenêtres transparentes, virtualisation 3D.</emphasis> Les suppléments
invité de VirtualBox sont des paquets de logiciels qui peuvent être
installés <emphasis>à l'intérieur</emphasis> des systèmes invité
supportés pour améliorer leur performance et pour offrir une meilleure
intégration supplémentaire et une communication avec le système hôte.
Après avoir installé les suppléments invité, une machine virtuelle
supportera l'ajustement automatique des résolutions graphiques, les
fenêtres transparentes seamless, l'accélération 3D graphique et davantage.
Les suppléments invité sont décrits en détail au chapitre <xref
linkend="guestadditions" />.</para>
<para>En particulier, les suppléments invité offrent les
<quote>répertoires partagés</quote> qui vous permettent d'accéder à des
fichiers à partir du système hôte à partir de l'intérieur de la machine
invitée. Les dossiers partagés sont décrits au chapitre <xref
linkend="sharedfolders" />.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Excellent support matériel.</emphasis> Entre
autres, VirtualBox supporte :</para>
<itemizedlist>
<listitem>
<para><emphasis role="bold">Multitâches invité
(SMP).</emphasis> VirtualBox peut présenter jusqu'à 32 processeurs
virtuels à une machine virtuelle, indépendamment du nombre de cœurs
présents effectivement sur le processeur de votre hôte.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Support du périphérique USB 2.0.</emphasis>
VirtualBox implémente un contrôleur USB virtuel et vous permet de
connecter à vos machines virtuelles des périphériques USB de votre
choix sans devoir installer de pilotes spécifiques aux
périphériques sur l'hôte. Le support USB n'est pas limité à certaines
catégories de périphériques. Pour des détails, voir le <xref
linkend="settings-usb" />.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Compatibilité matérielle.</emphasis>
VirtualBox virtualise une large gamme de périphériques, dont beaucoup
de périphériques qui sont en général fournis par d'autres plateformes
de virtualisation. Cela inclut les contrôleurs de disque IDE, SCSI
et SATA, plusieurs cartes réseau et cartes sons virtuelles, ports
Interrupt Controller (I/O APIC) (contrôleur d'interruption
de systèmes PC modernes. Cela facilite le clonage d'images de PC à
partir de machines réelles et l'importation de machines virtuelles
tierces dans VirtualBox.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Support ACPI complet.</emphasis>
L'Advanced Configuration and Power Interface (ACPI) (interface de
configuration et d'énergie avancée) est pleinement supportée par
VirtualBox. Avec son <emphasis role="bold">support unique de statut
d'énergie ACPI</emphasis>, VirtualBox peut même signaler à des
systèmes d'exploitation invités gérant l'ACPI le statut de l'énergie
de l'hôte. Pour les systèmes portables fonctionnant sur batterie,
l'invité peut ainsi activer l'économie d'énergie et notifier
l'utilisateur de la charge restante (par exemple en modes plein
écran).</para>
</listitem>
<listitem>
<para><emphasis role="bold">Résolutions de plusieurs écrans..</emphasis>
Les machines virtuelles de VirtualBox supportent les résolutions
d'écran autant importantes qu'avec un écran physique, leur permettant
d'être étendus à un grand nombre d'écrans attachés au système hôte.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Support iSCSI inclu.</emphasis>
Cette fonctionnalité unique vous permet de connecter une machine
virtuelle directement à un serveur de stockage iSCSI sans passer
par le système hôte. La VM accède la cible iSCSI directement sans
la charge intermédiaire requise pour des disques durs de
virtualisation dans des fichiers de container. Pour des détails,
voir chapitre <xref linkend="storage-iscsi" />.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Amorçage par réseau PXE.</emphasis>
Les cartes réseau virtuelles intégrées de VirtualBox supportent
complètement l'amorçage à distance à travers le Preboot Execution
Environment (PXE (environnement d'exécution préamorçage).</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para><emphasis role="bold">Multigénération de prises branchées.</emphasis>
VirtualBox peut sauvegarder des prises de votre choix de l'état de la
machine virtuelle. Vous pouvez revenir en arrière au moment voulu et
rétablir la machine virtuelle dans n'importe quel des dépôts et démarrer
une configuration de VM alternative à partir de là, en créant de fait
une arborescence de dépôts. Pour des détails, voir le <xref linkend="snapshots" />.
Vous pouvez supprimer un prise alors que la VM tourne.</para>
</listitem>
<listitem>
$$ <para><emphasis role="bold">Clean architecture; unprecedented
modularity.</emphasis> VirtualBox has an extremely modular design with
well-defined internal programming interfaces and a clean separation of
client and server code. This makes it easy to control it from several
interfaces at once: for example, you can start a VM simply by clicking
on a button in the VirtualBox graphical user interface and then
control that machine from the command line, or even remotely. See
<xref linkend="frontends" /> for details.</para>
<para>Due to its modular architecture, VirtualBox can also expose its
full functionality and configurability through a comprehensive
<emphasis role="bold">software development kit (SDK),</emphasis> which
allows for integrating every aspect of VirtualBox with other software
systems. Please see <xref linkend="VirtualBoxAPI" /> for
details.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Remote machine display.</emphasis> You can
run any virtual machine in a special VirtualBox program that acts as a
server for the VirtualBox Remote Desktop Protocol (VRDP), a
backward-compatible extension of the standard Remote Desktop Protocol.
With this unique feature, VirtualBox provides high-performance remote
access to any virtual machine.</para>
<para>VirtualBox's VRDP support does not rely on the RDP server that
is built into Microsoft Windows. Instead, a custom VRDP server has
been built directly into the virtualization layer. As a result, it
works with any operating system (even in text mode) and does not
require application support in the virtual machine either.</para>
<para>VRDP support is described in detail in <xref
linkend="vrdp" />.</para>
<para>On top of this special capacity, VirtualBox offers you more
unique features:<itemizedlist>
<listitem>
<para><emphasis role="bold">Extensible RDP
authentication.</emphasis> VirtualBox already supports Winlogon
on Windows and PAM on Linux for RDP authentication. In addition,
it includes an easy-to-use SDK which allows you to create
arbitrary interfaces for other methods of authentication; see
<xref linkend="vbox-authenticate-sdk" /> for details.</para>
</listitem>
<listitem>
<para><emphasis role="bold">USB over RDP.</emphasis> Via RDP
virtual channel support, VirtualBox also allows you to connect
arbitrary USB devices locally to a virtual machine which is
running remotely on a VirtualBox RDP server; see <xref
linkend="usb-over-rdp" /> for details.</para>
</listitem>
</itemizedlist></para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title id="hostossupport">Supported host operating systems</title>
<para>Currently, VirtualBox runs on the following host operating
systems:</para>
<itemizedlist>
<listitem>
<para><emphasis role="bold">Windows</emphasis> hosts:<itemizedlist>
<listitem>
<para>Windows XP, all service packs (32-bit)</para>
</listitem>
<listitem>
<para>Windows Server 2003 (32-bit)</para>
</listitem>
<listitem>
<para>Windows Vista (32-bit and 64-bit<footnote>
<para>Support for 64-bit Windows was added with VirtualBox
1.5.</para>
</footnote>).</para>
</listitem>
<listitem>
<para>Windows Server 2008 (32-bit and 64-bit)</para>
</listitem>
<listitem>
<para>Windows 7 (32-bit and 64-bit)</para>
</listitem>
</itemizedlist></para>
</listitem>
<listitem>
<para><emphasis role="bold">Mac OS X</emphasis> hosts:<footnote>
<para>Preliminary Mac OS X support (beta stage) was added with
VirtualBox 1.4, full support with 1.6. Mac OS X 10.4 (Tiger)
support was removed with VirtualBox 3.1.</para>
</footnote></para>
<itemizedlist>
<listitem>
<para>10.5 (Leopard, 32-bit)</para>
</listitem>
<listitem>
<para>10.6 (Snow Leopard, 32-bit and 64-bit)</para>
</listitem>
</itemizedlist>
<para>Intel hardware is required; please see <xref
linkend="KnownIssues" /> also.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Linux</emphasis> hosts (32-bit and
64-bit<footnote>
<para>Support for 64-bit Linux was added with VirtualBox
1.4.</para>
</footnote>). Among others, this includes:<itemizedlist>
<listitem>
<para>Ubuntu 6.06 ("Dapper Drake"), 6.10 ("Edgy Eft"), 7.04
("Feisty Fawn"), 7.10 ("Gutsy Gibbon"), 8.04 ("Hardy Heron"),
8.10 ("Intrepid Ibex"), 9.04 ("Jaunty Jackalope"), 9.10 ("Karmic
Koala"), 10.04 ("Lucid Lynx").</para>
</listitem>
<listitem>
("lenny")</para>
</listitem>
<listitem>
<para>Oracle Enterprise Linux 4 and 5</para>
</listitem>
<listitem>
<para>Redhat Enterprise Linux 4 and 5</para>
</listitem>
<listitem>
<para>Fedora Core 4 to 12</para>
</listitem>
<listitem>
<para>Gentoo Linux</para>
</listitem>
<listitem>
<para>SUSE Linux 9 and 10, openSUSE 10.3, 11.0, 11.1,
11.2</para>
</listitem>
<listitem>
<para>Mandriva 2007.1, 2008.0, 2009.1, 2010.0</para>
</listitem>
</itemizedlist></para>
<para>It should be possible to use VirtualBox on most systems based on
Linux kernel 2.6 using either the VirtualBox installer or by doing a
manual installation; see <xref linkend="install-linux-host" />.</para>
<para>Note that starting with VirtualBox 2.1, Linux 2.4-based host
operating systems are no longer supported.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Solaris</emphasis> hosts (32-bit and
64-bit<footnote>
<para>Support for OpenSolaris was added with VirtualBox
1.6.</para>
</footnote>) are supported with the restrictions listed in <xref
linkend="KnownIssues" />:<itemizedlist>
<listitem>
<para>OpenSolaris (2008.05 and higher, "Nevada" build 86 and
higher)</para>
</listitem>
<listitem>
<para>Solaris 10 (u5 and higher)</para>
</listitem>
</itemizedlist></para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title>Installing and starting VirtualBox</title>
<para>VirtualBox comes in many different packages, and <emphasis
role="bold">installation</emphasis> depends on your host platform. If you
have installed software before, installation should be straightforward as
on each host platform, VirtualBox uses the installation method that is
most common and easy to use. If you run into trouble or have special
requirements, please refer to <xref linkend="installation" /> for details
about the various installation methods.</para>
<para>After installation, you can start VirtualBox as
follows:<itemizedlist>
<listitem>
<para>On a Windows host, in the standard "Programs" menu, click on
the item in the "VirtualBox" group. On Vista or Windows 7, you can
also type "VirtualBox" in the search box of the "Start" menu.</para>
</listitem>
<listitem>
<para>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 onto your Dock.)</para>
</listitem>
<listitem>
<para>On a Linux or Solaris host, depending on your desktop
environment, a "VirtualBox" item may have been placed in either the
"System" or "System Tools" group of your "Applications" menu.
Alternatively, you can type
<computeroutput>VirtualBox</computeroutput> in a terminal.</para>
</listitem>
</itemizedlist></para>
<para>When you start VirtualBox for the first time, a window like the
following should come up:</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject>On the left, you can see a pane that will later list all
your virtual machines. Since you have not created any, the list is empty.
A row of buttons above it allows you to create new VMs and work on
existing VMs, once you have some. The pane on the right displays the
properties of the virtual machine currently selected, if any. Again, since
you don't have any machines yet, the pane displays a welcome
message.</para>
<para>To give you an idea what VirtualBox might look like later, after you
have created many machines, here's another example:</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject></para>
</sect1>
<sect1 id="gui-createvm">
<title>Creating your first virtual machine</title>
<para>Click on the "New" button at the top of the VirtualBox window. A
wizard will pop up to guide you through setting up a new virtual machine
(VM):</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject>On the following pages, the wizard will ask you for the
bare minimum of information that is needed to create a VM, in
particular:<orderedlist>
<listitem>
<para>A <emphasis role="bold">name</emphasis> for your VM, and the
<emphasis role="bold">type of operating system</emphasis> (OS) you
want to install.</para>
<para>The name is what you will later see in the VirtualBox main
window, and what your settings will be stored under. It is purely
informational, but once you have created a few VMs, you will
appreciate if you have given your VMs informative names. "My VM"
probably is therefore not as useful as "Windows XP SP2".</para>
<para>For "Operating System Type", select the operating system that
you want to install later. Depending on your selection, VirtualBox
will enable or disable certain VM settings that your guest operating
system may require. This is particularly important for 64-bit guests
(see <xref linkend="intro-64bitguests" />). It is therefore
recommended to always set it to the correct value.</para>
</listitem>
<listitem>
<para>The <emphasis role="bold">amount of memory (RAM)</emphasis>
that the virtual machine should have for itself. Every time a
virtual machine is started, VirtualBox will allocate this much
memory from your host machine and present it to the guest operating
system, which will report this size as the (virtual) computer's
installed RAM.</para>
<para><note>
<para>Choose this setting carefully! The memory you give to the
VM will not be available to your host OS while the VM is
running, so do not specify more than you can spare. For example,
if your host machine has 1 GB of RAM and you enter 512 MB as the
amount of RAM for a particular virtual machine, while that VM is
running, you will only have 512 MB left for all the other
software on your host. If you run two VMs at the same time, even
more memory will be allocated for the second VM (which may not
even be able to start if that memory is not available). On the
other hand, you should specify as much as your guest OS (and
your applications) will require to run properly.</para>
</note></para>
<para>A Windows XP guest will require at least a few hundred MB RAM
to run properly, and Windows Vista will even refuse to install with
less than 512 MB. Of course, if you want to run graphics-intensive
applications in your VM, you may require even more RAM.</para>
<para>So, as a rule of thumb, if you have 1 GB of RAM or more in
your host computer, it is usually safe to allocate 512 MB to each
VM. But, in any case, make sure you always have at least 256 to 512
MB of RAM left on your host operating system. Otherwise you may
cause your host OS to excessively swap out memory to your hard disk,
effectively bringing your host system to a standstill.</para>
<para><note>
<para>VirtualBox restricts the amount of guest RAM to 1500 MB on
32-bit Windows hosts and to 2560 MB on 32-bit Linux and Solaris
hosts due to address-space limitations. These restrictions do
not apply to 64-bit hosts.</para>
</note></para>
<para>As with the other settings, you can change this setting later,
after you have created the VM.</para>
</listitem>
<listitem>
<para>Next, you must specify a <emphasis role="bold">virtual hard
disk</emphasis> for your VM.</para>
<para>There are many and potentially complicated ways in which
VirtualBox can provide hard disk space to a VM (see <xref
linkend="storage" /> for details), but the most common way is to use
a large image file on your "real" hard disk, whose contents
VirtualBox presents to your VM as if it were a complete hard
disk.</para>
<para>The wizard shows you the following window:</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject></para>
<para>The wizard allows you to create an image file or use an
existing one. Note also that the disk images can be separated from a
particular VM, so even if you delete a VM, you can keep the image,
or copy it to another host and create a new VM for it there.</para>
<para>In the wizard, you have the following options:</para>
<para><itemizedlist>
<listitem>
<para>If you have previously created any virtual hard disks
which have not been attached to other virtual machines, you
can select those from the drop-down list in the wizard
window.</para>
</listitem>
<listitem>
<para>Otherwise, to create a new virtual hard disk, press the
<emphasis role="bold">"New"</emphasis> button.</para>
</listitem>
<listitem>
<para>Finally, for more complicated operations with virtual
disks, the <emphasis role="bold">"Existing..."</emphasis>
button will bring up the Virtual Media Manager, which is
described in more detail in <xref linkend="vdis" />.</para>
</listitem>
</itemizedlist>Most probably, if you are using VirtualBox for the
first time, you will want to create a new disk image. Hence, press
the "New" button.</para>
<para>This brings up another window, the <emphasis
role="bold">"Create New Virtual Disk Wizard".</emphasis></para>
<para>VirtualBox supports two types of image files:<itemizedlist>
<listitem>
<para>A <emphasis role="bold">dynamically expanding
file</emphasis> will only grow in size when the guest actually
stores data on its virtual hard disk. It will therefore
initially be small on the host hard drive and only later grow
to the size specified as it is filled with data.</para>
</listitem>
<listitem>
<para>A <emphasis role="bold">fixed-size file</emphasis> will
immediately occupy the file specified, even if only a fraction
of the virtual hard disk space is actually in use. While
occupying much more space, a fixed-size file incurs less
overhead and is therefore slightly faster than a dynamically
expanding file.</para>
</listitem>
</itemizedlist></para>
<para>For details about the differences, please refer to <xref
linkend="vdidetails" />.</para>
<para>To prevent your physical hard disk from running full,
VirtualBox limits the size of the image file. Still, it needs to be
large enough to hold the contents of your operating system and the
applications you want to install -- for a modern Windows or Linux
guest, you will probably need several gigabytes for any serious
use:</para>
<mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject>
<para>After having selected or created your image file, again press
<emphasis role="bold">"Next"</emphasis> to go to the next
page.</para>
</listitem>
<listitem>
<para>After clicking on <emphasis role="bold">"Finish"</emphasis>,
your new virtual machine will be created. You will then see it in
the list on the left side of the main window, with the name you have
entered.</para>
</listitem>
</orderedlist></para>
</sect1>
<sect1>
<title>Running your virtual machine</title>
<para>You will now see your new virtual machine in the list of virtual
machines, at the left of the VirtualBox main window. To start the virtual
machine, simply double-click on it, or select it and press the "Start"
button at the top.</para>
<para>This opens up a new window, and the virtual machine which you
selected will boot up. Everything which would normally be seen on the
virtual system's monitor is shown in the window, as can be seen with the
image in <xref linkend="virtintro" />.</para>
<para>Since this is the first time you are running this VM, another wizard
will show up to help you select an installation medium. Since the VM is
created empty, it would otherwise behave just like a real computer with no
operating system installed: it will do nothing and display an error
message that it cannot boot an operating system.</para>
<para>For this reason, the "First Start Wizard" helps you select an
operating system medium to install an operating system from. In most
cases, this will either be a real CD or DVD (VirtualBox can then configure
the virtual machine to use your host's drive), or you might have an ISO
image of a CD or DVD handy, which VirtualBox can then present to the
virtual machine.</para>
<para>In both cases, after making the choices in the wizard, you will be
able to install your operating system.</para>
<para>In general, you can use the virtual machine much like you would use
a real computer. There are couple of points worth mentioning
however.</para>
<sect2>
<title>Keyboard and mouse support in virtual machines</title>
<sect3>
<title id="keyb_mouse_normal">Capturing and releasing keyboard and
mouse</title>
<para>As of version 3.2, VirtualBox provides a virtual USB tablet
device to new virtual machines through which mouse events are
communicated to the guest operating system. As a result, if you are
running a fairly recent guest operating system that can handle such
devices, mouse support may work out of the box without the mouse being
"captured" as described below; see <xref
linkend="settings-motherboard" /> for more information.</para>
<para>Otherwise, if the virtual machine only sees standard PS/2 mouse
and keyboard devices, since the operating system in the virtual
machine does not "know" that it is not running on a real computer, it
expects to have exclusive control over your keyboard and mouse. This
is, however, not the case since, unless you are running the VM in
full-screen mode, your VM needs to share keyboard and mouse with other
applications and possibly other VMs on your host.</para>
<para>As a result, initially after installing a guest operating system
and before you install the Guest Additions (we will explain this in a
minute), only one of the two -- your VM or the rest of your computer
-- can "own" the keyboard and the mouse. You will see a
<emphasis>second</emphasis> mouse pointer which will always be
confined to the limits of the VM window. Basically, you activate the
VM by clicking inside it.</para>
<para>To return ownership of keyboard and mouse to your host operating
system, VirtualBox reserves a special key on your keyboard for itself:
the <emphasis role="bold">"host key".</emphasis> By default, this is
the <emphasis>right Control key</emphasis> on your keyboard; on a Mac
host, the default host key is the left Command key. You can change
this default in the VirtualBox Global Settings. In any case, the
current setting for the host key is always displayed <emphasis>at the
bottom right of your VM window,</emphasis> should you have forgotten
about it:</para>
<para><mediaobject>
<imageobject>
width="7cm" />
</imageobject>
</mediaobject>In detail, all this translates into the
following:</para>
<para><itemizedlist>
<listitem>
<para>Your <emphasis role="bold">keyboard</emphasis> is owned by
the VM if the VM window on your host desktop has the keyboard
focus (and then, if you have many windows open in your guest
operating system as well, the window that has the focus in your
VM). This means that if you want to type within your VM, click
on the title bar of your VM window first.</para>
<para>To release keyboard ownership, press the Host key (as
explained above, typically the right Control key).</para>
<para>Note that while the VM owns the keyboard, some key
sequences (like Alt-Tab for example) will no longer be seen by
the host, but will go to the guest instead. After you press the
host key to re-enable the host keyboard, all key presses will go
through the host again, so that sequences like Alt-Tab will no
longer reach the guest.</para>
</listitem>
<listitem>
<para>Your <emphasis role="bold">mouse</emphasis> is owned by
the VM only after you have clicked in the VM window. The host
mouse pointer will disappear, and your mouse will drive the
guest's pointer instead of your normal mouse pointer.</para>
<para>Note that mouse ownership is independent of that of the
keyboard: even after you have clicked on a titlebar to be able
to type into the VM window, your mouse is not necessarily owned
by the VM yet.</para>
<para>To release ownership of your mouse by the VM, also press
the Host key.</para>
</listitem>
</itemizedlist></para>
<para>As this behavior can be inconvenient, VirtualBox provides a set
of tools and device drivers for guest systems called the "VirtualBox
Guest Additions" which make VM keyboard and mouse operation a lot more
seamless. Most importantly, the Additions will get rid of the second
"guest" mouse pointer and make your host mouse pointer work directly
in the guest.</para>
<para>This will be described later in <xref
linkend="guestadditions" />.</para>
</sect3>
<sect3>
<title>Typing special characters</title>
<para>Operating systems expect certain key combinations to initiate
certain procedures. Some of these key combinations may be difficult to
enter into a virtual machine, as there are three candidates as to who
receives keyboard input: the host operating system, VirtualBox, or the
guest operating system. Who of these three receives keypresses depends
on a number of factors, including the key itself.</para>
<itemizedlist>
<listitem>
<para>Host operating systems reserve certain key combinations for
themselves. For example, it is impossible to enter the <emphasis
role="bold">Ctrl+Alt+Delete</emphasis> combination if you want to
reboot the guest operating system in your virtual machine, because
this key combination is usually hard-wired into the host OS (both
Windows and Linux intercept this), and pressing this key
combination will therefore reboot your
<emphasis>host</emphasis>.</para>
<para>Also, on Linux and Solairs hosts, which use the X Window
System, the key combination <emphasis
role="bold">Ctrl+Alt+Backspace</emphasis> normally resets the X
server (to restart the entire graphical user interface in case it
got stuck). As the X server intercepts this combination, pressing
it will usually restart your <emphasis>host</emphasis> graphical
user interface (and kill all running programs, including
VirtualBox, in the process).</para>
<para>Third, on Linux hosts supporting virtual terminals, the key
combination <emphasis role="bold">Ctrl+Alt+Fx</emphasis> (where Fx
is one of the function keys from F1 to F12) normally allows to
switch between virtual terminals. As with Ctrl+Alt+Delete, these
combinations are intercepted by the host operating system and
therefore always switch terminals on the
<emphasis>host</emphasis>.</para>
<para>If, instead, you want to send these key combinations to the
<emphasis>guest</emphasis> operating system in the virtual
machine, you will need to use one of the following methods:</para>
<itemizedlist>
<listitem>
<para>Use the items in the "Machine" menu of the virtual
machine window. There you will find "Insert Ctrl+Alt+Delete"
and "Ctrl+Alt+Backspace"; the latter will only have an effect
with Linux or Solaris guests, however.</para>
</listitem>
<listitem>
<para>Press special key combinations with the Host key
(normally the right Control key), which VirtualBox will then
translate for the virtual machine:<itemizedlist>
<listitem>
<para><emphasis role="bold">Host key + Del</emphasis> to
send Ctrl+Alt+Del (to reboot the guest);</para>
</listitem>
<listitem>
<para><emphasis role="bold">Host key +
Backspace</emphasis> to send Ctrl+Alt+Backspace (to
restart the graphical user interface of a Linux or
Solaris guest);</para>
</listitem>
<listitem>
<para><emphasis role="bold">Host key + F1</emphasis> (or
other function keys) to simulate Ctrl+Alt+F1 (or other
function keys, i.e. to switch between virtual terminals
in a Linux guest).</para>
</listitem>
</itemizedlist></para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>For some other keyboard combinations such as <emphasis
role="bold">Alt-Tab</emphasis> (to switch between open windows),
VirtualBox allows you to configure whether these combinations will
affect the host or the guest, if a virtual machine currently has
the focus. This is a global setting for all virtual machines and
can be found under "File" -> "Preferences" -> "Input" ->
"Auto-capture keyboard".</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Changing removable media</title>
<para>While a virtual machine is running, you can change removable media
in the "Devices" menu of the VM's window. Here you can select in detail
what VirtualBox presents to your VM as a CD, DVD, or floppy.</para>
<para>The settings are the same as would be available for the VM in the
"Settings" dialog of the VirtualBox main window, but since that dialog
is disabled while the VM is in the "running" or "saved" state, this
extra menu saves you from having to shut down and restart the VM every
time you want to change media.</para>
<para>Hence, in the "Devices" menu, VirtualBox allows you to attach the
host drive to the guest or select a floppy or DVD image using the Disk
Image Manager, all as described in <xref
linkend="configbasics" />.</para>
</sect2>
<sect2>
<title>Saving the state of the machine</title>
<para>When you click on the "Close" button of your virtual machine
window (at the top right of the window, just like you would close any
other window on your system) (or press the Host key together with "Q"),
VirtualBox asks you whether you want to "save" or "power off" the
VM.</para>
<para><mediaobject>
<imageobject>
width="7cm" />
</imageobject>
</mediaobject>The difference between these three options is crucial.
They mean:</para>
<itemizedlist>
<listitem>
<para><emphasis role="bold">Save the machine state:</emphasis> With
this option, VirtualBox "freezes" the virtual machine by completely
saving its state to your local disk. When you later resume the VM
(by again clicking the "Start" button in the VirtualBox main
window), you will find that the VM continues exactly where it was
left off. All your programs will still be open, and your computer
resumes operation.</para>
<para>Saving the state of a virtual machine is thus in some ways
similar to suspending a laptop computer (e.g. by closing its
lid).</para>
</listitem>
<listitem>
<para><emphasis role="bold">Send the shutdown signal.</emphasis>
This will send an ACPI shutdown signal to the virtual machine, which
has the same effect as if you had pressed the power button on a real
computer. So long as a fairly modern operating system is installed
and running in the VM, this should trigger a proper shutdown
mechanism in the VM.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Power off the machine:</emphasis> With
this option, VirtualBox also stops running the virtual machine, but
<emphasis>without</emphasis> saving its state.</para>
<para>This is equivalent to pulling the power plug on a real
computer without shutting it down properly. If you start the machine
again after powering it off, your operating system will have to
reboot completely and may begin a lengthy check of its (virtual)
system disks.</para>
<para>As a result, this should not normally be done, since it can
potentially cause data loss or an inconsistent state of the guest
system on disk.</para>
<para>As an exception, if your virtual machine has any snapshots
(see the next chapter), you can use this option to quickly <emphasis
role="bold">restore the current snapshot</emphasis> of the virtual
machine. Only in that case, powering off the machine is not
harmful.</para>
</listitem>
</itemizedlist>
<para>The <emphasis role="bold">"Discard"</emphasis> button in the main
VirtualBox window discards a virtual machine's saved state. This has the
same effect as powering it off, and the same warnings apply.</para>
</sect2>
</sect1>
<sect1 id="snapshots">
<title>Snapshots</title>
<para>With snapshots, you can save a particular state of a virtual machine
for later use. At any later time, you can revert to that state, even
though you may have changed the VM considerably since then.</para>
<para>You can see the snapshots of a virtual machine by first selecting a
machine from the list on the left of the VirtualBox main window and then
selecting the "Snapshots" tab on the right. Initially, until you take a
snapshot of the machine, that list is empty except for the "Current state"
item, which represents the "Now" point in the lifetime of the virtual
machine.</para>
<para>There are three operations related to snapshots:<orderedlist>
<listitem>
<para>You can <emphasis role="bold">take a
snapshot</emphasis>.<itemizedlist>
<listitem>
<para>If your VM is currently running, select "Take snapshot"
from the "Machine" pull-down menu of the VM window.</para>
</listitem>
<listitem>
<para>If your VM is currently in either the "saved" or the
"powered off" state (as displayed next to the VM in the
VirtualBox main window), click on the "Snapshots" tab on the
top right of the main window, and then<itemizedlist>
<listitem>
<para>either on the small camera icon (for "Take
snapshot") or</para>
</listitem>
<listitem>
<para>right-click on the "Current State" item in the
list and select "Take snapshot" from the menu.</para>
</listitem>
</itemizedlist></para>
</listitem>
</itemizedlist></para>
<para>In any case, a window will pop up and ask you for a snapshot
name. This name is purely for reference purposes to help you
remember the state of the snapshot. For example, a useful name would
be "Fresh installation from scratch, no external drivers". You can
also add a longer text in the "Description" field if you
want.</para>
<para>Your new snapshot will then appear in the list of snapshots
under the "Snapshots" tab. Underneath, you will see an item called
"Current state", signifying that the current 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 will be displayed in
sequence, and each subsequent snapshot is a derivation of the
earlier one:<mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject></para>
<para>VirtualBox allows you to take an unlimited number of snapshots
-- the only limitation is the size of your disks. Keep in mind that
each snapshot stores the state of the virtual machine and thus takes
some disk space.</para>
</listitem>
<listitem>
<para>You can <emphasis role="bold">restore a snapshot</emphasis> by
right-clicking on any snapshot you have taken in the list of
snapshots. By restoring a snapshot, you go back (or forward) in
time: the current state of the machine is lost, and the machine is
restored to exactly the same state as it was when then snapshot was
taken.<footnote>
<para>Both the terminology and the functionality of restoring
snapshots has changed with VirtualBox 3.1. Before that version,
it was only possible to go back to the very last snapshot taken
-- not earlier ones, and the operation was called "Discard
current state" instead of "Restore last snapshot". The
limitation has been lifted with version 3.1. It is now possible
to restore <emphasis>any</emphasis> snapshot, going backward and
forward in time.</para>
</footnote></para>
<note>
<para>Restoring a snapshot will affect the virtual hard drives
that are connected to your VM, as the entire state of the virtual
hard drive will be reverted as well. This means also that all
files that have been created since the snapshot and all other file
changes <emphasis>will be lost. </emphasis>In order to prevent
such data loss while still making use of the snapshot feature, it
is possible to add a second hard drive in "write-through" mode
using the <computeroutput>VBoxManage</computeroutput> interface
and use it to store your data. As write-through hard drives are
<emphasis>not</emphasis> included in snapshots, they remain
unaltered when a machine is reverted. See <xref
linkend="hdimagewrites" os="" /> for details.</para>
</note>
<para>By restoring an earlier snapshot and taking more snapshots
from there, it is even possible to create a kind of alternate
reality and to switch between these different histories of the
virtual machine. This can result in a whole tree of virtual machine
snapshots, as shown in the screenshot above.</para>
</listitem>
<listitem>
<para>You can also <emphasis role="bold">delete a
snapshot</emphasis>, which will not affect the state of the virtual
machine, but only release the files on disk that VirtualBox used to
store the snapshot data, thus freeing disk space. To delete a
snapshot, right-click on it in the snapshots tree and select
"Delete". As of VirtualBox 3.2, snapshots can be deleted even while
a machine is running.<note>
<para>Whereas taking and restoring snapshots are fairly quick
operations, deleting a snapshot can take a considerable amount
of time since large amounts of data may need to be copied
between several disk image files. Temporary disk files may also
need large amounts of disk space while the operation is in
progress.</para>
</note></para>
<para>There are some situations which cannot be handled while a VM
is running, and you will get an appropriate message that you need to
perform this snapshot deletion when the VM is shut down.</para>
</listitem>
</orderedlist></para>
<para>Think of a snapshot as a point in time that you have preserved. More
formally, a snapshot consists of three things:<itemizedlist>
<listitem>
<para>It contains a complete copy of the VM settings, so that when
you restore a snapshot, the VM settings are restored as well. (For
example, if you changed the hard disk configuration, that change is
undone when you restore the snapshot.)</para>
</listitem>
<listitem>
<para>The state of all the virtual disks attached to the machine is
preserved. Going back to a snapshot means that all changes, bit by
bit, that had been made to the machine's disks will be undone as
well.</para>
<para>(Strictly speaking, this is only true for virtual hard disks
in "normal" mode. As mentioned above, you can configure disks to
behave differently with snapshots; see <xref
linkend="hdimagewrites" />. Even more formally and technically
correct, it is not the virtual disk itself that is restored when a
snapshot is restored. Instead, when a snapshot is taken, VirtualBox
creates differencing images which contain only the changes since the
snapshot were taken, and when the snapshot is restored, VirtualBox
throws away that differencing image, thus going back to the previous
state. This is both faster and uses less disk space. For the
details, which can be complex, please see <xref
linkend="diffimages" />.)</para>
</listitem>
<listitem>
<para>Finally, if you took a snapshot while the machine was running,
the memory state of the machine is also saved in the snapshot (the
same way the memory can be saved when you close the VM window) so
that when you restore the snapshot, execution resumes at exactly the
point when the snapshot was taken.</para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1>
<title id="configbasics">Virtual machine configuration</title>
<para>When you select a virtual machine from the list in the main
VirtualBox window, you will see a summary of that machine's settings on
the right of the window, under the "Details" tab.</para>
<para>Clicking on the "Settings" button in the toolbar at the top of
VirtualBox main window brings up a detailed window where you can configure
many of the properties of the VM that is currently selected. But be
careful: even though it is possible to change all VM settings after
installing a guest operating system, certain changes might prevent a guest
operating system from functioning correctly if done after
installation.</para>
<note>
<para>The "Settings" button is disabled while a VM is either in the
"running" or "saved" state. This is simply because the settings dialog
allows you to change fundamental characteristics of the virtual computer
that is created for your guest operating system, and this operating
system may not take it well when, for example, half of its memory is
taken away from under its feet. As a result, if the "Settings" button is
disabled, shut down the current VM first.</para>
</note>
<para>VirtualBox provides a plethora of parameters that can be changed for
a virtual machine. The various settings that can be changed in the
"Settings" window are described in detail in <xref
linkend="BasicConcepts" />. Even more parameters are available with the
command line interface; see <xref linkend="vboxmanage" />.</para>
<para>For now, if you have just created an empty VM, you will probably be
you want to make a CD or a DVD available the first time you start it, in
order to install your guest operating system.</para>
<para>For this, you have two options:</para>
<itemizedlist>
<listitem>
<para>If you have actual CD or DVD media from which you want to
install your guest operating system (e.g. in the case of a Windows
installation CD or DVD), put the media into your host's CD or DVD
drive.</para>
select "Host drive" with the correct drive letter (or, in the case of
a Linux host, device file).</para>
<para>This will allow your VM to access the media in your host drive,
and you can proceed to install from there.</para>
</listitem>
<listitem>
<para>If you have downloaded installation media from the Internet in
the form of an ISO image file (most probably in the case of a Linux
distribution), you would normally burn this file to an empty CD or DVD
and proceed as just described. With VirtualBox however, you can skip
this step and mount the ISO file directly. VirtualBox will then
present this file as a CD or DVD-ROM drive to the virtual machine,
much like it does with virtual hard disk images.</para>
section and select "ISO image file". This brings up the Virtual Media
Manager, where you perform the following steps:</para>
<para><orderedlist>
<listitem>
<para>Press the "Add" button to add your ISO file to the list of
registered images. This will present an ordinary file dialog
that allows you to find your ISO file on your host
machine.</para>
</listitem>
<listitem>
<para>Back to the manager window, select the ISO file that you
just added and press the "Select" button. This selects the ISO
file for your VM.</para>
</listitem>
</orderedlist></para>
<para>The Virtual Media Manager is described in detail in <xref
linkend="vdis" />.</para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title>Deleting virtual machines</title>
<para>To remove a virtual machine which you no longer need, right-click on
it in the list of virtual machines in the main window and select "Delete"
from the context menu that comes up. All settings for that machine will be
lost.</para>
<para>The "Delete" menu item is disabled while a machine is in "Saved"
state. To delete such a machine, discard the saved state first by pressing
on the "Discard" button.</para>
<para>However, any hard disk images attached to the machine will be kept;
you can delete those separately using the Virtual Media Manager; see <xref
linkend="vdis" />.</para>
<para>You cannot delete a machine which has snapshots or is in a saved
state, so you must discard these first.</para>
</sect1>
<sect1 id="ovf">
<title>Importing and exporting virtual machines</title>
<para>Starting with version 2.2, VirtualBox can import and export virtual
machines in the industry-standard Open Virtualization Format (OVF).</para>
<para>OVF is a cross-platform standard supported by many virtualization
products which allows for creating ready-made virtual machines that can
then be imported into a virtualizer such as VirtualBox. As opposed to
other virtualization products, VirtualBox now supports OVF with an
easy-to-use graphical user interface as well as using the command line.
This allows for packaging so-called <emphasis role="bold">virtual
appliances</emphasis>: disk images together with configuration settings
that can be distributed easily. This way one can offer complete
ready-to-use software packages (operating systems with applications) that
need no configuration or installation except for importing into
VirtualBox.<note>
<para>The OVF standard is complex, and support in VirtualBox is an
ongoing process. In particular, no guarantee is made that VirtualBox
supports all appliances created by other virtualization software. For
a list of know limitations, please see <xref
linkend="KnownIssues" />.</para>
</note></para>
<para>An appliance in OVF format will typically consist of several
files:<orderedlist>
<listitem>
<para>one or several disk images, typically in the widely-used VMDK
format (see <xref linkend="vdidetails" />) and</para>
</listitem>
<listitem>
<para>a textual description file in an XML dialect with an
<computeroutput>.ovf</computeroutput> extension.</para>
</listitem>
</orderedlist></para>
<para>These files must reside in the same directory for VirtualBox to be
able to import them.</para>
<para>A future version of VirtualBox will also support packages that
include the OVF XML file and the disk images packed together in a single
archive.</para>
<para>To <emphasis role="bold">import</emphasis> an appliance in OVF
format, select "File" -> "Import appliance" from the main window of the
VirtualBox graphical user interface. Then open the file dialog and
navigate to the OVF text file with the
<computeroutput>.ovf</computeroutput> file extension.</para>
<para>If VirtualBox can handle the file, a dialog similar to the following
will appear:</para>
<para><mediaobject>
<imageobject>
width="10cm" />
</imageobject>
</mediaobject>This presents the virtual machines described in the OVF
file and allows you to change the virtual machine settings by
double-clicking on the description items. Once you click on <emphasis
role="bold">"Import"</emphasis>, VirtualBox will copy the disk images and
create local virtual machines with the settings described in the dialog.
These will then show up in the list of virtual machines.</para>
<para>Note that since disk images tend to be big, and VMDK images that
come with virtual appliances are typically shipped in a special compressed
format that is unsuitable for being used by virtual machines directly, the
images will need to be unpacked and copied first, which can take a few
minutes.</para>
<para>For how to import an image at the command line, please see <xref
linkend="vboxmanage-import" />.</para>
<para>Conversely, to <emphasis role="bold">export</emphasis> virtual
machines that you already have in VirtualBox, select the machines and
"File" -> "Export appliance". A different dialog window shows up that
allows you to combine several virtual machines into an OVF appliance.
Then, you select the target location where the OVF and VMDK files should
be stored, and the conversion process begins. This can again take a
while.</para>
<para>For how to export an image at the command line, please see <xref
linkend="vboxmanage-export" />.<note>
<para>OVF cannot describe snapshots that were taken for a virtual
machine. As a result, when you export a virtual machine that has
snapshots, only the current state of the machine will be exported, and
the disk images in the export will have a "flattened" state identical
to the current state of the virtual machine.</para>
</note></para>
</sect1>
<sect1 id="frontends">
<title>Alternative front-ends</title>
<para>As briefly mentioned in <xref linkend="features-overview" />,
VirtualBox has a very flexible internal design that allows you to use
different front-ends to control the same virtual machines. To illustrate,
you can, for example, start a virtual machine with VirtualBox's
easy-to-use graphical user interface and then stop it from the command
line. With VirtualBox's support for the Remote Desktop Protocol (VRDP),
you can even run virtual machines remotely on a headless server and have
all the graphical output redirected over the network.</para>
<para>In detail, the following front-ends are shipped in the standard
VirtualBox package:</para>
<para><orderedlist>
<listitem>
<para><computeroutput>VirtualBox</computeroutput> is our graphical
user interface (GUI), which most of this User Manual is dedicated to
describing, especially in <xref linkend="BasicConcepts" />. While
this is the easiest-to-use of our interfaces, it does not (yet)
cover all the features that VirtualBox provides. Still, this is the
best way to get to know VirtualBox initially.</para>
</listitem>
<listitem>
<para><computeroutput>VBoxManage</computeroutput> is our
command-line interface for automated and very detailed control of
every aspect of VirtualBox. It is described in <xref
linkend="vboxmanage" />.</para>
</listitem>
<listitem>
<para><computeroutput>VBoxSDL</computeroutput> is an alternative,
simple graphical front-end with an intentionally limited feature
set, designed to only display virtual machines that are controlled
in detail with <computeroutput>VBoxManage</computeroutput>. This is
interesting for business environments where displaying all the bells
and whistles of the full GUI is not feasible.
<computeroutput>VBoxSDL</computeroutput> is described in <xref
linkend="vboxsdl" />.</para>
</listitem>
<listitem>
<para>Finally, <computeroutput>VBoxHeadless</computeroutput> is yet
another front-end that produces no visible output on the host at
all, but merely acts as a VRDP server. Now, even though the other
graphical front-ends (VirtualBox and VBoxSDL) also have VRDP support
built-in and can act as a VRDP server, this particular front-end
requires no graphics support. This is useful, for example, if you
want to host your virtual machines on a headless Linux server that
has no X Window system installed. For details, see <xref
linkend="vboxheadless" />.</para>
</listitem>
</orderedlist>If the above front-ends still do not satisfy your
particular needs, it is relatively painless to create yet another
front-end to the complex virtualization engine that is the core of
VirtualBox, as the VirtualBox core neatly exposes all of its features in a
clean API; please refer to <xref linkend="VirtualBoxAPI" />.</para>
</sect1>
</chapter>