install-win-performing.dita@ 105145

Last change on this file since 105145 was 105134, checked in by vboxsync, 7 months ago

Docs: bugref:10705. This is a merge commit to introduce doc team's changes in the user manual dita files. The following files
are excluded from this process:

Files whose names satrt with "viso", "vboxmanage", "man_", "vboximg", "vboxheadless", or "user_isomakercmd-man".

And general notes about this merge are as follows:

For now I leave glossentry-*dita file as they are since we use different enclosing dita elements
in hdimagewrites.dita we have <note type="attention"> while doc team's copy has <note type="caution">. Not sure if this is significant.

For now I copy doc team's version over.

I have not modified our UserManual.ditamap file. This will be done in a follow up commit.

The list of commits we have merged are as follows:

r3392: 7.1 new features; add comments to some DITA topics
r3730: VBP-283: Update supported platforms; 7.0 and 7.1
r3980: 7.1: reset menu option; add note
r3992: ARM hosts; add draft topic on limitations; add container topic for ARM-based subtopics
r3993: ARM create new VM wizard: add some dummy topics
r4014: ER 34784410 DOCUMENT THE VIRTUAL MACHINE TASKBAR ICONS: port topic and icon graphics from 7.0 tree
r4026: VBP-378: status bar icons; remove any mention of task bar; ported from 7.0
r4034: Cloning a cloud VM; add draft topic
r4035: Cloning a cloud VM;typo
r4036: Cloning a cloud VM;add xref from intro topic
r4050: Reset operation; add instructions
r4051: Amend comment
r4052: Ditaval markup for images
r4056: Add ditaval markup for images
r4057: Add ditaval markup for images
r4058: Add ditaval markup for images
r4073: UI experience level: add dummy topic
r4075: Subtype: option for VM settings General tab and Create VM wizard
r4094: Cloud VM reset; add to relnotes
r4095: Reset VM; use main Machine menu, rather than right-click menu
r4099: ARM hosts; draft revisions to cover different wizard screens
r4134: Cloud VMs: file manager menu option; add comment
r4214: Settings page, Motherboard tab: Chipset option for Arm VMs; add note
r4306: Terminology checker: clear up Errors; Installation chapter
r4307: Terminology checker: clear up Errors; Config settings/GA chapters
r4308: Terminology checker: clear up Errors; Storage, networking, remote VM chapters
r4311: Terminology checker: clear up Errors: various
r4324: Prefences and settings; potential areas for change in 7.1
r4356: r160214: Monitoring cloud VM performance; add new topic
r4358: r160214: Monitoring cloud VM performance; add new topic
r4364: r160214: Monitoring cloud VM performance; redraft topic
r4374: Experience levels; update user manual topic
r4377: Experience levels; Preferences window: add note re. availability of all possible settings
r4378: Experience levels; Preferences window: add note re. availability of all possible settingsLp
r4379: Typos and add remark re. Global menu changes
r4387: Preferences, Display: some settings introduced post-7.0: font scaling and extended features
r4388: Performance monitoring: add cloud VM instances to intro para
r4389: Experience levels: selecting a level, add graphic of icon
r4391: Resource monitoring; add CLI example to show CPU usage for a cloud instance
r4395: Experience levels; apply to menu items only
r4398: Experience levels; add notes
r4401: Experience levels; remove pics of global tools menu/machine tools menu; number of menu items can vary
r4402: Experience levels; remove image files for global tools menu/machine tools menu
r4525: Experience levels: minor redraft
r4528: Typo
r4538: Experience levels: selected level applies throughout VirtualBox Manager GUI
r4543: GUI topics; add notes for required changes
r4544: VISO Creator changes
r4563: r160714: unattended guest install example; now has user-password option
r4569: Terminology: front end, not front-end
r4570: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4571: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4623: Cloud VM monitoring: Compute Instance Monitoring plugin must be enabled; add note
r4625: CPU activity icon; update, now has solid bar
r4626: GUI changes; various, from Serkan; includes new pic for soft keyboard
r4629: separate mode: add some draft topics, will need to get technical review at a later stage
r4634: GUI; various notes and updates
r4655: Typo
r4703: Arm host platform limitations; redraft and add topic to host OS section
r4724: VISO creator; add notes re. ISO import
r4725: Separate mode: edits
r4863: r161176; Python 2.x no longer supported for API
r4899: Arm host support: limitations
r4910: Create VM wizard: settings may vary x86 vs. Arm hosts
r4911: Guest OS support; add note re. supported aarch64 OSes
r4973: r161445: Remove mention of parallel port support
r5004: Cloud VM monitoring: detailed data graphs and Activity Overview
r5038: Cloud VM monitoring: export to file
r5214: r161947: Solaris non-Global zone configuration
r5215: r161947: Solaris non-Global zone configuration; typo
r5230: Glossary: fix title for I/O APIC topic
r5341: Experience levels; can be selected from welcome screen in VirtualBox Manager; need replacement pic
r5345: Experience levels; add note on Welcome screen option
r5346: Arm host limitations; unavailable System settings
r5434: r162377: shared folders; symlinks behaviour
r5565: Cloud VM list in VirtualBox Manager; show mixed VM types; screenshot from Klaus
r5627: Obfuscate UUID data in screen shot
r5628: Delete legacy cloudvm pic; use mixed VMs example
r5654: Clean up comments in source files; redraft VM activity section
r5672: 7.1 changes; add comments
r5683: 7.1 changes; add comments for Arm topics
r5687: 7.1 changes; GUI; add comments
r5703: Oracle notices; include up to date versions in preface-* topics for User Guide
r5707: r162904: Windows install directory requirements; redraft
r5781: updated GNU version from 2 to 3 as per r163272
r5812: started removal of screenshots and updating tasks VBP-807
r5818: Further updates to creating a VM VBP-807
r5822: Restructured topics and made task based VBP-807
r5824: Removed files during restructure VBP-807
r5834: Fixed formatting of note and caution VBP-807
r5836: Updated supported host OS list VBP-825
r5837: updated USB topics for VBP-823
r5842: changes as per legal request re supported guests VBP-843
r5853: Updated versions following review. VBP-825

