UVMM Quickstart-3.2

From Univention Wiki

Revision as of 08:33, 17 October 2014 by Gulden (talk | contribs) (Update link.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Produktlogo UCS Version 3.2
Languages: Flag USA EnglishFlag Germany Deutsch

UCS Virtual Machine Manager (UVMM) is a service in Univention Corporate Server (UCS) for the administration of a virtualization infrastructure. The physical servers for virtualization, virtual machines, hard drives and CD-ROM and DVD images are administrated with UVMM. UVMM is integrated in UCS and supports the virtualization technologies Xen and KVM.

This quickstart guide serves as a basis for the use of UVMM and describes the setup of one single virtualization server. As an example two virtual machines are created, one additional UCS system and a Windows system.

A detailed description of UVMM can be found in UCS manual.

Additional in-depth documentation is available in the (German) Wiki article UVMM Technical Details.


The following simple preparation is needed to start with UCS Virtual Machine Manager.


This quickstart guide needs the DVD-ISO of Univention Corporate Server for installation. It can be downloaded for free from the Univention website. The installation of UCS is described in the UCS quickstart guide. This tutorial describes the settings differing from the UCS quickstart guide in the section Installation below. In order to use UVMM, UCS has to be installed on physical hardware.

The UCS manual describes the extensive possibilities of Univention Corporate Server.

Selecting a virtualization technology

UCS supports two different virtualization technologies:

KVM is a virtualization technology integrated directly in the Linux kernel which only functions on computers whose CPU includes support for virtualization (VT for Intel CPUs and AMD-V for AMD processors). A detailed description can be found in Wikipedia at http://en.wikipedia.org/wiki/Kernel-based_Virtual_Machine.

Xen is a virtualization technology based on a hypervisor model and which can be used on all Intel/AMD-CPUs. A detailed description can be found in Wikipedia at http://en.wikipedia.org/wiki/Xen.

The UCS Virtual Machine Manager accesses the underlying virtualization layers via an abstraction library (libvirt). Administration of the systems in UVMM is thus identical even though there are some functional differences in the libvirt support. The most important is that the use of snapshots is currently only possible with KVM.

This quickstart guide refers to the use of KVM. To be able to install a virtualization server for the virtualization with Xen, Xen virtualization server must be selected during installation instead of KVM virtualization server. Xen and KVM should not be installed in parallel on a single virtualization server.


A virtualization environment based on UCS is composed of two components; the virtualization servers (based on Xen or KVM) and the UCS Virtual Machine Manager (UVMM).

UVMM gathers the necessary information from the different virtualization servers and allows consistent administration.

To be able to virtualize systems with UCS, at least one server must be installed with a virtualization component based on KVM or Xen. UVMM itself must be installed on the same UCS system or another in the environment.

UCS is available in 32- and 64-bit versions. A 64-bit system (amd64) is recommended for use as a virtualization server.

Each UCS system is assigned a system role. The following table shows which system roles can be used for which virtualization component:

System role
DC Master DC Backup DC Slave Member server
Virtualization server X X X X

This quickstart guide sets up a new UCS environment and begins with the installation of a DC master, which is used as the physical server for virtualization and provides the UVMM service at the same time. All three modules can also be installed on separate systems.

The UCS quickstart guide describes the installation of UCS. Select the following different settings for the installation to use virtualization with UVMM:

  • System role: master domain controller
  • Software selection: Select Management server for KVM or Xen and Xen virtualization server. Not required software can be removed from the selection here.

Following the confirmation in the installer, UCS is installed. The system needs to be restarted at the end of the installation.

Following the installation and update, the UMC can be opened in the web browser at https://[IP-address]/univention-management-console/ . The login data are the user name Administrator and the root password specified during the installation.

UMC module for Virtual Machines

The UVMM service is administrated in the web-based Univention Management Console (UMC) with the virtual machines module (UVMM). This module should be used for managing the virtual machines and servers.

Overview of UVMM

Virtualization profiles

The UMC module Virtual machines (UVMM) provides predefined profiles for the creation of virtual instances in the wizard. As such, the majority of settings are already filled in with default values. The values can be subsequently changed in the wizard or later in the advanced settings. At present, depending of the employed computer architecture i386 or amd64, the following predefined profiles are available.

  • Windows XP
  • Windows 7
  • Windows 7 (64 Bit)
  • Windows 2003
  • Windows 2003 R2 (64 Bit)
  • Windows 2008
  • Windows 2008 R2 (64 Bit)
  • UCS 3.2
  • UCS 3.2 (64 Bit)
  • UCS 3.1
  • UCS 3.1 (64 Bit)
  • Other
  • Other (64 Bit)

Storage pools

UVMM uses storage pools to access hard drive and ISO images. Storage pools can be a local directory on a virtualization server or an NFS share, iSCSI target or an LVM volume.

In this quickstart guide, the image files are saved locally on the computer. In an environment with several virtualization servers, it is recommended to store the data in a central share. More detailed information can be found in the extended documentation (currently only available in German).

Creating a virtual machine with Univention Corporate Server

To create a virtual instance, Create' needs to be clicked. A wizard guides the user through the individual steps. A UCS system is virtualized as a example for this article. The outline data for the configuration of the virtual instance is specified, a UCS DVD is mounted as a DVD drive and a hard drive is created.

  • Physical server: The currently installed system
  • Profile: UCS 3.2
  • Name: ucs32-1
  • Description: UCS test system
  • The default settings for the memory, CPUs and direct access (VNC) are not modified.

Now a DVD drive is added in the drive settings dialogue. Add needs to be clicked for this.

  • Drive type: Use a local device
  • Device filename: /dev/cdrom

Now a DVD drive is mounted in the drive settings dialogue. Add drive needs to be clicked for this.

  • Drive type: Create a new image
  • The proposed settings for the pool, file name and size can be used unmodified. Of course, you may also adapt these values to suit your personal requirements. The preset image format (extended format (qcow2) for KVM, simple format (raw) for Xen) should be retained.

To create the virtual instance, click on Finish at the bottom of the page.

Installation of UCS in the virtual machine

Once the virtual instance has been saved, the UCS 3.2 DVD should be inserted in the drive of the virtualization server. The virtual machine in UVMM must now be started with the operation Startvm.png. Clicking on Uvmm-vnc.png makes the screen output of the virtual instance appear in the web browser. As the UCS installation DVD was assigned to the virtual instance, the Univention Installer starts and a virtualized UCS is installed as usual.

Attention: Following the installation, the hard drive can be set as a boot medium in the overview of the virtual instance or the CDROM drive can be removed so that the virtual instance is not started from the mounted DVD image again during start-up.

Installing Windows on a virtual machine

To be able to virtualize Windows, a virtual maschine is created analogous to the UCS setup. One of the available Windows profiles must be selected.

Clicking on Startvm.png loads the virtual instance and starts the Windows Installer from the DVD image. The installation can be performed via VNC by clicking on the view icon Uvmm-vnc.png.

After successful installation of the Windows system, we recommend using the remote desktop protocol (RDP) for accessing to the virtual machine.

Access via RDP — and particularly displaying the cursor — is considerably smoother in comparison with VNC.

RDP access can be activated in Microsoft Windows Server 2003/2008, Windows XP Professional and Windows Vista Business/Enterprise/Ultimate under Control panel → System Properties → Remote by activating the Remote Support and Remote Desktop options.

RDP clients are shipped with Microsoft Windows as standard as of Windows XP. For Linux-based systems the programs rdesktop and krdc are delivered with Univention Corporate Server.

Installation of support drivers in the virtualized Windows system

The performance of virtualized Windows systems can be increased considerably by installing support drivers.

Further information

Help on UVMM is offered in the Univention Forum.

Errors in the documentation or programs can be reported directly in the Univention Bugzilla.

Personal tools