diff options
Diffstat (limited to 'doc/manual/en_US/user_GuestAdditions.xml')
| -rw-r--r-- | doc/manual/en_US/user_GuestAdditions.xml | 184 |
1 files changed, 154 insertions, 30 deletions
diff --git a/doc/manual/en_US/user_GuestAdditions.xml b/doc/manual/en_US/user_GuestAdditions.xml index cfd25c54..740ee74a 100644 --- a/doc/manual/en_US/user_GuestAdditions.xml +++ b/doc/manual/en_US/user_GuestAdditions.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="guestadditions">Guest Additions</title> +<chapter id="guestadditions"> + <title>Guest Additions</title> <para>The previous chapter covered getting started with VirtualBox and installing operating systems in a virtual machine. For any serious and @@ -220,7 +220,7 @@ <listitem> <para>Microsoft Windows 8 (all editions)</para> </listitem> - + <listitem> <para>Microsoft Windows Server 2012</para> </listitem> @@ -231,11 +231,12 @@ <title>Installation</title> <para>In the "Devices" menu in the virtual machine's menu bar, - VirtualBox has a handy menu item named "Install guest additions", + VirtualBox has a handy menu item named "Insert Guest Additions CD image", which mounts the Guest Additions ISO file inside your virtual machine. A Windows guest should then automatically start the Guest Additions installer, which installs the Guest Additions into your Windows - guest.</para> + guest. Other guest operating systems (or if automatic start of + software on CD is disabled) need manual start of the installer.</para> <note> <para>For the basic Direct3D acceleration to work in a Windows Guest, you @@ -354,6 +355,118 @@ <sect3> <title>Unattended Installation</title> + <para>As a prerequiste for performing an unattended installation of the + VirtualBox Guest Additions on a Windows guest, there need to be + Oracle CA (Certificate Authority) + certificates installed in order to prevent user intervention popus which + will undermine a silent installation.</para> + + <note>On some Windows versions like Windows 2000 and Windows XP the user intervention + popups mentioned above always will be displayed, even after importing the Oracle certificates.</note> + + <para>Since VirtualBox 4.2 installing those CA certificates on a Windows + guest can be done in an automated fashion using the + <computeroutput>VBoxCertUtil.exe</computeroutput> utility found on the Guest + Additions installation CD in the <computeroutput>cert</computeroutput> + folder:</para> + + <itemizedlist> + <listitem> + <para>Log in as Administrator on the guest.</para> + </listitem> + + <listitem> + <para>Mount the VirtualBox Guest Additions .ISO.</para> + </listitem> + + <listitem> + <para>Open a command line window on the guest and change to + the <computeroutput>cert</computeroutput> folder on the VirtualBox + Guest Additions CD.</para> + </listitem> + + <listitem> + <para>Do<screen>VBoxCertUtil add-trusted-publisher oracle-vbox.cer --root oracle-vbox.cer</screen></para> + <para>This will install the certificates to the certificate store. When installing the same certificate + more than once, an appropriate error will be displayed.</para> + </listitem> + </itemizedlist> + + <para>Prior to VirtualBox 4.2 the Oracle CA certificates need to be imported in more manual style + using the <computeroutput>certutil.exe</computeroutput> utility, which is shipped since Windows + Vista. For Windows versions before Vista you need to download and install <computeroutput>certutil.exe</computeroutput> + manually. Since the certificates are not accompanied on the VirtualBox Guest Additions CD-ROM + prior to 4.2, these need to get extracted from a signed VirtualBox executable first.</para> + + <para>In the following example the needed certificates will be extracted from the VirtualBox + Windows Guest Additions installer on the CD-ROM:</para> + + <sect4> + <title>VeriSign Code Signing CA</title> + <itemizedlist> + <listitem> + <para>In the Windows Explorer, right click on VBoxWindowsAdditions-<Architecture>.exe, + click on "Properties"</para> + </listitem> + <listitem> + <para>Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details"</para> + </listitem> + <listitem> + <para>In tab "General" click on "View Certificate"</para> + </listitem> + <listitem> + <para>In tab "Certification Path" select "VeriSign Class 3 Public Primary CA"</para> + </listitem> + <listitem> + <para>Click on "View Certificate"</para> + </listitem> + <listitem> + <para>In tab "Details" click on "Copy to File ..."</para> + </listitem> + <listitem> + <para>In the upcoming wizard choose "DER encoded binary X.509 (.CER)" + and save the certificate file to a local path, finish the wizard</para> + </listitem> + <listitem> + <para>Close certificate dialog for "Verisign Class 3 Code Signing + 2010 CA"</para> + </listitem> + </itemizedlist> + </sect4> + + <sect4> + <title>Oracle Corporation</title> + <itemizedlist> + <listitem> + <para>In the Windows Explorer, right click on VBoxWindowsAdditions-<Architecture>.exe, + click on "Properties"</para> + </listitem> + <listitem> + <para>Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details"</para> + </listitem> + <listitem> + <para>In tab "General" click on "View Certificate"</para> + </listitem> + <listitem> + <para>In tab "Details" click on "Copy to File ..."</para> + </listitem> + <listitem> + <para>In the upcoming wizard choose "DER encoded binary X.509 (.CER)" + and save the certificate file to a local path, finish the wizard</para> + </listitem> + <listitem> + <para>Close certificate dialog for "Oracle Corporation"</para> + </listitem> + </itemizedlist> + </sect4> + + <para>After exporting the two certificates above they can be imported into the + certificate store using the <computeroutput>certutil.exe</computeroutput> + utility:</para> + + <para><computeroutput>certutil -addstore -f Root "<Path to exported + certificate file>"</computeroutput></para> + <para>In order to allow for completely unattended guest installations, you can specify a command line parameter to the install launcher:</para> @@ -363,11 +476,15 @@ <para>This automatically installs the right files and drivers for the corresponding platform (32- or 64-bit).</para> - <note> - <para>Because of the drivers are not yet WHQL certified, you still - might get some driver installation popups, depending on the Windows - guest version.</para> - </note> + <note><para>By default on an unattended installation on a Windows 7 or 8 + guest, there will be the XPDM graphics driver installed. This graphics + driver does not support Windows Aero / Direct3D on the guest - instead the + experimental WDDM graphics driver needs to be installed. To select this + driver by default, add the command line parameter + <computeroutput>/with_wddm</computeroutput> when invoking the Windows + Guest Additions installer.</para></note> + <note><para>For Windows Aero to run correctly on a guest, the guest's + VRAM size needs to be configured to at least 128 MB.</para></note> <para>For more options regarding unattended guest installations, consult the command line help by using the command:</para> @@ -405,6 +522,10 @@ <itemizedlist> <listitem> + <para>Oracle Linux as of version 5 including UEK kernels;</para> + </listitem> + + <listitem> <para>Fedora as of Fedora Core 4;</para> </listitem> @@ -645,8 +766,7 @@ </sect4> <sect4> - <title>CentOS, Red Hat Enterprise Linux and Oracle - Enterprise Linux</title> + <title>Oracle Linux, Red Hat Enterprise Linux and CentOS</title> <para><orderedlist> <listitem> @@ -664,7 +784,9 @@ <listitem> <para>Install the GNU C compiler and the kernel development packages using <screen>yum install gcc</screen> followed by - <screen>yum install kernel-devel</screen></para> + <screen>yum install kernel-devel</screen> For Oracle UEK + kernels, use <screen>yum install kernel-uek-devel</screen> + to install the UEK kernel headers.</para> </listitem> <listitem> @@ -673,7 +795,7 @@ </listitem> <listitem> - <para>In case Oracle Enterprise Linux does not find the + <para>In case Oracle Linux does not find the required packages, you either have to install them from a different source (e.g. DVD) or use Oracle's public Yum server located at <ulink @@ -735,7 +857,7 @@ version 11) or a later version. The layout of the guest screens can be adjusted as needed using the tools which come with the guest operating system.</para> - + <para>If you want to understand more about the details of how the X.Org drivers are set up (in particular if you wish to use them in a setting which our installer doesn't handle correctly), you should read @@ -1031,13 +1153,16 @@ $</screen> <screen>iocharset CHARSET</screen> - <para>to set the character set used for I/O operations (utf8 by - default) and</para> + <para>to set the character set used for I/O operations. Note that + on Linux guests, if the "iocharset" option is not specified then + the Guest Additions driver will attempt to use the character set + specified by the CONFIG_NLS_DEFAULT kernel option. If this option + is not set either then UTF-8 will be used. Also,</para> <screen>convertcp CHARSET</screen> - <para>to specify the character set used for the shared folder name - (utf8 by default).</para> + <para>is available in order to specify the character set used for + the shared folder name (utf8 by default).</para> <para>The generic mount options (documented in the mount manual page) apply also. Especially useful are the options @@ -1126,7 +1251,7 @@ $</screen> 2.1; support for Linux and Solaris followed with VirtualBox 2.2. With VirtualBox 3.0, Direct3D 8/9 support was added for Windows guests. OpenGL 2.0 is now supported as well. - With VirtualBox 4.1 Windows Aero theme support is added for + With VirtualBox 4.1 Windows Aero theme support is added for Windows Vista and Windows 7 guests (experimental)</para> </footnote></para> @@ -1201,26 +1326,26 @@ $</screen> </orderedlist></para> <para>With VirtualBox 4.1, Windows Aero theme support is added for - Windows Vista and Windows 7 guests. To enable Aero theme support, - the experimental VirtualBox WDDM video driver must be installed, + Windows Vista and Windows 7 guests. To enable Aero theme support, + the experimental VirtualBox WDDM video driver must be installed, which is available with the Guest Additions installation. Since the WDDM video driver is still experimental at this time, it is not installed by default and must be <emphasis role="bold">manually selected</emphasis> in the Guest Additions installer by answering "No" - int the "Would you like to install basic Direct3D support" dialog + int the "Would you like to install basic Direct3D support" dialog displayed when the Direct3D feature is selected. <note><para>Unlike the current basic Direct3D support, the WDDM video driver installation does <emphasis role="bold">not</emphasis> require the "Safe Mode".</para></note> <para>The Aero theme is not enabled by default. To enable it<itemizedlist> <listitem> - <para>In Windows Vista guest: right-click on the desktop, in the - contect menu select "Personalize", then select "Windows Color and Appearance" - in the "Personalization" window, in the "Appearance Settings" dialog select + <para>In Windows Vista guest: right-click on the desktop, in the + context menu select "Personalize", then select "Windows Color and Appearance" + in the "Personalization" window, in the "Appearance Settings" dialog select "Windows Aero" and press "OK"</para></listitem> <listitem> - <para>In Windows 7 guest: right-click on the desktop, in the - contect menu select "Personalize" and select any Aero theme + <para>In Windows 7 guest: right-click on the desktop, in the + context menu select "Personalize" and select any Aero theme in the "Personalization" window</para></listitem> </itemizedlist> </para> @@ -1422,8 +1547,7 @@ VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_V (C) 2005-$VBOX_C_YEAR $VBOX_VENDOR All rights reserved. -Value: Windows Vista Business Edition -</screen></para> +Value: Windows Vista Business Edition</screen></para> <para>To add or change guest properties from the guest, use the tool <computeroutput>VBoxControl</computeroutput>. This tool is included in the |