Property svn:eol-style set to native
Property svn:keywords set to Author Date Id Revision

File size: 7.0 KB

Line
1	<?xml version='1.0' encoding='UTF-8'?>
2	<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3	<topic xml:lang="en-us" id="install-win-performing">
4	<title>Performing the Installation</title>
5
6	<body>
7	<p>
8	The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> installation can be started in either of the
9	following ways:
10	</p>
11	<ul>
12	<li>
13	<p>
14	By double-clicking on the executable file.
15	</p>
16	</li>
17	<li>
18	<p>
19	By entering the following command:
20	</p>
21	<pre xml:space="preserve">VirtualBox-<version>-<revision>-Win.exe -extract</pre>
22	<p>
23	This will extract the installer into a temporary directory,
24	along with the .MSI file. Run the following command to
25	perform the installation:
26	</p>
27	<pre xml:space="preserve">msiexec /i VirtualBox-<version>-<revision>-Win.msi</pre>
28	</li>
29	</ul>
30	<p>
31	Using either way displays the installation
32	<b outputclass="bold">Welcome</b> dialog and enables you
33	to choose where to install <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, and which components
34	to install. In addition to the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> application, the
35	following components are available:
36	</p>
37	<ul>
38	<li>
39	<p><b outputclass="bold">USB support.</b> This package
40	contains special drivers for your Windows host that
41	<ph conkeyref="vbox-conkeyref-phrases/product-name"/> requires to fully support USB devices inside
42	your virtual machines.
43	</p>
44	</li>
45	<li>
46	<p><b outputclass="bold">Networking.</b> This package
47	contains extra networking drivers for your Windows host that
48	<ph conkeyref="vbox-conkeyref-phrases/product-name"/> needs to support Bridged Networking. This
49	enables your VM's virtual network cards to be accessed from
50	other machines on your physical network.
51	</p>
52	</li>
53	<li>
54	<p><b outputclass="bold">Python support.</b> This
55	package contains Python scripting support for the
56	<ph conkeyref="vbox-conkeyref-phrases/product-name"/> API, see <xref href="VirtualBoxAPI.dita"><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Programming Interfaces</xref>.
57	For this to work, an already working Windows Python
58	installation on the system is required.
59	</p>
60	<p>
61	See, for example:
62	<ph>http://www.python.org/download/windows/</ph>.
63	</p>
64	<note>
65	<p> Python version 3 is required. Python version 2.x is no longer supported. </p>
66	</note>
67	</li>
68	</ul>
69	<p>
70	Depending on your Windows configuration, you may see warnings
71	about unsigned drivers, or similar. Click
72	<b outputclass="bold">Continue</b> for these warnings, as
73	otherwise <ph conkeyref="vbox-conkeyref-phrases/product-name"/> might not function correctly after
74	installation.
75	</p>
76	<p>
77	The installer will create an <ph conkeyref="vbox-conkeyref-phrases/product-name"/> group in the Windows
78	<b outputclass="bold">Start</b> menu, which enables you
79	to launch the application and access its documentation.
80	</p>
81	<p>
82	With standard settings, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> will be installed for all
83	users on the local system. If this is not wanted, you must
84	invoke the installer by first extracting as follows:
85	</p>
86	<pre xml:space="preserve">VirtualBox.exe -extract</pre>
87	<p>
88	Then, run either of the following commands on the extracted .MSI
89	file. This will install <ph conkeyref="vbox-conkeyref-phrases/product-name"/> only for the current
90	user.
91	</p>
92	<pre xml:space="preserve">VirtualBox.exe -msiparams ALLUSERS=2</pre>
93	<pre xml:space="preserve">msiexec /i VirtualBox-<version>-Win.msi ALLUSERS=2</pre>
94	<p>
95	If you do not want to install all features of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>,
96	you can set the optional <codeph>ADDLOCAL</codeph> parameter
97	to explicitly name the features to be installed. The following
98	features are available:
99	</p>
100	<dl>
101	<dlentry>
102	<dt>
103	VBoxApplication
104	</dt>
105	<dd>
106	<p>
107	Main binaries of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
108	</p>
109	<note>
110	<p>
111	This feature must not be absent, since it contains the
112	minimum set of files to have working <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
113	installation.
114	</p>
115	</note>
116	</dd>
117	</dlentry>
118	<dlentry>
119	<dt>
120	VBoxUSB
121	</dt>
122	<dd>
123	<p>
124	USB support.
125	</p>
126	</dd>
127	</dlentry>
128	<dlentry>
129	<dt>
130	VBoxNetwork
131	</dt>
132	<dd>
133	<p>
134	All networking support. This includes the VBoxNetworkFlt
135	and VBoxNetworkAdp features.
136	</p>
137	</dd>
138	</dlentry>
139	<dlentry>
140	<dt>
141	VBoxNetworkFlt
142	</dt>
143	<dd>
144	<p>
145	Bridged networking support.
146	</p>
147	</dd>
148	</dlentry>
149	<dlentry>
150	<dt>
151	VBoxNetworkAdp
152	</dt>
153	<dd>
154	<p>
155	Host-only networking support
156	</p>
157	</dd>
158	</dlentry>
159	<dlentry>
160	<dt>
161	VBoxPython
162	</dt>
163	<dd>
164	<p>
165	Python support
166	</p>
167	</dd>
168	</dlentry>
169	</dl>
170	<p>
171	For example, to only install USB support along with the main
172	binaries, run either of the following commands:
173	</p>
174	<pre xml:space="preserve">VirtualBox.exe -msiparams ADDLOCAL=VBoxApplication,VBoxUSB</pre>
175	<pre xml:space="preserve">msiexec /i VirtualBox-<version>-Win.msi ADDLOCAL=VBoxApplication,VBoxUSB</pre>
176	<p>
177	The user is able to choose between NDIS5 and NDIS6 host network
178	filter drivers during the installation. This is done using a
179	command line parameter, <codeph>NETWORKTYPE</codeph>. The
180	NDIS6 driver is the default for most supported Windows hosts.
181	For some legacy Windows versions, the installer will
182	automatically select the NDIS5 driver and this cannot be
183	changed.
184	</p>
185	<p>
186	You can force an install of the legacy NDIS5 host network filter
187	driver by specifying <codeph>NETWORKTYPE=NDIS5</codeph>. For
188	example, to install the NDIS5 driver on Windows 7 use either of
189	the following commands:
190	</p>
191	<pre xml:space="preserve">VirtualBox.exe -msiparams NETWORKTYPE=NDIS5</pre>
192	<pre xml:space="preserve">msiexec /i VirtualBox-<version>-Win;.msi NETWORKTYPE=NDIS5</pre>
193	</body>
194
195	</topic>

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format