File: install-win-performing.dita

package info (click to toggle)
virtualbox 7.2.2-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 616,072 kB
  • sloc: cpp: 2,377,613; ansic: 2,351,258; asm: 379,359; python: 233,965; xml: 89,678; sh: 25,697; makefile: 8,169; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,785; javascript: 1,692; objc: 1,131; lex: 931; sed: 921; php: 906; yacc: 707
file content (123 lines) | stat: -rw-r--r-- 5,736 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
<?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>
  </body>
  
</topic>