README

   1 virt-mem tools
   2 Copyright (C) 2008 Red Hat Inc.
   3 ----------------------------------------------------------------------
   4
   5 These are a collection of monitoring and management tools for virtual
   6 machines.
   7
   8 Commands we support at the moment include:
   9
  10   virt-uname      'uname' command, shows OS version, architecture, etc.
  11   virt-dmesg      'dmesg' command, shows kernel messages
  12   virt-ps         'ps' command, shows process list
  13
  14 The general idea is that they allow you to monitor virtual machines
  15 without needing to log in to the machine itself or install any extra
  16 software inside the virtual machine.  At the moment we only support
  17 virtual machines running Linux kernel >= 2.6, but we expect to support
  18 other operating systems in the future.
  19
  20 The commands use libvirt to access the underlying virtualization
  21 system, so we support a variety of different systems such as Xen, QEMU
  22 and KVM, and more can be added just by adding support to libvirt.
  23
  24
  25 Website
  26 ----------------------------------------------------------------------
  27
  28 http://et.redhat.com/~rjones/virt-mem/
  29
  30 We supply the latest source and binaries at the above site.
  31
  32
  33 Building from source
  34 ----------------------------------------------------------------------
  35
  36 Run ./configure and look at the output for any missing packages.
  37
  38 Then:
  39
  40   make
  41
  42 Then run the virt-mem meta-tool, for example:
  43
  44   ./mem/virt-mem.opt dmesg
  45
  46 (If this binary is linked with the name 'virt-dmesg' then it behaves
  47 in the same way).
  48
  49 To install the binaries, man pages and message catalogs, do this as
  50 root:
  51
  52   make install