[libvirt-users] Update of libvirt website required. not all information about XML tags

The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266 Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any. -- Segmentation fault

The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date. Jirka

2010/5/19 Jiri Denemark <jdenemar@redhat.com>:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date. http://berrange.com/posts/2010/02/15/guest-cpu-model-configuration-in-libvir...
Jirka
-- Segmentation fault

2010/5/19 Марк Коренберг <socketpair@gmail.com>:
2010/5/19 Jiri Denemark <jdenemar@redhat.com>:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date. http://berrange.com/posts/2010/02/15/guest-cpu-model-configuration-in-libvir...
anybody home ?

The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date. http://berrange.com/posts/2010/02/15/guest-cpu-model-configuration-in-libvir...
anybody home ?
Hmm, what would you like to hear? You haven't answered my question about what part of cpu tag is not described in libvirt documentation. Please, be more specific in what you miss in XML format description for the cpu tag. To the best of my knowledge, semantics of all subelements/attributes and their combinations is explained there. The URL you pasted as a reply is a step-by-step guide for using the cpu selection feature, which is not something that should be included in a description of domain XML format. I'm not talking about hard drive configuration since I'm not familiar with all the aspects of it. Someone else would need to complete the documentation there if it's incomplete. Jirka

2010/5/21 Jiri Denemark <jdenemar@redhat.com>:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like <serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date. http://berrange.com/posts/2010/02/15/guest-cpu-model-configuration-in-libvir...
anybody home ?
Hmm, what would you like to hear? You haven't answered my question about what part of cpu tag is not described in libvirt documentation. Please, be more specific in what you miss in XML format description for the cpu tag.
To the best of my knowledge, semantics of all subelements/attributes and their combinations is explained there. The URL you pasted as a reply is a step-by-step guide for using the cpu selection feature, which is not something that should be included in a description of domain XML format. Why not? I think, that all possible XML tags should be specified in documentation... I mean this: It should be full documentation of XML structure of config file where I may look for reference. Now documentation on libvirt site is not complete. I don't know where to read complete manual about XML tags, used in libvirt.
I'm not talking about hard drive configuration since I'm not familiar with all the aspects of it. Someone else would need to complete the documentation there if it's incomplete.
Ok. I understand. Will wait for somebody who able to change HDD XML documentation.

On 5/19/2010 5:49 AM, Jiri Denemark wrote:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like<serial>xxxx</serial> for hard drive and all cpu tags, other if any.
What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date.
Where does he ask anything about elementsCPU? He asked about disk mount options. I have struggled myself to find where some things are documented which I see in various example configs but do not see documented anywhere. Even the initial post to the list that introduces the new features merely supplied a sample config that used options that were not documented. For instance: https://lists.linux-foundation.org/pipermail/containers/2008-September/01323... And: http://libvirt.org/drvlxc.html Both provide sample configs full of options that I do not know where they are documented, what other options are valid in concert with the LXC driver. For instance: All sample configs above include, <disk type='mount'> But the seemingly most logical place to look: http://libvirt.org/formatstorage.html doesn't describe anything like that whole section of xml. Getting past that I manage to find this: http://libvirt.org/formatdomain.html#elementsDisks But that states that: The type attribute is either "file" or "block" So where is <disk type='mount'> documented? This: <os> <type>exe</type> <init>/sbin/init</init> </os> Appears to be documented here: http://libvirt.org/formatdomain.html#elementsOS But that does not mention exe being valid for the type tag, and does not mention the init tag as even existing at all. This is not a complete list of missing documentation. It's hard to say what's missing since, how can I know that something is missing unless I happen to see it mentioned in a sample config somewhere? Most of the sample configs are deliberately minimalistic so that they can provide a known working reference starting point thats as simple as possible, but that means that by definition they do not mention many things. One thing I did see documented somewhere was that if the init tag is omitted then it defaults to /sbin/init. This appears to be untrue at least for 0.8.1 on openSUSE 11.2 x86_64 I also in general failed to find enough documentation to actually run a full OS in an LXC container using virsh and libvirt on openSUSE. I have been running many containers successfully using lxc-tools. In fact I wrote http://en.opensuse.org/LXC and the init scripts in http://download.opensuse.org/repositories/home:/aljex/openSUSE_11.2/src/lxc-... so I think I do have at least a basic handle on using containers and have overcome many of the special problems that come with simply using virtualization at all, and containers in particular, and on openSUSE specifically. However, trying to use libvirt in the same environment I got as far as being able to run /bin/sh but I couldn't get /proc, /sys, /dev working right. Some problems may have been distribution-specific. For instance, when running /bin/bash (instead of /sbin/init), and from there trying to use yast (opensuse-specific admin tool), yast would crash, claiming that /dev was not mounted. Well I don't know why it would say that, and being an opensuse-specific tool it sure doesn't sound like a libvirt problem, or at least libvirt doesn't seem to be the first place to look for help. I mean, other apps worked. bash itself worked. From that bash shell, midnight commander worked. Just yast didn't. Which is why I didn't ask anything about that here. However on the other hand, I have no problem doing the same thing using lxc-start or lxc-exec running just /bin/bash instead of init, or init. So if yast works fine in lxc-start, then what can I fix or diagnose in yast? I couldn't run a full system because I couldn't get the console tty to work from init (even though bash worked fine), nor could I get the network device working, so I had no way to actually access the container although virsh and ps showed that at least init was running. I'm not yet done trying everything within my power, which is why I hadn't said anything here yet. My point is not to complain about not getting libvirt to work, I'm still putting in the learning time that I fully expected to have to put in before I expected to do anything useful. I do not like to have my time wasted by people who are not willing to spend any of their own, so I try not to ask that of others either. My point is just that, as long as someone else happened to say the same thing I was thinking anyways, to very strongly second the OP's request for more and better documentation. I don't need very much hand holding, I just need at least some sort of reference for everything. What options are available or valid, and what do they do? Ramifications and implications that are not completely specific to libvirt I am happy to work out myself, and maybe help write the more hand-holdy docs in the wiki at some point later. -- bkw

On 19/05/10 13:00, Brian K. White wrote:
On 5/19/2010 5:49 AM, Jiri Denemark wrote:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like<serial>xxxx</serial> for hard drive and all cpu tags, other if any. What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date.
Where does he ask anything about elementsCPU?
When he said "and all cpu tags"? Tom -- Tom Hughes (tom@compton.nu) http://compton.nu/

On 5/19/2010 8:30 AM, Tom Hughes wrote:
On 19/05/10 13:00, Brian K. White wrote:
On 5/19/2010 5:49 AM, Jiri Denemark wrote:
The problem desribed here: https://bugzilla.redhat.com/show_bug.cgi?id=593266
Please update http://www.libvirt.org/formatdomain.html and describe NEW xml tags, like<serial>xxxx</serial> for hard drive and all cpu tags, other if any. What cpu tag are you missing from the documentation? The description at http://www.libvirt.org/formatdomain.html#elementsCPU is complete and up-to-date.
Where does he ask anything about elementsCPU?
When he said "and all cpu tags"?
*headsmack* thanks, sorry. :) -- bkw
participants (4)
-
Brian K. White
-
Jiri Denemark
-
Tom Hughes
-
Марк Коренберг