----------------------------------------------------------------------
UMLMON - A monitor for User Mode Linux
----------------------------------------------------------------------

UMLMON is a monitor for User Mode Linux (UML) that set ups a runtime
environment for UML and controls the execution of UML. UMLMON uses
a quite advanced client/server architecture, is rock-stable, and
even has a web interface.

In the past, UMLMON was sold as commercial product. With this release,
it is now free software that can be distributed under the terms of
the GPL. Nevertheless, the author hopes to see some support contracts
(see below).

UMLMON has the following features:

- UMLMON creates and maintains a runtime environment for UML. This
  includes a chroot jail and the automatic setup of needed resources.

- UMLMON is a daemon with an RPC interface. One can control the daemon
  and the running UML instance by sending commands over this interface.
  The RPC interface works locally and over the network.

- Of course, one can start and stop the UML instance over the
  UMLMON daemon.

- UMLMON can establish bidirectional connections to the virtual
  consoles and the virtual serial lines. This means one can directly
  have an interactive session on the virtual machine without having
  to rely on networking.

- UMLMON can log the output of virtual consoles. Even log rotation
  is supported.

- UMLMON has administrative functions to create and manipulate
  virtual disks.

- UMLMON eases the setup of virtual networking.

- UMLMON is a secure environment. Although the daemon runs as root,
  it is written in a _safe_ programming language such that it is
  impossible that buffer overflows or other flaws of low-level
  languages allow attackers to break in.

- There is a command-line interface and a web interface.
  Due to restricted resources the latter is currently only
  available in German language. A multilingual version is
  planned, though.

----------------------------------------------------------------------
Installation
----------------------------------------------------------------------

See the file INSTALL for extensive documentation. In short, you need
a lot of third-party modules to get it running. As simpler way,
it is suggested to install the GODI distribution of Objective Caml
and to install the apps-umlmon package.

See http://godi.ocaml-programming.de.

----------------------------------------------------------------------
Changes
----------------------------------------------------------------------

See the file Changes for recent changes. Version 1.0.1 is the first
publicly available release.

----------------------------------------------------------------------
Author
----------------------------------------------------------------------

UMLMON is written by Gerd Stolpmann <gerd@gerd-stolpmann.de>. Please
report bugs to Gerd.

----------------------------------------------------------------------
Homepage
----------------------------------------------------------------------

The UMLMON homepage is at http://www.gerd-stolpmann.de/umlmon.

----------------------------------------------------------------------
Get support
----------------------------------------------------------------------

If you need help with your UML setup you can get commercial support
from Gerd Stolpmann. This does not only include UMLMON questions,
but also UML itself, e.g. which kernels can be recommended, etc.
Outside of Germany support can only be given by Internet, e.g.
the right to ask questions, the preparation of kernels etc. Gerd
Stolpmann is an entrepeneur so there are no problems with billing.