VirtualBox

Changeset 43696 in vbox for trunk/doc


Ignore:
Timestamp:
Oct 22, 2012 1:23:20 PM (12 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
81552
Message:

doc/manual: Added certificate installation for Windows Guest Additions.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/user_GuestAdditions.xml

    r43261 r43696  
    221221          <para>Microsoft Windows 8 (all editions)</para>
    222222        </listitem>
    223        
     223
    224224        <listitem>
    225225          <para>Microsoft Windows Server 2012</para>
     
    355355        <title>Unattended Installation</title>
    356356
     357        <para>As a prerequiste for performing an unattended installation of the
     358        VirtualBox Guest Additions on a Windows guest, there need to be
     359        Oracle CA (Certificate Authority)
     360        certificates installed in order to prevent user intervention popus which
     361        will undermine a silent installation.</para>
     362
     363        <note>On some Windows versions like Windows 2000 and Windows XP the user intervention
     364        popups mentioned above always will be displayed, even after importing the Oracle certificates.</note>
     365
     366        <para>Since VirtualBox 4.2 installing those CA certificates on a Windows
     367        guest can be done in an automated fashion using the
     368        <computeroutput>VBoxCertUtil.exe</computeroutput> utility found on the Guest
     369        Additions installation CD in the <computeroutput>cert</computeroutput>
     370        folder:</para>
     371
     372        <itemizedlist>
     373          <listitem>
     374            <para>Log in as Administrator on the guest.</para>
     375          </listitem>
     376
     377          <listitem>
     378            <para>Mount the VirtualBox Guest Additions .ISO.</para>
     379          </listitem>
     380
     381          <listitem>
     382            <para>Open a command line window on the guest and change to
     383            the <computeroutput>cert</computeroutput> folder on the VirtualBox
     384            Guest Additions CD.</para>
     385          </listitem>
     386
     387          <listitem>
     388            <para>Do a <computeroutput>VBoxCertUtil add-trusted-publisher oracle-vbox.cer --root oracle-vbox.cer</computeroutput>.</para>
     389            <para>This will install the certificates to the certificate store. When installing the same certificate
     390            more than once, an appropriate error will be displayed.</para>
     391          </listitem>
     392        </itemizedlist>
     393
     394        <para>Prior to VirtualBox 4.2 the Oracle CA certificates need to be imported in more manual style
     395        using the <computeroutput>certutil.exe</computeroutput> utility, which is shipped since Windows
     396        Vista. For Windows versions before Vista you need to download and install <computeroutput>certutil.exe</computeroutput>
     397        manually. Since the certificates are not accompanied on the VirtualBox Guest Additions CD-ROM
     398        prior to 4.2, these need to get extracted from a signed VirtualBox executable first.</para>
     399
     400        <para>In the following example the needed certificates will be extracted from the VirtualBox
     401        Windows Guest Additions installer on the CD-ROM:</para>
     402
     403        <sect4>
     404          <title>VeriSign Code Signing CA</title>
     405          <itemizedlist>
     406            <listitem>
     407              <para>In the Windows Explorer, right click on VBoxWindowsAdditions-&lt;Architecture&gt;.exe,
     408              click on "Properties"</para>
     409            </listitem>
     410            <listitem>
     411              <para>Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details"</para>
     412            </listitem>
     413            <listitem>
     414              <para>In tab "General" click on "View Certificate"</para>
     415            </listitem>
     416            <listitem>
     417              <para>In tab "Certification Path" select "VeriSign Class 3 Public Primary CA"</para>
     418            </listitem>
     419            <listitem>
     420              <para>Click on "View Certificate"</para>
     421            </listitem>
     422            <listitem>
     423              <para>In tab "Details" click on "Copy to File ..."</para>
     424            </listitem>
     425            <listitem>
     426              <para>In the upcoming wizard choose "DER encoded binary X.509 (.CER)"
     427              and save the certificate file to a local path, finish the wizard</para>
     428            </listitem>
     429            <listitem>
     430              <para>Close certificate dialog for "Verisign Class 3 Code Signing
     431              2010 CA"</para>
     432            </listitem>
     433          </itemizedlist>
     434        </sect4>
     435
     436        <sect4>
     437          <title>Oracle Corporation</title>
     438          <itemizedlist>
     439            <listitem>
     440              <para>In the Windows Explorer, right click on VBoxWindowsAdditions-&lt;Architecture&gt;.exe,
     441              click on "Properties"</para>
     442            </listitem>
     443            <listitem>
     444              <para>Go to tab "Digital Signatures", choose "Oracle Corporation" and click on "Details"</para>
     445            </listitem>
     446            <listitem>
     447              <para>In tab "General" click on "View Certificate"</para>
     448            </listitem>
     449            <listitem>
     450              <para>In tab "Details" click on "Copy to File ..."</para>
     451            </listitem>
     452            <listitem>
     453              <para>In the upcoming wizard choose "DER encoded binary X.509 (.CER)"
     454              and save the certificate file to a local path, finish the wizard</para>
     455            </listitem>
     456            <listitem>
     457              <para>Close certificate dialog for "Oracle Corporation"</para>
     458            </listitem>
     459          </itemizedlist>
     460        </sect4>
     461
     462        <para>After exporting the two certificates above they can be imported into the
     463        certificate store using the <computeroutput>certutil.exe</computeroutput>
     464        utility:</para>
     465
     466        <para><computeroutput>certutil -addstore -f Root "&lt;Path to exported
     467        certificate file&gt;"</computeroutput></para>
     468
    357469        <para>In order to allow for completely unattended guest installations,
    358470        you can specify a command line parameter to the install
     
    363475        <para>This automatically installs the right files and drivers for the
    364476        corresponding platform (32- or 64-bit).</para>
    365 
    366         <note>
    367           <para>Because of the drivers are not yet WHQL certified, you still
    368           might get some driver installation popups, depending on the Windows
    369           guest version.</para>
    370         </note>
    371477
    372478        <para>For more options regarding unattended guest installations,
     
    736842        be adjusted as needed using the tools which come with the guest
    737843        operating system.</para>
    738        
     844
    739845        <para>If you want to understand more about the details of how the
    740846        X.Org drivers are set up (in particular if you wish to use them in a
     
    11271233          With VirtualBox 3.0, Direct3D 8/9 support was added for Windows
    11281234          guests. OpenGL 2.0 is now supported as well.
    1129           With VirtualBox 4.1 Windows Aero theme support is added for 
     1235          With VirtualBox 4.1 Windows Aero theme support is added for
    11301236          Windows Vista and Windows 7 guests (experimental)</para>
    11311237        </footnote></para>
     
    12021308
    12031309      <para>With VirtualBox 4.1, Windows Aero theme support is added for
    1204       Windows Vista and Windows 7 guests. To enable Aero theme support, 
    1205       the experimental VirtualBox WDDM video driver must be installed, 
     1310      Windows Vista and Windows 7 guests. To enable Aero theme support,
     1311      the experimental VirtualBox WDDM video driver must be installed,
    12061312      which is available with the Guest Additions installation.
    12071313      Since the WDDM video driver is still experimental at this time, it is
    12081314      not installed by default and must be <emphasis role="bold">manually
    12091315      selected</emphasis> in the Guest Additions installer by answering "No"
    1210       int the "Would you like to install basic Direct3D support" dialog 
     1316      int the "Would you like to install basic Direct3D support" dialog
    12111317      displayed when the Direct3D feature is selected.
    12121318      <note><para>Unlike the current basic Direct3D support, the WDDM video
     
    12151321      <para>The Aero theme is not enabled by default. To enable it<itemizedlist>
    12161322          <listitem>
    1217             <para>In Windows Vista guest: right-click on the desktop, in the 
     1323            <para>In Windows Vista guest: right-click on the desktop, in the
    12181324            contect menu select "Personalize", then select "Windows Color and Appearance"
    1219             in the "Personalization" window, in the "Appearance Settings" dialog select 
     1325            in the "Personalization" window, in the "Appearance Settings" dialog select
    12201326            "Windows Aero" and press "OK"</para></listitem>
    12211327          <listitem>
    1222             <para>In Windows 7 guest: right-click on the desktop, in the 
     1328            <para>In Windows 7 guest: right-click on the desktop, in the
    12231329            contect menu select "Personalize" and select any Aero theme
    12241330            in the "Personalization" window</para></listitem>
Note: See TracChangeset for help on using the changeset viewer.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette