| 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-manual">
|
|---|
| 4 | <title>Performing a Manual Installation</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>If you cannot use the shell script installer described in <xref
|
|---|
| 8 | href="install-linux-alt-installer.dita#install-linux-alt-installer"/>, you can perform a manual
|
|---|
| 9 | installation. Run the installer as follows: </p>
|
|---|
| 10 | <pre xml:space="preserve">./VirtualBox.run --keep --noexec</pre>
|
|---|
| 11 | <p>This will unpack all the files needed for installation in the directory <codeph>install</codeph> under the
|
|---|
| 12 | current directory. The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> application files are contained
|
|---|
| 13 | in <filepath>VirtualBox.tar.bz2</filepath> which you can unpack to any directory on your system. For
|
|---|
| 14 | example: </p>
|
|---|
| 15 | <pre xml:space="preserve">sudo mkdir /opt/VirtualBox
|
|---|
| 16 | sudo tar jxf ./install/VirtualBox.tar.bz2 -C /opt/VirtualBox</pre>
|
|---|
| 17 | <p>To run the same example as root, use the following commands: </p>
|
|---|
| 18 | <pre xml:space="preserve">mkdir /opt/VirtualBox
|
|---|
| 19 | tar jxf ./install/VirtualBox.tar.bz2 -C /opt/VirtualBox</pre>
|
|---|
| 20 | <p>The sources for <ph conkeyref="vbox-conkeyref-phrases/product-name"/>'s kernel module are provided in the
|
|---|
| 21 | <filepath>src</filepath> directory. To build the module, change to the directory and use the following
|
|---|
| 22 | command: </p>
|
|---|
| 23 | <pre xml:space="preserve">make</pre>
|
|---|
| 24 | <p>If everything builds correctly, run the following command to install the module to the appropriate module
|
|---|
| 25 | directory: </p>
|
|---|
| 26 | <pre xml:space="preserve">sudo make install</pre>
|
|---|
| 27 | <p>In case you do not have sudo, switch the user account to root and run the following command: </p>
|
|---|
| 28 | <pre xml:space="preserve">make install</pre>
|
|---|
| 29 | <p>The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> kernel module needs a device node to operate. The above
|
|---|
| 30 | <userinput>make</userinput> command will tell you how to create the device node, depending on your Linux
|
|---|
| 31 | system. The procedure is slightly different for a classical Linux setup with a <filepath>/dev</filepath>
|
|---|
| 32 | directory, a system with the now deprecated <userinput>devfs</userinput> and a modern Linux system with
|
|---|
| 33 | <userinput>udev</userinput>. </p>
|
|---|
| 34 | <p>On certain Linux distributions, you might experience difficulties building the module. You will have to analyze
|
|---|
| 35 | the error messages from the build system to diagnose the cause of the problems. In general, make sure that
|
|---|
| 36 | the correct Linux kernel sources are used for the build process. </p>
|
|---|
| 37 | <p>Note that the <filepath>/dev/vboxdrv</filepath> kernel module device node must be owned by root:root and must be
|
|---|
| 38 | read/writable only for the user. </p>
|
|---|
| 39 | <p>Next, you install the system initialization script for the kernel module and activate the initialization script
|
|---|
| 40 | using the right method for your distribution, as follows: </p>
|
|---|
| 41 | <pre xml:space="preserve">cp /opt/VirtualBox/vboxdrv.sh /sbin/rcvboxdrv</pre>
|
|---|
| 42 | <p>This example assumes you installed <ph conkeyref="vbox-conkeyref-phrases/product-name"/> to the
|
|---|
| 43 | <filepath>/opt/VirtualBox</filepath> directory. </p>
|
|---|
| 44 | <p>Create a configuration file for <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, as follows: </p>
|
|---|
| 45 | <pre xml:space="preserve">mkdir /etc/vbox
|
|---|
| 46 | echo INSTALL_DIR=/opt/VirtualBox > /etc/vbox/vbox.cfg</pre>
|
|---|
| 47 | <p>Create the following symbolic links: </p>
|
|---|
| 48 | <pre xml:space="preserve">ln -sf /opt/VirtualBox/VBox.sh /usr/bin/VirtualBox
|
|---|
| 49 | ln -sf /opt/VirtualBox/VBox.sh /usr/bin/VBoxManage
|
|---|
| 50 | ln -sf /opt/VirtualBox/VBox.sh /usr/bin/VBoxHeadless</pre>
|
|---|
| 51 | </body>
|
|---|
| 52 |
|
|---|
| 53 | </topic>
|
|---|
