| 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>The alternative generic installer performs the following steps: </p>
|
|---|
| 8 | <ul>
|
|---|
| 9 | <li>
|
|---|
| 10 | <p>Unpacks the application files to the target directory <filepath>/opt/VirtualBox/</filepath>, which cannot be
|
|---|
| 11 | changed. </p>
|
|---|
| 12 | </li>
|
|---|
| 13 | <li>
|
|---|
| 14 | <p>Builds and installs the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> kernel modules:
|
|---|
| 15 | <userinput>vboxdrv</userinput>, <userinput>vboxnetflt</userinput>, and <userinput>vboxnetadp</userinput>. </p>
|
|---|
| 16 | </li>
|
|---|
| 17 | <li>
|
|---|
| 18 | <p>Creates <filepath>/sbin/rcvboxdrv</filepath>, an init script to start the <ph
|
|---|
| 19 | conkeyref="vbox-conkeyref-phrases/product-name"/> kernel module. </p>
|
|---|
| 20 | </li>
|
|---|
| 21 | <li>
|
|---|
| 22 | <p>Creates a new system group called <codeph>vboxusers</codeph>. </p>
|
|---|
| 23 | </li>
|
|---|
| 24 | <li>
|
|---|
| 25 | <p>Creates symbolic links in <filepath>/usr/bin</filepath> to a shell script
|
|---|
| 26 | <filepath>/opt/VirtualBox/VBox</filepath> which does some sanity checks and dispatches to the actual
|
|---|
| 27 | executables: <userinput>VirtualBox</userinput>, <userinput>VBoxVRDP</userinput>,
|
|---|
| 28 | <userinput>VBoxHeadless</userinput> and <userinput>VBoxManage</userinput>. </p>
|
|---|
| 29 | </li>
|
|---|
| 30 | <li>
|
|---|
| 31 | <p>Creates <filepath>/etc/udev/rules.d/60-vboxdrv.rules</filepath>, a description file for udev, if that is
|
|---|
| 32 | present, which makes the USB devices accessible to all users in the <codeph>vboxusers</codeph> group. </p>
|
|---|
| 33 | </li>
|
|---|
| 34 | <li>
|
|---|
| 35 | <p>Writes the installation directory to <filepath>/etc/vbox/vbox.cfg</filepath>. </p>
|
|---|
| 36 | </li>
|
|---|
| 37 | </ul>
|
|---|
| 38 | <p>The installer must be executed as root with either <codeph>install</codeph> or <codeph>uninstall</codeph> as the
|
|---|
| 39 | first parameter. For example: </p>
|
|---|
| 40 | <pre xml:space="preserve">sudo ./VirtualBox.run install</pre>
|
|---|
| 41 | <p>Or if you do not have the <userinput>sudo</userinput> command available, run the following as root instead: </p>
|
|---|
| 42 | <pre xml:space="preserve">./VirtualBox.run install</pre>
|
|---|
| 43 | <p>Add every user who needs to access USB devices from a VirtualBox guests to the group <codeph>vboxusers</codeph>.
|
|---|
| 44 | Either use the OS user management tools or run the following command as root: </p>
|
|---|
| 45 | <pre xml:space="preserve">sudo usermod -a -G vboxusers username</pre>
|
|---|
| 46 | <note>
|
|---|
| 47 | <p>The <userinput>usermod</userinput> command of some older Linux distributions does not support the
|
|---|
| 48 | <codeph>-a</codeph> option, which adds the user to the given group without affecting membership of other
|
|---|
| 49 | groups. In this case, find out the current group memberships with the <userinput>groups</userinput> command and
|
|---|
| 50 | add all these groups in a comma-separated list to the command line after the <codeph>-G</codeph> option. For
|
|---|
| 51 | example: <userinput>usermod -G <varname>group1</varname>,<varname>group2</varname>,vboxusers
|
|---|
| 52 | <varname>username</varname></userinput>. </p>
|
|---|
| 53 | </note>
|
|---|
| 54 | </body>
|
|---|
| 55 |
|
|---|
| 56 | </topic>
|
|---|
