About umlmgr

umlmgr is a tool for managing User Mode Linux instances. It provides a curses-based user interface which lists uml instances and allows the user to perform mconsole operations, view statistics and information, and access the uml's console ttys.

Features / Screenshots

The main menu (above) allows you see all running umls at a glance and select one to perform these operations on:

View various information (device configuration, memory...) [screen shot]
Access various operations from a menu (shut down, reboot, etc) [screen shot]
Access uml console ports. The built-in terminal emulator is trivial at the moment and doesn't implement any terminal escape commands. It will probably be replaced with a call out to screen in a future version. [screen shot]
Access all mconsole operations through a built-in command line interface similar to the uml_mconsole utility. [screen shot]

Status

umlmgr is beta and not yet finished, but all of the features above work (although the terminal emulator is trivial, as mentioned above). This is the first public release.

Getting It

umlmgr 0.9.0 released December 17 2003

Using it

Pre-requisites

Python 2.2 or higher. I've only tested with 2.2.2 and up, but any python >= 2.2 should work. If you find out otherwise, let me know.

Installation

% tar xzf umlmgr-0.9.0.tar.gz
edit umlmgr-0.9.0/main.py, change first line to reflect the path to your python
% mv umlmgr-0.9.0 /usr/local/lib 
% ln -s /usr/local/lib/umlmgr-0.9.0/main.py /usr/local/bin/umlmgr

Running

warning:Don't try to access the uml's main console (tty 0) if it is assigned to a pts device. You won't be able to access the console again after closing it for the first time. 2.4.22-5um and earlier will segfault.

When you run umlmgr, it will scan $HOME/.uml for unix domain sockets. It will try to query the found sockets for the uml's status. They will be displayed in the main menu.

If you want umlmgr to scan additional directories for mconsole sockets, use the '-d <path>' argument. You may supply more than one. To prevent umlmgr from scanning $HOME/.uml, use the -x argument.

Hit 'r' at the main menu to have umlmgr rescan and refresh the display. You'll need to do this to get new umls to show up in the listing. In future versions this will be automatic.

You can have umlmgr go directly to the command menu for a particular uml instance (and then exit) by specifying its umid as the only argument. The search proceedures for the mconsole socket are as above. A known bug is that if you specify a non-existant uml, you'll get an exception.

Feedback

Bug reports, code, comments and suggestions for future features are welcomed. Contact me (Steve Benson) at steve AT rhythm DOT cx.