diff options
Diffstat (limited to 'doc/manual/en_US/user_Introduction.xml')
| -rw-r--r-- | doc/manual/en_US/user_Introduction.xml | 200 |
1 files changed, 168 insertions, 32 deletions
diff --git a/doc/manual/en_US/user_Introduction.xml b/doc/manual/en_US/user_Introduction.xml index e4f4b03d..a91e4f71 100644 --- a/doc/manual/en_US/user_Introduction.xml +++ b/doc/manual/en_US/user_Introduction.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"> -<chapter> - <title id="Introduction">First steps</title> +<chapter id="Introduction"> + <title>First steps</title> <para>Welcome to $VBOX_PRODUCT!</para> @@ -104,8 +104,8 @@ </itemizedlist> </sect1> - <sect1> - <title id="virtintro">Some terminology</title> + <sect1 id="virtintro"> + <title>Some terminology</title> <para>When dealing with virtualization (and also for understanding the following chapters of this documentation), it helps to acquaint oneself @@ -323,6 +323,18 @@ </listitem> <listitem> + <para><emphasis role="bold">VM groups.</emphasis> VirtualBox provides a + groups feature that enables the user to organize virtual machines + collectively, as well as individually. In addition to basic groups, it + is also possible for any VM to be in more than one group, and for + groups to be nested in a hierarchy -- i.e. groups of groups. In + general, the operations that can be performed on groups are the same as + those that can be applied to individual VMs i.e. Start, Pause, Reset, + Close (Save state, Send Shutdown, Poweroff), Discard Saved State, Show + in fileSystem, Sort.</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 @@ -377,8 +389,8 @@ </itemizedlist> </sect1> - <sect1> - <title id="hostossupport">Supported host operating systems</title> + <sect1 id="hostossupport"> + <title>Supported host operating systems</title> <para>Currently, VirtualBox runs on the following host operating systems:</para> @@ -440,6 +452,10 @@ <para>10.8 (Mountain Lion, 64-bit)</para> </listitem> + <listitem> + <para>10.9 (Mavericks, 64-bit)</para> + </listitem> + </itemizedlist> <para>Intel hardware is required; please see <xref @@ -453,27 +469,26 @@ 1.4.</para> </footnote>). Among others, this includes:<itemizedlist> <listitem> - <para>8.04 ("Hardy Heron"), - 8.10 ("Intrepid Ibex"), 9.04 ("Jaunty Jackalope"), 9.10 ("Karmic - Koala"), 10.04 ("Lucid Lynx"), 10.10 ("Maverick Meerkat), + <para>10.04 ("Lucid Lynx"), 10.10 ("Maverick Meerkat), 11.04 ("Natty Narwhal"), 11.10 ("Oneiric Oncelot"), - 12.04 ("Precise Pangolin")</para> + 12.04 ("Precise Pangolin"), 12.10 ("Quantal Quetzal"), + 13.04 ("Raring Ringtail"), 13.10 ("Saucy Salamander")</para> </listitem> <listitem> - <para>Debian GNU/Linux 5.0 ("lenny") and 6.0 ("squeeze")</para> + <para>Debian GNU/Linux 6.0 ("squeeze") and 7.0 ("wheezy")</para> </listitem> <listitem> - <para>Oracle Enterprise Linux 4 and 5, Oracle Linux 6</para> + <para>Oracle Enterprise Linux 5, Oracle Linux 6</para> </listitem> <listitem> - <para>Redhat Enterprise Linux 4, 5 and 6</para> + <para>Redhat Enterprise Linux 5 and 6</para> </listitem> <listitem> - <para>Fedora Core 4 to 17</para> + <para>Fedora Core 6 to 19</para> </listitem> <listitem> @@ -490,7 +505,7 @@ </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 + Linux kernel 2.6 or 3.x using either the VirtualBox installer or by doing a manual installation; see <xref linkend="install-linux-host" />. However, the formally tested and supported Linux distributions are those for which we offer a dedicated package.</para> @@ -500,8 +515,8 @@ </listitem> <listitem> - <para><emphasis role="bold">Solaris</emphasis> hosts (32-bit and - 64-bit) are supported with the restrictions listed in <xref + <para><emphasis role="bold">Solaris</emphasis> hosts (64-bit only) are + supported with the restrictions listed in <xref linkend="KnownIssues" />:<itemizedlist> <listitem> <para>Solaris 11 including Solaris 11 Express</para> @@ -555,8 +570,12 @@ </listitem> <listitem> - <para>Intel PXE boot ROM with support for the E1000 network - card.</para> + <para>Host webcam passthrough; see chapter <xref + linkend="webcam-passthrough" />.</para> + </listitem> + + <listitem> + <para>Intel PXE boot ROM.</para> </listitem> <listitem> @@ -567,9 +586,9 @@ <para>VirtualBox extension packages have a <computeroutput>.vbox-extpack</computeroutput> file name extension. - To install an extension, simply double-click on the package file, - and the VirtualBox Manager will guide you through the required - steps.</para> + To install an extension, simply double-click on the package file + and a Network Operations Manager window will appear, guiding you + through the required steps.</para> <para>To view the extension packs that are currently installed, please start the VirtualBox Manager (see the next section). From the @@ -815,6 +834,11 @@ entered initially.</para> </listitem> </orderedlist></para> + + <note><para>After becoming familiar with the use of wizards, consider using + the Expert Mode available in some wizards. Where available, this is + selectable using a button, and speeds up user processes using + wizards.</para></note> </sect1> <sect1> @@ -900,9 +924,8 @@ able to install your operating system.</para> </sect2> - <sect2> - <title id="keyb_mouse_normal">Capturing and releasing keyboard and - mouse</title> + <sect2 id="keyb_mouse_normal"> + <title>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 @@ -933,7 +956,8 @@ 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 + default in the VirtualBox Global Settings, see <xref + linkend="globalsettings" />. 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> @@ -963,7 +987,12 @@ 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> + the guest. For technical reasons it may not be possible for the + VM to get all keyboard input even when it does own the keyboard. + Examples of this are the Ctrl-Alt-Del sequence on Windows hosts + or single keys grabbed by other applications on X11 hosts like + the GNOME desktop's "Control key highlights mouse pointer" + functionality.</para> </listitem> <listitem> @@ -993,7 +1022,7 @@ linkend="guestadditions" />.</para> </sect2> - <sect2> + <sect2 id="specialcharacters"> <title>Typing special characters</title> <para>Operating systems expect certain key combinations to initiate @@ -1216,6 +1245,64 @@ </sect2> </sect1> + <sect1 id="gui-vmgroups"> + <title>Using VM groups</title> + + <para>VM groups enable the user to create ad hoc groups of VMs, and to + manage and perform functions on them collectively, as well as individually. + There are a number of features relating to groups:</para> + + <orderedlist> + <listitem> + <para> + Create a group using GUI option 1) Drag one VM on top of another + VM. + </para> + <para> + Create a group using GUI option 2) Select multiple VMs and select + "Group" on the right click menu, as follows: + </para> + + <para><mediaobject> + <imageobject> + <imagedata align="center" fileref="images/vm-groups.png" + width="10cm" /> + </imageobject> + </mediaobject></para> + + </listitem> + <listitem> + <para> + Command line option 1) Create group and assign VM: + <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup"</screen> + </para> + <para> + Command line option 2) Detach VM from group, and delete group if + empty: <screen>VBoxManage modifyvm "Fred" --groups ""</screen> + </para> + </listitem> + <listitem> + <para> + Multiple groups e.g.: + <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup,/TestGroup2"</screen> + </para> + </listitem> + <listitem> + <para> + Nested groups -- hierarchy of groups e.g.: + <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup/TestGroup2"</screen> + </para> + </listitem> + <listitem> + <para> + Summary of group commands: Start, Pause, Reset, Close (save state, + send shutdown signal, poweroff), Discard Saved State, Show in File + System, Sort. + </para> + </listitem> + </orderedlist> + </sect1> + <sect1 id="snapshots"> <title>Snapshots</title> @@ -1418,8 +1505,8 @@ </sect2> </sect1> - <sect1> - <title id="configbasics">Virtual machine configuration</title> + <sect1 id="configbasics"> + <title>Virtual machine configuration</title> <para>When you select a virtual machine from the list in the Manager window, you will see a summary of that machine's settings on the @@ -1523,8 +1610,8 @@ <para>The clone operation itself can be a lengthy operation depending on the size and count of the attached disk images. Also keep in mind that - every snapshot has differencing disk images attached, which need to be cloned - as well.</para> + every snapshot has differencing disk images attached, which need to be + cloned as well.</para> <para>The "Clone" menu item is disabled while a machine is running.</para> @@ -1629,6 +1716,55 @@ </note></para> </sect1> + <sect1 id="globalsettings"> + <title>Global Settings</title> + <para>The global settings dialog can be reached through the + <emphasis role="bold">File</emphasis> menu, selecting the + <emphasis role="bold">Preferences...</emphasis> item. It offers a selection + of settings which apply to all virtual machines of the current user or in + the case of <emphasis role="bold">Extensions</emphasis> to the entire + system: + <orderedlist> + <listitem> + <para><emphasis role="bold">General</emphasis> Enables the user to + specify the default folder/directory for VM files, and the VRDP + Authentication Library.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Input</emphasis> Enables the user to + specify the Host Key. It identifies the key that toggles whether the + cursor is in the focus of the VM or the Host operating system + windows (see <xref linkend="keyb_mouse_normal"/>) and which is also + used to trigger certain VM actions (see <xref + linkend="specialcharacters"/>)</para> + </listitem> + <listitem> + <para><emphasis role="bold">Update</emphasis> Enables the user + to specify various settings for Automatic Updates.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Language</emphasis> Enables the user to + specify the GUI language.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Display</emphasis> Enables the user to + specify the screen resolution, and its width and height.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Network</emphasis> Enables the user to + configure the details of Host Only Networks.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Extensions</emphasis> Enables the user + to list and manage the installed extension packages.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Proxy</emphasis> Enables the user to + configure a HTTP Proxy Server.</para> + </listitem> + </orderedlist></para> + </sect1> + <sect1 id="frontends"> <title>Alternative front-ends</title> |