File: install-win-performing.dita

package info (click to toggle)
virtualbox 7.1.12-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 565,672 kB
  • sloc: ansic: 2,330,854; cpp: 2,193,228; asm: 230,777; python: 223,895; xml: 86,771; sh: 25,541; makefile: 8,158; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,782; javascript: 1,692; objc: 1,131; lex: 931; php: 906; sed: 899; yacc: 707
file content (132 lines) | stat: -rw-r--r-- 6,551 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="install-win-performing">
  <title>Performing the Installation</title>
  
  <body>
    <p>The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> installation can be started in either of the following
      ways: </p>
    <ul>
      <li>
        <p>By double-clicking on the executable file. </p>
      </li>
      <li>
        <p>By entering the following command: </p>
        <pre xml:space="preserve">VirtualBox-&lt;version&gt;-&lt;revision&gt;-Win.exe -extract</pre>
        <p>This will extract the installer into a temporary directory, along with the .MSI file. Run the following
          command to perform the installation: </p>
        <pre xml:space="preserve">msiexec /i VirtualBox-&lt;version&gt;-&lt;revision&gt;-Win.msi</pre>
      </li>
    </ul>
    <p>Using either way displays the installation <b outputclass="bold">Welcome</b> dialog and enables you to choose
      where to install <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, and which components to install. In
      addition to the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> application, the following components are
      available: </p>
    <ul>
      <li>
        <p><b outputclass="bold">USB support.</b> This package
            contains special drivers for your Windows host that
            <ph conkeyref="vbox-conkeyref-phrases/product-name"/> requires to fully support USB devices inside
            your virtual machines.
          </p>
      </li>
      <li>
        <p><b outputclass="bold">Networking.</b> This package
            contains extra networking drivers for your Windows host that
            <ph conkeyref="vbox-conkeyref-phrases/product-name"/> needs to support Bridged Networking. This
            enables your VM's virtual network cards to be accessed from
            other machines on your physical network.
          </p>
      </li>
      <li>
        <p><b outputclass="bold">Python support.</b> This
            package contains Python scripting support for the
            <ph conkeyref="vbox-conkeyref-phrases/product-name"/> API, see <xref href="VirtualBoxAPI.dita"><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Programming Interfaces</xref>.
            For this to work, an already working Windows Python
            installation on the system is required.
          </p>
        <p>See, for example: <ph>http://www.python.org/download/windows/</ph>. </p>
        <note>
          <p>Python version 3 is required. Python version 2.x is no longer supported. </p>
        </note>
      </li>
    </ul>
    <p>Depending on your Windows configuration, you may see warnings about unsigned drivers, or similar. Click <b
        outputclass="bold">Continue</b> for these warnings, as otherwise <ph
        conkeyref="vbox-conkeyref-phrases/product-name"/> might not function correctly after installation. </p>
    <p>The installer will create an <ph conkeyref="vbox-conkeyref-phrases/product-name"/> group in the Windows <b
        outputclass="bold">Start</b> menu, which enables you to launch the application and access its documentation. </p>
    <p>With standard settings, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> will be installed for all users on
      the local system. If this is not wanted, you must invoke the installer by first extracting as follows: </p>
    <pre xml:space="preserve">VirtualBox.exe -extract</pre>
    <p>Then, run either of the following commands on the extracted .MSI file. This will install <ph
        conkeyref="vbox-conkeyref-phrases/product-name"/> only for the current user. </p>
    <pre xml:space="preserve">VirtualBox.exe -msiparams ALLUSERS=2</pre>
    <pre xml:space="preserve">msiexec /i VirtualBox-&lt;version&gt;-Win.msi ALLUSERS=2</pre>
    <p>If you do not want to install all features of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, you can set
      the optional <codeph>ADDLOCAL</codeph> parameter to explicitly name the features to be installed. The following
      features are available: </p>
    <dl>
      <dlentry>
        <dt>
            VBoxApplication
          </dt>
        <dd>
          <p>
              Main binaries of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
            </p>
          <note>
            <p>
                This feature must not be absent, since it contains the
                minimum set of files to have working <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
                installation.
              </p>
          </note>
        </dd>
      </dlentry>
      <dlentry>
        <dt>VBoxUSB </dt>
        <dd>
          <p>USB support. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>VBoxNetwork </dt>
        <dd>
          <p>All networking support. This includes the VBoxNetworkFlt and VBoxNetworkAdp features. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>VBoxNetworkFlt </dt>
        <dd>
          <p>Bridged networking support. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>VBoxNetworkAdp </dt>
        <dd>
          <p>Host-only networking support </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>VBoxPython </dt>
        <dd>
          <p>Python support </p>
        </dd>
      </dlentry>
    </dl>
    <p>For example, to only install USB support along with the main binaries, run either of the following commands: </p>
    <pre xml:space="preserve">VirtualBox.exe -msiparams ADDLOCAL=VBoxApplication,VBoxUSB</pre>
    <pre xml:space="preserve">msiexec /i VirtualBox-&lt;version&gt;-Win.msi ADDLOCAL=VBoxApplication,VBoxUSB</pre>
    <p>The user is able to choose between NDIS5 and NDIS6 host network filter drivers during the installation. This is
      done using a command line parameter, <codeph>NETWORKTYPE</codeph>. The NDIS6 driver is the default for most
      supported Windows hosts. For some legacy Windows versions, the installer will automatically select the NDIS5
      driver and this cannot be changed. </p>
    <p>You can force an install of the legacy NDIS5 host network filter driver by specifying
        <codeph>NETWORKTYPE=NDIS5</codeph>. For example, to install the NDIS5 driver on Windows 7 use either of the
      following commands: </p>
    <pre xml:space="preserve">VirtualBox.exe -msiparams NETWORKTYPE=NDIS5</pre>
    <pre xml:space="preserve">msiexec /i VirtualBox-&lt;version&gt;-Win;.msi NETWORKTYPE=NDIS5</pre>
  </body>
  
</topic>