Index: /trunk/doc/manual/en_US/user_Glossary.xml =================================================================== --- /trunk/doc/manual/en_US/user_Glossary.xml (revision 62237) +++ /trunk/doc/manual/en_US/user_Glossary.xml (revision 62238) @@ -117,14 +117,4 @@ machine when networking is configured to NAT; see . - - - - - DKMS - - - Dynamic Kernel Module Support. A framework that simplifies - installing and updating external kernel modules on Linux machines; see - . Index: /trunk/doc/manual/en_US/user_GuestAdditions.xml =================================================================== --- /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 62237) +++ /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 62238) @@ -595,16 +595,7 @@ on a Linux host system, as described there. - Again, as with Linux hosts, we recommend using DKMS if it is - available for the guest system. If it is not installed, use this - command for Ubuntu/Debian systems: - sudo apt-get install dkms - or for Fedora systems: yum install dkms - - Be sure to install DKMS before - installing the Linux Guest Additions. If DKMS is not available - or not installed, the guest kernel modules will need to be - recreated manually whenever the guest kernel is updated using - the command rcvboxadd setup as root. - + If you suspect that something has gone wrong, check that your + guest is set up correctly and try executing the command + rcvboxadd setup as root. @@ -625,224 +616,4 @@ - - For your convenience, we provide the following step-by-step - instructions for freshly installed copies of recent versions of the most - popular Linux distributions. After these preparational steps, you can - execute the VirtualBox Guest Additions installer as described - above. - - - Ubuntu - - - - In order to fully update your guest system, open a - terminal and run apt-get update as root - followed by apt-get upgrade - - - - Install DKMS using apt-get install dkms - - - - Reboot your guest system in order to activate the - updates and then proceed as described above. - - - - - - Fedora - - - - In order to fully update your guest system, open a - terminal and run yum update as root. - - - - Install DKMS and the GNU C compiler using yum install dkms - followed by yum install gcc - - - - Reboot your guest system in order to activate the - updates and then proceed as described above. - - - - - - openSUSE - - - - In order to fully update your guest system, open a - terminal and run zypper update as root. - - - - Install the make tool and the GNU C compiler using - zypper install make gcc - - - - Reboot your guest system in order to activate the - updates. - - - - Find out which kernel you are running using uname -a - An example would be - 2.6.31.12-0.2-default which - refers to the "default" kernel. Then install the correct - kernel development package. In the above example this would be - zypper install kernel-default-devel - - - - Make sure that your running kernel - (uname -a) and the kernel - packages you have installed (rpm -qa - kernel\*) have the exact same version number. - Proceed with the installation as described above. - - - - - - SuSE Linux Enterprise Desktop (SLED) - - - - In order to fully update your guest system, open a - terminal and run zypper update as root. - - - - Install the GNU C compiler using zypper install gcc - - - - Reboot your guest system in order to activate the - updates. - - - - Find out which kernel you are running using uname -a - An example would be - 2.6.27.19-5.1-default which - refers to the "default" kernel. Then install the correct - kernel development package. In the above example this would be - zypper install kernel-syms kernel-source - - - - Make sure that your running kernel - (uname -a) and the kernel - packages you have installed (rpm -qa - kernel\*) have the exact same version number. - Proceed with the installation as described above. - - - - - - Mandrake - - - - Mandrake ships with the VirtualBox Guest Additions which - will be replaced if you follow these steps. - - - - In order to fully update your guest system, open a - terminal and run urpmi --auto-update - as root. - - - - Reboot your system in order to activate the - updates. - - - - Install DKMS using urpmi dkms and make - sure to choose the correct kernel-devel package when asked by - the installer (use uname -a - to compare). - - - - - - Oracle Linux, Red Hat Enterprise Linux and CentOS - - - - For versions prior to 6, add divider=10 - to the kernel boot options in - /etc/grub.conf to reduce the - idle CPU load. - - - - In order to fully update your guest system, open a - terminal and run yum update as root. - - - - Install the GNU C compiler and the kernel development - packages using yum install gcc followed by - yum install kernel-devel For Oracle UEK - kernels, use yum install kernel-uek-devel - to install the UEK kernel headers. - - - - Reboot your guest system in order to activate the - updates and then proceed as described above. - - - - In case Oracle Linux does not find the - required packages, you either have to install them from a - different source (e.g. DVD) or use Oracle's public Yum server - located at http://public-yum.oracle.com. - - - - - - Debian - - - - In order to fully update your guest system, open a - terminal and run apt-get update as root - followed by apt-get upgrade - - - - Install the make tool and the GNU C compiler using - apt-get install make gcc - - - - Reboot your guest system in order to activate the - updates. - - - - Determine the exact version of your kernel using - uname -a and install the - correct version of the linux-headers package, e.g. using - apt-get install linux-headers-2.6.26-2-686 - - - Index: /trunk/doc/manual/en_US/user_Installation.xml =================================================================== --- /trunk/doc/manual/en_US/user_Installation.xml (revision 62237) +++ /trunk/doc/manual/en_US/user_Installation.xml (revision 62238) @@ -366,100 +366,61 @@ more advanced networking features of VirtualBox. - The VirtualBox kernel module is automatically installed on your - system when you install VirtualBox. To maintain it with future kernel - updates, for those Linux distributions which provide it -- most current - ones -- we recommend installing Dynamic Kernel Module Support - (DKMS) - See http://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support - for an introduction. - . This framework helps with building and upgrading kernel - modules. - - If DKMS is not already installed, execute one of the following: + The modules will be built automatically during installation or + after kernel updates if your Linux system is prepared for building + external kernel modules. + + Most Linux distributions can be set up simply by installing + the right packages - normally, these will be the GNU compiler + (GCC), GNU Make (make) and packages containing header files for + your kernel - and making sure that all system updates are + installed and that the system is running the most up-to-date + kernel included in the distribution. The version numbers + of the header file packages must be the same as that of the kernel + you are using. + - - On an Ubuntu system: - - sudo apt-get install dkms - - - - On a Fedora system:yum install dkms - - - - On a Mandriva or Mageia system:urpmi dkms - - - - If DKMS is available and installed, the VirtualBox kernel module - should always work automatically, and it will be automatically rebuilt - if your host kernel is updated. - - Otherwise, there are only two situations in which you will need to - worry about the kernel module: - - The original installation fails. This probably means that - your Linux system is not prepared for building external kernel - modules. - - Most Linux distributions can be set up simply by installing - the right packages - normally, these will be the GNU compiler - (GCC), GNU Make (make) and packages containing header files for - your kernel - and making sure that all system updates are - installed and that the system is running the most up-to-date - kernel included in the distribution. The version numbers - of the header file packages must be the same as that of the kernel - you are using. - - - - With Debian and Ubuntu releases, you must install the - right version of the - linux-headers and if it - exists the linux-kbuild - package. Current Ubuntu releases should have the right - packages installed by default. - - - - In even older Debian and Ubuntu releases, you must - install the right version of the - kernel-headers - package. - - - - On Fedora and Redhat systems, the package is - kernel-devel. - - - - On SUSE and openSUSE Linux, you must install the right - versions of the kernel-source - and kernel-syms - packages. - - - - If you have built your own kernel, you will need to make - sure that you also installed all the required header and other - files for building external modules to the right locations. - The details of how to do this will depend on how you built - your kernel, and if you are unsure you should consult the - documentation which you followed to do so. - - - - - - The kernel of your Linux host was updated and DKMS is not - installed. In that case, the kernel module will need to be - reinstalled by executing (as root): - - rcvboxdrv setup - - + + With Debian and Ubuntu releases, you must install the + right version of the + linux-headers and if it + exists the linux-kbuild + package. Current Ubuntu releases should have the right + packages installed by default. + + + + In even older Debian and Ubuntu releases, you must + install the right version of the + kernel-headers + package. + + + + On Fedora and Redhat systems, the package is + kernel-devel. + + + + On SUSE and openSUSE Linux, you must install the right + versions of the kernel-source + and kernel-syms + packages. + + + + If you have built your own kernel, you will need to make + sure that you also installed all the required header and other + files for building external modules to the right locations. + The details of how to do this will depend on how you built + your kernel, and if you are unsure you should consult the + documentation which you followed to do so. + + + + If you suspect that something has gone wrong with module installation, + check that your system is set up as described above and try running (as root) + the following command: + + rcvboxdrv setup