This guide explains how you can run virtual machines with VirtualBox 4.1 on a headless OpenSUSE 12.1 server. Normally you use the VirtualBox GUI to manage your virtual machines, but a server does not have a desktop environment. Fortunately, VirtualBox comes with a tool called VBoxHeadless that allows you to connect to the virtual machines over a remote desktop connection, so there’s no need for the VirtualBox GUI.
I do not issue any guarantee that this will work for you!
1 Preliminary Note
I have tested this on an OpenSUSE 12.1 server (host system) with the IP address 192.168.0.100 where I’m logged in as a normal user (user name admin in this example) instead of as root.
If you only have a root account, but no normal user account, create one as follows (user admin, group admin)…
# groupadd admin
# useradd -d /home/admin -m -g admin -s /bin/bash admin
… create a password for the new user…
# passwd admin
… and log in as that user.
2 Installing VirtualBox
To install VirtualBox 4.1 on our OpenSUSE 12.1 server, we need root privileges, therefore we run
First we have to find out what kernel we have installed:
# uname -a
server1:/home/admin # uname -a
Linux server1 3.1.0-1.2-desktop #1 SMP PREEMPT Thu Nov 3 14:45:45 UTC 2011 (187dde0) x86_64 x86_64 x86_64 GNU/Linux
As you see I have the kernel-desktop package installed – if you have the kernel-server package installed, replace desktop with server in the following command.
We install the dependencies for VirtualBox 4.1 as follows (by installing the kernel-desktop/kernel-server package again, we make sure that we have the latest version installed):
# yast -i kernel-desktop kernel-desktop-devel kernel-source kernel-syms Xerces-c gcc make
If the kernel gets updated, YaST will tell you that you must reboot the system – in this case run:
Log in as the normal user again and then become root:
Next download and register the VirtualBox public rpm key:
# wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc
# rpm –import oracle_vbox.asc
Now we enable the VirtualBox OpenSUSE repository on our system (there’s no repo file for OpenSUSE 12.1 because the repo file for 11.4 works on 12.1 as well):
# cd /etc/zypp/repos.d/
# wget http://download.virtualbox.org/virtualbox/rpm/opensuse/11.4/virtualbox.repo
We can now simply install VirtualBox 4.1 as follows:
# yast -i VirtualBox-4.1
Afterwards make sure that the vboxdrv kernel module is loaded:
# modprobe vboxdrv
The following command makes sure that the vboxdrv kernel module gets loaded automatically whenever you boot the system:
# insserv vboxdrv
Starting with version 4.0, VirtualBox has introduced so called “extension packs” and has outsourced some functionality like remote desktop connection support (VRDP) that was part of VirtualBox packages before version 4.0 into these extension packs. Because we need remote desktop connections to control our virtual machines, we need to install the appropriate extension pack now. Go to http://www.virtualbox.org/wiki/Downloads, and you will find a link to the following extension pack:
VirtualBox 4.1.18 Oracle VM VirtualBox Extension Pack
Support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards.
Download and install the extension pack as follows:
# cd /tmp
# wget http://download.virtualbox.org/virtualbox/4.1.18/Oracle_VM_VirtualBox_Extension_Pack-4.1.18-78361.vbox-extpack
# sudo VBoxManage extpack install Oracle_VM_VirtualBox_Extension_Pack-4.1.18-78361.vbox-extpack
(Make sure you grab the latest version from the VirtualBox web site.)
Now we must add the user that will run VirtualBox (admin in this example) to the vboxusers group:
# /usr/sbin/usermod -G vboxusers admin
(You might have to log out and back in to make this change effective.)
VirtualBox is now installed and ready to be used.
to leave the root account and become a normal user (admin) again.
3 Using VirtualBox On The Command Line
3.1 Creating A VM
To create a VM on the command line, we can use the VBoxManage command. See
$ VBoxManage –help
for a list of available switches and (highly recommended!) take a look at http://www.virtualbox.org/manual/ch08.html.
I will now create an Ubuntu 12.04 Server VM with 512MB memory and a 10GB hard drive from the Ubuntu 12.04 Server iso image (which I have stored in /home/ubuntu-12.04-server-amd64.iso):
$ VBoxManage createvm –name “Ubuntu 12.04 Server” –register
$ VBoxManage modifyvm “Ubuntu 12.04 Server” –memory 512 –acpi on –boot1 dvd –nic1 bridged –bridgeadapter1 eth0
$ VBoxManage createhd –filename Ubuntu_12_04_Server.vdi –size 10000
$ VBoxManage storagectl “Ubuntu 12.04 Server” –name “IDE Controller” –add ide
$ VBoxManage storageattach “Ubuntu 12.04 Server” –storagectl “IDE Controller” –port 0 –device 0 –type hdd –medium Ubuntu_12_04_Server.vdi
$ VBoxManage storageattach “Ubuntu 12.04 Server” –storagectl “IDE Controller” –port 1 –device 0 –type dvddrive –medium /home/ubuntu-12.04-server-amd64.iso
3.2 Importing An Existing VM
Let’s assume you have a VM called examplevm that you want to reuse on this host. On the old host, you should have a directory Machines/examplevm in the VirtualBox directory; Machines/examplevm should contain the examplevm.xml file. Copy the examplevm directory (including the examplevm.xml file) to your new Machines directory (if your user name is admin, this is /home/admin/.VirtualBox/Machines – the result should be /home/admin/.VirtualBox/Machines/examplevm/examplevm.xml).
In addition to that copy the examplevm.vdi file from the old VDI directory to the new one (e.g. /home/admin/.VirtualBox/VDI/examplevm.vdi).
Afterwards, you must register the imported VM:
$ VBoxManage registervm Machines/examplevm/examplevm.xml
3.3 Starting A VM With VBoxHeadless
Regardless of if you create a new VM or import and old one, you can start it with the command:
$ VBoxHeadless –startvm “Ubuntu 12.04 Server”
(Replace Ubuntu 12.04 Server with the name of your VM.)
VBoxHeadless will start the VM and a VRDP (VirtualBox Remote Desktop Protocol) server which allows you to see the VM’s output remotely on another machine.
To stop a VM, run
$ VBoxManage controlvm “Ubuntu 12.04 Server” poweroff
To pause a VM, run
$ VBoxManage controlvm “Ubuntu 12.04 Server” pause
To reset a VM, run
$ VBoxManage controlvm “Ubuntu 12.04 Server” reset
To learn more about VBoxHeadless, take a look at
$ VBoxHeadless –help
and at http://www.virtualbox.org/manual/ch07.html#vboxheadless.
4 Connecting To A VM From A Remote Desktop
4.1 Windows XP
You can use the built-in Remote Desktop Connection utility to connect to the VM:
Type in the hostname or IP address of the host (not the guest!):
And voilà, you should be connected to the VM:
On Linux desktops, you can use the rdesktop command to connect to the VM. Open a terminal and type in the following command:
rdesktop -a 16 192.168.0.100
(192.168.0.100 is the host IP address, not the one of the guest – replace it with your own IP address or hostname; -a 16 means 16 bit colour depth.)
You should now be connected to the VM.
On Ubuntu 12.04 desktops, you can use the Remmina Remote Desktop Client to connect to the VM. Just search for remote desktop and then double-click the Remmina Remote Desktop Client icon:
In the Remmina Remote Desktop Client, click on the plus icon to add a new remote desktop connection:
In the Remote Desktop Preference window, fill in a name for the profile (like Ubuntu 12.04 Server), make sure that RDP is selected as the protocol (it should be selected by default), then fill in the host IP address – not the IP of the VirtualBox guest! – in the Server field, and select a higher Color depth than the default of 8bpp – 16bpp is ok. Then click on Connect:
And voilà, you should be connected to the VM:
4.3 If The Remote Desktop Connection Doesn’t Work…
If the remote desktop connection doesn’t work, you’ve probably missed the step where I install the VirtualBox extension pack in chapter 2. Please install the extension pack now, stop your virtual machine (see chapter 3.3), and modify your virtual machine to accept remote desktop connections:
VBoxManage modifyvm “Ubuntu 12.04 Server” –vrde on
(If the extension pack is already installed when you create your virtual machine, remote desktop connections are automatically enabled.)
Then start your virtual machine again.
- VirtualBox: http://www.virtualbox.org/
- OpenSUSE: http://www.opensuse.org/