X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=2deb9841dfde7812514d661fc4b9f811687ff644;hb=b266768eda005d900a9f232de0ba3827b37627f4;hp=cd9120412078552124e2b371722713857ec574a2;hpb=2da7bf9c87d07e5732382eb65b26a679e16d3cec;p=virt-hostinfo.git diff --git a/README b/README index cd91204..2deb984 100644 --- a/README +++ b/README @@ -12,8 +12,20 @@ http://fedoraproject.org/wiki/Features/Hostinfo Requirements ---------------------------------------------------------------------- +- C compiler + - APR (Apache Portable Runtime) 1.3 +- Perl + +- pod2man and other perldoc tools + * these are usually supplied with Perl + +- libvirt & development tools + +- Perl module Sys::Virt + + Build ---------------------------------------------------------------------- @@ -31,7 +43,7 @@ Host configuration ---------------------------------------------------------------------- You can edit the text configuration files under /etc/hostinfod by -hand. Please read the hostinfod(8) manual page. +hand. Please read the hostinfo(8) manual page. For graphical configuration, use virt-manager. @@ -43,31 +55,12 @@ Accessing host information from guests ---------------------------------------------------------------------- No special software is required inside the guest. Simply connect to -the serial port[1] (eg. /dev/ttyS1 or COM2) using your favorite serial -terminal software and send commands. +the serial port (usually, but not always, /dev/ttyS1 or COM2) using +your favorite serial terminal software and send commands. The protocol is a simple, line-based, text protocol. No special libraries are needed to use it from programs or by hand. The commands -that you can send are documented in the hostinfod(8) manual page. - -If you get no response on the serial port at all, check on the host -side that the guest is allowed access (see /etc/hostinfod/). Also -check that the serial port has been set up in libvirt: - - virsh dumpxml DOMAIN - -(should show a clause) - -Also check that hostinfod (the daemon) is running on the host. - -Note that serial port settings like speed, parity etc. make no -difference for these emulated serial ports, so that won't be a factor. - -If you get an answer from the hostinfo daemon, but it indicates a -permissions error, check on the host side that the guest is allowed to -access the particular resource (see /etc/hostinfod/). +that you can send are documented in the hostinfo-protocol(5) manual +page. -[1] _Which_ serial port can vary - you need to either try them one by -one or ask the host administrator to tell you. We try to stay on the -second serial port (ttyS1 or COM2) but there are some configurations -where we get bumped up or down to other serial ports. +For troubleshooting, see hostinfo(8) manual page.