DokuWiki » Infrastructure » Operating System » CentOS 7

h1. Install Procedure für VirtualBox Guest Additions 5.0

h2. Requirements

To install VirtualBox guest additions you will need the following:

* a virtual machine

* a installed and supported operating system (e.g. CentOS 7.x)

* Virtualbox 5.0.4 or above

* root-access

* a fast internet connection

h2. Preliminary Note

This procedure is based on a documentation supplied by http://www.virtualbox.org/manual/ch04.html#idp11234128

h2. Install Virtual Guest Additions

The VirtualBox Guest Additions for Linux are provided on the same virtual CD-ROM file as the Guest Additions for Windows. They also come with an installation program guiding you through the setup process, although, due to the significant differences between Linux distributions, installation may be slightly more complex than for a windows guest.

Installation generally involves the following steps:

h3. CentOS preperation

Before installing the Guest Additions, you will have to prepare your guest system for building external kernel modules. This works similarly as described in the section called “The VirtualBox kernel module”, except that this step must now be performed in your Linux guest instead of 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 CentOS systems:

- Install EPEL repository

see [[repo_epel|EPEL]]

- update everything

In order to fully update your guest system, open a terminal and run as root

<pre><code class="bash">

yum update

</code></pre>

- Install DKMS

Install Dynamic Kernel Module System: (automatically installs appropriate kernel modules per selected version)

<pre><code class="bash">

yum --enablerepo epel install dkms

</code></pre>

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 as root whenever the guest kernel is updated using the command

<pre><code class="bash">

/etc/init.d/vboxadd setup

</code></pre>

- install the gcc and kernel development packages

Install the GNU C compiler and the kernel development packages using

<pre><code class="bash">

yum install gcc

</code></pre>

followed by

<pre><code class="bash">

yum install kernel-devel

</code></pre>

- install additional tools

Install bzip2

<pre><code class="bash">

yum install bzip2

</code></pre>

- reboot

Reboot your guest system in order to activate the updates and then proceed as described above.

<pre><code class="bash">

reboot

</code></pre>

h3. installation of Guest Additions via X11

Insert the VBoxGuestAdditions.iso CD file into your Linux guest's virtual CD-ROM drive. In the "Devices" menu in the virtual machine's menu bar, VirtualBox has a handy menu item named @Install guest additions@, which mounts the Guest Additions .iso file inside your virtual machine.

Change to the directory where your CD-ROM drive is mounted and execute as root:

<pre><code class="bash">

sh ./VBoxLinuxAdditions.run

</code></pre>

Restart the guest.

<pre><code class="bash">

reboot

</code></pre>

h3. installation of Guest Additions via CLI

On the host-side stop the guest and then insert the VBoxGuestAdditions.iso CD into the virtual CD-ROM drive via

<pre><code class="bash">

VBoxManage modifyvm MyCentOSGuest --dvd /usr/share/virtualbox/VBoxGuestAdditions.iso

</code></pre>

if the CD is not mounted automatically on the guest-side you may do it manually by

<pre><code class="bash">

mount -t iso9660 -o ro /dev/cdrom /media/

</code></pre>

<pre><code class="bash">

sh /media/VBoxLinuxAdditions.run

</code></pre>

<pre><code class="bash">

umount /media/

poweroff

</code></pre>

On the host-side you remove the CD-ROM by

<pre><code class="bash">

VBoxManage modifyvm MyCentOSGuest --dvd none

</code></pre>

h2. Problem