March 2011 - Devel - libvirt List Archives

[libvirt] [libvirt-snmp][PATCH] Cleanup autotools files to produce rpmlint compliant rpms.
by Michal Privoznik 02 Mar '11

02 Mar '11

Added manpage for libvirtMib_subagent and ChangeLog generation. --- INSTALL | 48 ------------------------ INSTALL.1st | 48 ++++++++++++++++++++++++ Makefile.am | 17 ++++++++- NEWS | 3 + configure.ac | 2 +- docs/Makefile.am | 10 +++++ docs/libvirtMib_subagent.pod | 84 ++++++++++++++++++++++++++++++++++++++++++ libvirt-snmp.spec.in | 4 +- 8 files changed, 164 insertions(+), 52 deletions(-) delete mode 100644 ChangeLog delete mode 100644 INSTALL create mode 100644 INSTALL.1st create mode 100644 docs/Makefile.am create mode 100644 docs/libvirtMib_subagent.pod diff --git a/ChangeLog b/ChangeLog deleted file mode 100644 index e69de29..0000000 diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 31345d8..0000000 --- a/INSTALL +++ /dev/null @@ -1,48 +0,0 @@ -To create configure script just run: - autoreconf -i - -which runs aclocal, autoconf, automake and all other -GNU Autotools in right order producing configure script, -Makefile.in, etc. - -Then just run: - ./configure - -which will check for dependencies (see src/README.txt -for further info). - -Now it's time for make: - make - su -c "make install" - -This compile all sources producing runable SNMP subagent -libvirtMib_subagent, which is installed right after. -But before we run it, we need to edit /etc/snmp/snmpd.conf -so it contains this two lines: - -rwcommunity public -master agentx - -and then restart snmpd: - /etc/init.d/snmpd restart - -Now it's the right time to run the subagent (as root): - libvirtMib_subagent -f -L - -From now on, you can use SNMP tools to manipulate domains. -E.g. to list domains: - snmpwalk -m ALL -v 2c -c public localhost libvirtMIB -or: - snmptable -m ALL -v 2c -c public -Cb localhost libvirtGuestTable - -Note -m ALL switch witch load all MIBs installed. -This is needed since we do have libvirt's MIB in -the right place, but default it won't be loaded. -The other way of solving this problem is to edit -snmp.config, usually located in /etc/snmp/, or -/usr/local/share/snmp.conf or per-user configuration -$HOME/.snmp/snmp.conf. Or you can just run: - net-snmp-config --snmpconfpath - -All you need to do is add: - mibs +LIBVIRT-MIB diff --git a/INSTALL.1st b/INSTALL.1st new file mode 100644 index 0000000..31345d8 --- /dev/null +++ b/INSTALL.1st @@ -0,0 +1,48 @@ +To create configure script just run: + autoreconf -i + +which runs aclocal, autoconf, automake and all other +GNU Autotools in right order producing configure script, +Makefile.in, etc. + +Then just run: + ./configure + +which will check for dependencies (see src/README.txt +for further info). + +Now it's time for make: + make + su -c "make install" + +This compile all sources producing runable SNMP subagent +libvirtMib_subagent, which is installed right after. +But before we run it, we need to edit /etc/snmp/snmpd.conf +so it contains this two lines: + +rwcommunity public +master agentx + +and then restart snmpd: + /etc/init.d/snmpd restart + +Now it's the right time to run the subagent (as root): + libvirtMib_subagent -f -L + +From now on, you can use SNMP tools to manipulate domains. +E.g. to list domains: + snmpwalk -m ALL -v 2c -c public localhost libvirtMIB +or: + snmptable -m ALL -v 2c -c public -Cb localhost libvirtGuestTable + +Note -m ALL switch witch load all MIBs installed. +This is needed since we do have libvirt's MIB in +the right place, but default it won't be loaded. +The other way of solving this problem is to edit +snmp.config, usually located in /etc/snmp/, or +/usr/local/share/snmp.conf or per-user configuration +$HOME/.snmp/snmp.conf. Or you can just run: + net-snmp-config --snmpconfpath + +All you need to do is add: + mibs +LIBVIRT-MIB diff --git a/Makefile.am b/Makefile.am index fae2848..36590dc 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1 +1,16 @@ -SUBDIRS=src/ +SUBDIRS=src/ docs/ + +EXTRA_DIST = \ + libvirt-snmp.spec libvirt-snmp.spec.in \ + autobuild.sh \ + autogen.sh + +rpm: clean + @(unset CDPATH ; $(MAKE) dist && rpmbuild -ta $(distdir).tar.gz) + +.PHONY: gen-Changelog +gen-ChangeLog: + if [ -d .git ]; then \ + git log --oneline | sed 's/[0-9a-f]* $.*$/\1/' > ChangeLog; \ + fi + diff --git a/NEWS b/NEWS index e69de29..6023f6b 100644 --- a/NEWS +++ b/NEWS @@ -0,0 +1,3 @@ +0.0.1: Feb 3 2011: + - Initial revision + - Basic libvirt functionality (get/set domain status) diff --git a/configure.ac b/configure.ac index a5fcb4e..468fb07 100644 --- a/configure.ac +++ b/configure.ac @@ -86,5 +86,5 @@ fi AC_SUBST([MIB_DIR]) -AC_OUTPUT(Makefile src/Makefile libvirt-snmp.spec) +AC_OUTPUT(Makefile src/Makefile docs/Makefile libvirt-snmp.spec) diff --git a/docs/Makefile.am b/docs/Makefile.am new file mode 100644 index 0000000..a9c66fb --- /dev/null +++ b/docs/Makefile.am @@ -0,0 +1,10 @@ +POD2MAN = pod2man -c "Virtualization Support" -r "$(PACKAGE)-$(VERSION)" + +EXTRA_DIST = \ + libvirtMib_subagent.pod + +dist_man1_MANS = libvirtMib_subagent.1 + +libvirtMib_subagent.1: libvirtMib_subagent.pod + $(AM_V_GEN)$(POD2MAN) $< $(srcdir)/$@ + diff --git a/docs/libvirtMib_subagent.pod b/docs/libvirtMib_subagent.pod new file mode 100644 index 0000000..96faaab --- /dev/null +++ b/docs/libvirtMib_subagent.pod @@ -0,0 +1,84 @@ +=head1 NAME + +libvirtMib_subagent - SNMP subagent for libvirt + +=head1 SYNOPSIS + +B<libvirtMib_subagent> [I<OPTIONS>] [I<LISTENING ADDRESSES>] + +=head1 DESCRIPTION + +The B<libvirtMib_subagent> provides SNMP functionality for libvirt. +Therefore it is now possible to gather and set domain status over +SNMP from one place. This allows to create views of entire platforms +end to end. + +It communicates with SNMP agent over AgentX protocol (RFC 2741) and +extends agent's set of infomation provided. Therefore, we need a running +SNMP agent. This behaviour can be avoided using I<-M> option. + +The B<libvirtMib_subagent> understands these I<OPTIONS>: + +=over 4 + +=item B<-f> + +Don't fork. Run in foreground. + +=item B<-D>[I<token>[,I<...>]] + +Turn on debugging output for the given TOKEN(s). +Without any tokens specified, it defaults to printing +all the tokens (which is equivalent to the keyword 'C<ALL>'). +You might want to try ALL for extremely verbose output. +B<Note>: You can't put a space between the B<-D> and the I<token>s. + +=item B<-H> + +Display a list of configuration file directives +understood by the agent and then exit. + +=item B<-M> + +Run as a normal SNMP Agent instead of an AgentX sub-agent. + +=item B<-x>I<ADDRESS> + +Connect to master agent at ADDRESS (default C</var/agentx/master>). The address +can either be a Unix domain socket path, or the address of a network interface. +The format is the same as the format of listening addresses described below. + +=item B<-L> + +Do not open a log file; print all messages to stderr. + +=back + +The last optional I<LISTENING ADDRESSES> specify on which addresses should +subagent running in normal SNMP Agent mode listen for incoming requests. +See B<snmpd> for further information. + +=head1 BUGS + +Report any bugs discovered to the libvirt community via the mailing list +"http://libvirt.org/contact.html" or bug tracker "http://libvirt.org/bugs.html". +Alternatively report bugs to your software distributor / vendor. + +=head1 AUTHORS + +Please refer to the AUTHORS file distributed with libvirt. + +=head1 COPYRIGHT + +Copyright (C) 2011 Red Hat, Inc., and the authors listed in the +libvirt-snmp AUTHORS file. + +=head1 LICENSE + +libvirt-snmp is distributed under the terms of the GNU GPL v3. +This is free software; see the source for copying conditions. +There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE + +=head1 SEE ALSO +L<snmpd>, L<http://www.libvirt.org> + diff --git a/libvirt-snmp.spec.in b/libvirt-snmp.spec.in index 6082a7a..3a55503 100644 --- a/libvirt-snmp.spec.in +++ b/libvirt-snmp.spec.in @@ -6,7 +6,7 @@ Summary: SNMP functionality for libvirt Group: Development/Libraries License: GPLv3 URL: http://libvirt.org -Source0: libvirt-snmp-%{version}.tar.gz +Source0: http://www.libvirt.org/sources/snmp/libvirt-snmp-%{version}.tar.gz BuildRoot: %(mktemp -ud %{_tmppath}/%{name}-%{version}-%{release}-XXXXXX) BuildRequires: net-snmp-perl net-snmp net-snmp-utils net-snmp-devel libvirt-devel @@ -38,7 +38,7 @@ rm -rf $RPM_BUILD_ROOT %{_bindir}/libvirtMib_subagent %{_datadir}/snmp/mibs/LIBVIRT-MIB.txt %doc README NEWS ChangeLog AUTHORS - +%{_mandir}/man1/libvirtMib_subagent.1* %changelog -- 1.7.4

