install-linux-alt-installer.dita@ 105145

Last change on this file since 105145 was 99797, checked in by vboxsync, 21 months ago
Docs: bugref:10302. Merging changes from the docs team. Almost exclusively conkeyref related stuff.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 3.7 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-linux-alt-installer">
4	<title>Using the Alternative Generic Installer (VirtualBox.run)</title>
5
6	<body>
7	<p>
8	The alternative generic installer performs the following
9	steps:
10	</p>
11	<ul>
12	<li>
13	<p>
14	Unpacks the application files to the target directory
15	<filepath>/opt/VirtualBox/</filepath>, which cannot be
16	changed.
17	</p>
18	</li>
19	<li>
20	<p>
21	Builds and installs the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> kernel modules:
22	<userinput>vboxdrv</userinput>, <userinput>vboxnetflt</userinput>,
23	and <userinput>vboxnetadp</userinput>.
24	</p>
25	</li>
26	<li>
27	<p>
28	Creates <filepath>/sbin/rcvboxdrv</filepath>, an init
29	script to start the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> kernel module.
30	</p>
31	</li>
32	<li>
33	<p>
34	Creates a new system group called
35	<codeph>vboxusers</codeph>.
36	</p>
37	</li>
38	<li>
39	<p>
40	Creates symbolic links in <filepath>/usr/bin</filepath> to
41	a shell script <filepath>/opt/VirtualBox/VBox</filepath>
42	which does some sanity checks and dispatches to the actual
43	executables: <userinput>VirtualBox</userinput>,
44	<userinput>VBoxVRDP</userinput>,
45	<userinput>VBoxHeadless</userinput> and
46	<userinput>VBoxManage</userinput>.
47	</p>
48	</li>
49	<li>
50	<p>
51	Creates
52	<filepath>/etc/udev/rules.d/60-vboxdrv.rules</filepath>, a
53	description file for udev, if that is present, which makes
54	the USB devices accessible to all users in the
55	<codeph>vboxusers</codeph> group.
56	</p>
57	</li>
58	<li>
59	<p>
60	Writes the installation directory to
61	<filepath>/etc/vbox/vbox.cfg</filepath>.
62	</p>
63	</li>
64	</ul>
65	<p>
66	The installer must be executed as root with either
67	<codeph>install</codeph> or <codeph>uninstall</codeph> as
68	the first parameter. For example:
69	</p>
70	<pre xml:space="preserve">sudo ./VirtualBox.run install</pre>
71	<p>
72	Or if you do not have the <userinput>sudo</userinput> command
73	available, run the following as root instead:
74	</p>
75	<pre xml:space="preserve">./VirtualBox.run install</pre>
76	<p>
77	Add every user who needs to access USB devices from a
78	VirtualBox guests to the group <codeph>vboxusers</codeph>.
79	Either use the OS user management tools or run the following
80	command as root:
81	</p>
82	<pre xml:space="preserve">sudo usermod -a -G vboxusers username</pre>
83	<note>
84	<p>
85	The <userinput>usermod</userinput> command of some older Linux
86	distributions does not support the <codeph>-a</codeph>
87	option, which adds the user to the given group without
88	affecting membership of other groups. In this case, find out
89	the current group memberships with the
90	<userinput>groups</userinput> command and add all these groups
91	in a comma-separated list to the command line after the
92	<codeph>-G</codeph> option. For example: <userinput>usermod -G
93	<varname>group1</varname>,<varname>group2</varname>,vboxusers <varname>username</varname></userinput>.
94	</p>
95	</note>
96	</body>
97
98	</topic>

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

Download in other formats:

Original Format