Index: /trunk/doc/manual/en_US/user_GuestAdditions.xml =================================================================== --- /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 43695) +++ /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 43696) @@ -221,5 +221,5 @@ Microsoft Windows 8 (all editions) - + Microsoft Windows Server 2012 @@ -355,4 +355,116 @@ Unattended Installation + 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. + + 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. + + Since VirtualBox 4.2 installing those CA certificates on a Windows + guest can be done in an automated fashion using the + VBoxCertUtil.exe utility found on the Guest + Additions installation CD in the cert + folder: + + + + Log in as Administrator on the guest. + + + + Mount the VirtualBox Guest Additions .ISO. + + + + Open a command line window on the guest and change to + the cert folder on the VirtualBox + Guest Additions CD. + + + + Do a VBoxCertUtil add-trusted-publisher oracle-vbox.cer --root oracle-vbox.cer. + This will install the certificates to the certificate store. When installing the same certificate + more than once, an appropriate error will be displayed. + + + + Prior to VirtualBox 4.2 the Oracle CA certificates need to be imported in more manual style + using the certutil.exe utility, which is shipped since Windows + Vista. For Windows versions before Vista you need to download and install certutil.exe + 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. + + In the following example the needed certificates will be extracted from the VirtualBox + Windows Guest Additions installer on the CD-ROM: + + + VeriSign Code Signing CA + + + In the Windows Explorer, right click on VBoxWindowsAdditions-<Architecture>.exe, + click on "Properties" + + + Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details" + + + In tab "General" click on "View Certificate" + + + In tab "Certification Path" select "VeriSign Class 3 Public Primary CA" + + + Click on "View Certificate" + + + In tab "Details" click on "Copy to File ..." + + + In the upcoming wizard choose "DER encoded binary X.509 (.CER)" + and save the certificate file to a local path, finish the wizard + + + Close certificate dialog for "Verisign Class 3 Code Signing + 2010 CA" + + + + + + Oracle Corporation + + + In the Windows Explorer, right click on VBoxWindowsAdditions-<Architecture>.exe, + click on "Properties" + + + Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details" + + + In tab "General" click on "View Certificate" + + + In tab "Details" click on "Copy to File ..." + + + In the upcoming wizard choose "DER encoded binary X.509 (.CER)" + and save the certificate file to a local path, finish the wizard + + + Close certificate dialog for "Oracle Corporation" + + + + + After exporting the two certificates above they can be imported into the + certificate store using the certutil.exe + utility: + + certutil -addstore -f Root "<Path to exported + certificate file>" + In order to allow for completely unattended guest installations, you can specify a command line parameter to the install @@ -363,10 +475,4 @@ This automatically installs the right files and drivers for the corresponding platform (32- or 64-bit). - - - Because of the drivers are not yet WHQL certified, you still - might get some driver installation popups, depending on the Windows - guest version. - For more options regarding unattended guest installations, @@ -736,5 +842,5 @@ be adjusted as needed using the tools which come with the guest operating system. - + 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 @@ -1127,5 +1233,5 @@ 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) @@ -1202,11 +1308,11 @@ 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 manually selected 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. Unlike the current basic Direct3D support, the WDDM video @@ -1215,10 +1321,10 @@ The Aero theme is not enabled by default. To enable it - In Windows Vista guest: right-click on the desktop, in the + 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 + in the "Personalization" window, in the "Appearance Settings" dialog select "Windows Aero" and press "OK" - In Windows 7 guest: right-click on the desktop, in the + In Windows 7 guest: right-click on the desktop, in the contect menu select "Personalize" and select any Aero theme in the "Personalization" window