2 1

[libvirt] [libvirt-snmp][PATCH] Change source location in .spec file to the one from libvirt.org
by Michal Privoznik 02 Mar '11

02 Mar '11

--- I've created the snmp dir: http://www.libvirt.org/sources/snmp/ libvirt-snmp.spec.in | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/libvirt-snmp.spec.in b/libvirt-snmp.spec.in index 6082a7a..85c5025 100644 --- a/libvirt-snmp.spec.in +++ b/libvirt-snmp.spec.in @@ -6,7 +6,7 @@ Summary: SNMP functionality for libvirt Group: Development/Libraries License: GPLv3 URL: http://libvirt.org -Source0: libvirt-snmp-%{version}.tar.gz +Source0: http://libvirt.org/sources/snmp/libvirt-snmp-%{version}.tar.gz BuildRoot: %(mktemp -ud %{_tmppath}/%{name}-%{version}-%{release}-XXXXXX) BuildRequires: net-snmp-perl net-snmp net-snmp-utils net-snmp-devel libvirt-devel -- 1.7.4

2 1

[libvirt] [PATCH 1/2] qemu: add -incoming fd:n capability checking
by Eric Blake 02 Mar '11

02 Mar '11

* src/qemu/qemu_capabilities.h (QEMUD_CMD_FLAG_MIGRATE_QEMU_FD): New enum value. * src/qemu/qemu_capabilities.c (qemuCapsComputeCmdFlags): Populate flags according to qemu version. * tests/qemuhelptest.c (mymain): Adjust test. --- I feel a bit dirty relying on just a version test for whether -incoming fd:n is supported, but it's no different than the existing code for -incoming unix:path which was added about the same time. Unfortunately, 'qemu -help' doesn't list which particular protocols it supports for -incoming. src/qemu/qemu_capabilities.c | 6 +++++- src/qemu/qemu_capabilities.h | 1 + tests/qemuhelptest.c | 12 ++++++++---- 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/src/qemu/qemu_capabilities.c b/src/qemu/qemu_capabilities.c index 913fbf7..3d10b42 100644 --- a/src/qemu/qemu_capabilities.c +++ b/src/qemu/qemu_capabilities.c @@ -943,6 +943,8 @@ qemuCapsComputeCmdFlags(const char *help, * Handling of -incoming arg with varying features * -incoming tcp (kvm >= 79, qemu >= 0.10.0) * -incoming exec (kvm >= 80, qemu >= 0.10.0) + * -incoming unix (qemu >= 0.12.0) + * -incoming fd (qemu >= 0.12.0) * -incoming stdio (all earlier kvm) * * NB, there was a pre-kvm-79 'tcp' support, but it @@ -952,8 +954,10 @@ qemuCapsComputeCmdFlags(const char *help, if (version >= 10000) { flags |= QEMUD_CMD_FLAG_MIGRATE_QEMU_TCP; flags |= QEMUD_CMD_FLAG_MIGRATE_QEMU_EXEC; - if (version >= 12000) + if (version >= 12000) { flags |= QEMUD_CMD_FLAG_MIGRATE_QEMU_UNIX; + flags |= QEMUD_CMD_FLAG_MIGRATE_QEMU_FD; + } } else if (kvm_version >= 79) { flags |= QEMUD_CMD_FLAG_MIGRATE_QEMU_TCP; if (kvm_version >= 80) diff --git a/src/qemu/qemu_capabilities.h b/src/qemu/qemu_capabilities.h index 83afd9b..ee648f0 100644 --- a/src/qemu/qemu_capabilities.h +++ b/src/qemu/qemu_capabilities.h @@ -82,6 +82,7 @@ enum qemuCapsFlags { QEMUD_CMD_FLAG_VGA_QXL = (1LL << 45), /* The 'qxl' arg for '-vga' */ QEMUD_CMD_FLAG_SPICE = (1LL << 46), /* Is -spice avail */ QEMUD_CMD_FLAG_VGA_NONE = (1LL << 47), /* The 'none' arg for '-vga' */ + QEMUD_CMD_FLAG_MIGRATE_QEMU_FD = (1LL << 48), /* -incoming fd:n */ }; virCapsPtr qemuCapsInit(virCapsPtr old_caps); diff --git a/tests/qemuhelptest.c b/tests/qemuhelptest.c index 553abbc..18a71fa 100644 --- a/tests/qemuhelptest.c +++ b/tests/qemuhelptest.c @@ -286,7 +286,8 @@ mymain(int argc, char **argv) QEMUD_CMD_FLAG_BOOT_MENU | QEMUD_CMD_FLAG_NAME_PROCESS | QEMUD_CMD_FLAG_SMBIOS_TYPE | - QEMUD_CMD_FLAG_VGA_NONE, + QEMUD_CMD_FLAG_VGA_NONE | + QEMUD_CMD_FLAG_MIGRATE_QEMU_FD, 12001, 0, 0); DO_TEST("qemu-kvm-0.12.1.2-rhel60", QEMUD_CMD_FLAG_VNC_COLON | @@ -324,7 +325,8 @@ mymain(int argc, char **argv) QEMUD_CMD_FLAG_SMBIOS_TYPE | QEMUD_CMD_FLAG_VGA_QXL | QEMUD_CMD_FLAG_SPICE | - QEMUD_CMD_FLAG_VGA_NONE, + QEMUD_CMD_FLAG_VGA_NONE | + QEMUD_CMD_FLAG_MIGRATE_QEMU_FD, 12001, 1, 0); DO_TEST("qemu-kvm-0.12.3", QEMUD_CMD_FLAG_VNC_COLON | @@ -360,7 +362,8 @@ mymain(int argc, char **argv) QEMUD_CMD_FLAG_NESTING | QEMUD_CMD_FLAG_NAME_PROCESS | QEMUD_CMD_FLAG_SMBIOS_TYPE | - QEMUD_CMD_FLAG_VGA_NONE, + QEMUD_CMD_FLAG_VGA_NONE | + QEMUD_CMD_FLAG_MIGRATE_QEMU_FD, 12003, 1, 0); DO_TEST("qemu-kvm-0.13.0", QEMUD_CMD_FLAG_VNC_COLON | @@ -403,7 +406,8 @@ mymain(int argc, char **argv) QEMUD_CMD_FLAG_NAME_PROCESS | QEMUD_CMD_FLAG_SMBIOS_TYPE | QEMUD_CMD_FLAG_SPICE | - QEMUD_CMD_FLAG_VGA_NONE, + QEMUD_CMD_FLAG_VGA_NONE | + QEMUD_CMD_FLAG_MIGRATE_QEMU_FD, 13000, 1, 0); return ret == 0 ? EXIT_SUCCESS : EXIT_FAILURE; -- 1.7.3.3

4 15

[libvirt] there is a mistake in "libvirt development guide, chapter 4.1: list domains"
by SanitYey o 02 Mar '11

02 Mar '11

int i; int numDomains; char **inactiveDomains; numDomains = virConnectNumOfDefinedDomains(conn); inactiveDomains = malloc(sizeof(char *) * numDomains); numDomains = virConnectListDomains(conn, inactiveDomains, numDomains); printf("Inactive domain names:\n"); for (i = 0 ; i < numDomains ; i++) { printf(" %s\n", inactiveDomains[i]); free(inactiveDomains[i]); } free(inactiveDomains); Example 4.5. Listing inactive domains There should use "virConnectListDefinedDomains" for inactive domains.

2 1

[libvirt] [PATCH V3] Add libxenlight driver
by Jim Fehlig 28 Feb '11

28 Feb '11

Hi All, Another update to the libxenlight driver for Xen 4.1. The primary change in this version is reservation of vnc ports within the driver when autoport=yes. libxenlight does not provide a mechanism to retrieve the auto-selected port and the 'vncunused' option is not in upstream qemu anyhow, so best to avoid it. I've tested the following operations on both pv and hvm linux guests: define, undefine, start, create, shutdown, reboot, destroy, getinfo, and dumpxml. I've also done some minimal testing with virt-manager, e.g. starting a previously defined domain and connecting to its graphical console. Thanks for your review and comments. Regards, Jim

1 0