7:42 p.m.
hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are supported. but is it
took away in 0.8.0-4?
[root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
/etc/libvirt
/etc/libvirt/libvirtd.conf
/etc/libvirt/lxc.conf
/etc/libvirt/nwfilter
/etc/libvirt/nwfilter/allow-arp.xml
/etc/libvirt/nwfilter/allow-dhcp-server.xml
/etc/libvirt/nwfilter/allow-dhcp.xml
/etc/libvirt/nwfilter/allow-incoming-ipv4.xml
/etc/libvirt/nwfilter/allow-ipv4.xml
/etc/libvirt/nwfilter/clean-traffic.xml
/etc/libvirt/nwfilter/no-arp-spoofing.xml
/etc/libvirt/nwfilter/no-ip-multicast.xml
/etc/libvirt/nwfilter/no-ip-spoofing.xml
/etc/libvirt/nwfilter/no-mac-broadcast.xml
/etc/libvirt/nwfilter/no-mac-spoofing.xml
/etc/libvirt/nwfilter/no-other-l2-traffic.xml
/etc/libvirt/qemu
/etc/libvirt/qemu.conf
/etc/libvirt/qemu/networks
/etc/libvirt/qemu/networks/autostart
/etc/logrotate.d/libvirtd.lxc
/etc/logrotate.d/libvirtd.qemu
/etc/rc.d/init.d/libvirtd
/etc/sysconfig/libvirtd
[root@dhcp-66-70 libvirt]# rpm -q libvirt
libvirt-0.8.0-4.el6.x86_64
Regards
osier
----- Original Message -----
From: "Daniel Veillard" <veillard(a)redhat.com>
To: libvir-list(a)redhat.com
Sent: Monday, April 12, 2010 11:16:27 PM GMT +08:00 Beijing / Chongqing / Hong Kong /
Urumqi
Subject: [libvirt] Documentation for synchronous hooks
Was still missing from main commits and would be needed for 0.8.0
Add documentation for synchronous hooks
* docs/sitemap.html.in: add in navigation under
Documentation/Deployment/Hooks
* docs/hooks.html.in: new doc describing current support for 0.8.0
diff --git a/docs/hooks.html.in b/docs/hooks.html.in
new file mode 100644
index 0000000..4ebeec3
--- /dev/null
+++ b/docs/hooks.html.in
@@ -0,0 +1,71 @@
+<?xml version="1.0"?>
+<html>
+ <body>
+ <h1>Hooks for specific system management</h1>
+ <p>Libvirt includes synchronous hooks starting from version 0.8.0,
+ this is a way to tie specific tailored system actions at specific
+ time. This is based on scripts being called on the Host where the
+ hypervisor is running, if the script is present when the libvirtd
+ daemon is doing some significant actions.</p>
+ <p>The scripts are expected to execute quickly, return a zero exit
+ status if all conditions are set for the daemon to continue the
+ action (non zero will be considered a failure which may
+ be ignored but in general will stops the ongoing operation).
+ The script also should not call back into libvirt as the daemon
+ is waiting for the script exit and deadlock is likely to occur
+ otherwise.</p>
+ <p>The scripts are stored in the directory
<code>/etc/libvirt/hooks/</code>
+ when using a standard installation path
+ (<code>$SYSCONF_DIR/libvirt/hook/</code> in general).</p>
+ <p>The scripts gets arguments as parameter on their command line:</p>
+ <ul>
+ <li> the first argument is the name of the object involved in the
+ operation or '-' if there is none.
+ <li> the second argument is the name of the operation.
+ <li> the third argument is a suboperation indication like 'start'
+ 'end' or '-' if there is none.
+ <li> the last argument is an extra argument string or '-' if
there
+ is none.
+ </ul>
+ <p>There is currently scripts for 3 domains of operation:
+ <ul>
+ <li><p><code>/etc/libvirt/hooks/daemon</code> script if
+ present is called at 3 points in time:</p>
+ <p>at daemon startup, typically started with the following
+ arguments:</p>
+ <pre>/etc/libvirt/hooks/daemon - start - start</pre>
+ <p>at daemon shutdown when it is about to exit, with the following
+ arguments:</p>
+ <pre>/etc/libvirt/hooks/daemon - shutdown - shutdown</pre>
+ <p>When the daemon is asked to reload its driver state when
+ receiving the SIGHUP signal, arguments are:</p>
+ <pre>/etc/libvirt/hooks/daemon - reload begin SIGHUP</pre>
+ </li>
+ <li><p><code>/etc/libvirt/hooks/qemu</code> script and
<br/>
+ <code>/etc/libvirt/hooks/lxc</code> to associate hooks for
domain
+ operation on the respective QEmu/KVM and LXC drivers.</p>
+ <p> The domain related hooks also receive the full XML description
+ for the concerned domain on their stdin, which allows to get
+ all the informations from the domain, including UUID or storage
+ if that is needed for the script operation.</p>
+ <p> Currently only domain startup and domain end operations
+ involve the hook, the first one just before the domain gets
+ created.
+ For example if starting a QEmu domain named <code>test</code>
+ the following script will get called:</p>
+ <pre>/etc/libvirt/hooks/qemu test start begin -</pre>
+ <p> note that a non-zero return value from the script will abort the
+ domain startup operation, and if an error string is passed on
+ stderr by the hook script, it will be provided back to the user
+ at the libvirt API level.</p>
+ <p> For domain shutdown, the script will be called just after the
+ domain has finished execution, and the script will get:</p>
+ <pre>/etc/libvirt/hooks/qemu test stopped end -</pre>
+ <p> It is expected that other operation will be associated to hooks
+ but at the time of 0.8.0 only those 2 are associated to domains
+ lifecycle</p>
+ </li>
+ </ul>
+ <p></p>
+ </body>
+</html>
diff --git a/docs/sitemap.html.in b/docs/sitemap.html.in
index 0c3f0c3..0117c8d 100644
--- a/docs/sitemap.html.in
+++ b/docs/sitemap.html.in
@@ -50,6 +50,10 @@
<a href="logging.html">Logging</a>
<span>The library and the daemon logging support</span>
</li>
+ <li>
+ <a href="hooks.html">Hooks</a>
+ <span>Hooks for system specific management</span>
+ </li>
</ul>
</li>
<li>
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/
--
libvir-list mailing list
libvir-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
1:49 a.m.
New subject: [libvirt] Documentation for synchronous hooks
On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are
supported. but is it took away in 0.8.0-4?
[root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
/etc/libvirt
/etc/libvirt/libvirtd.conf
[...]
/etc/rc.d/init.d/libvirtd
/etc/sysconfig/libvirtd
[root@dhcp-66-70 libvirt]# rpm -q libvirt
libvirt-0.8.0-4.el6.x86_64
Hum, no, the support is there, but we don't create the /etc/directory
nor provide any example file. I should do that before 0.8.1, good point.
But the support is there, if you create the directory and add some
scripts, then killall -HUP libvirtd it should rescan the directory
and use the scripts if found.
Daniel
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/
9:43 p.m.
New subject: [libvirt] Documentation for synchronous hooks
still no /etc/libvirt/hooks and example hook scripts in 0.8.1-6.
anyone can provide some simple hook scripts? thanks
- Osier
Daniel Veillard wrote:
On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
> hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are supported. but
is it took away in 0.8.0-4?
>
> [root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
> /etc/libvirt
> /etc/libvirt/libvirtd.conf
>
[...]
> /etc/rc.d/init.d/libvirtd
> /etc/sysconfig/libvirtd
> [root@dhcp-66-70 libvirt]# rpm -q libvirt
> libvirt-0.8.0-4.el6.x86_64
>
Hum, no, the support is there, but we don't create the /etc/directory
nor provide any example file. I should do that before 0.8.1, good point.
But the support is there, if you create the directory and add some
scripts, then killall -HUP libvirtd it should rescan the directory
and use the scripts if found.
Daniel
7:27 a.m.
New subject: [libvirt] Documentation for synchronous hooks
On Tue, May 25, 2010 at 10:43:41AM +0800, Osier Yang wrote:
still no /etc/libvirt/hooks and example hook scripts in 0.8.1-6.
anyone can provide some simple hook scripts? thanks
- Osier
Osier, could you file a BZ for this to make sure we don't lose track
of it?
Thanks,
--Hugh
Daniel Veillard wrote:
>On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
>>hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are supported.
but is it took away in 0.8.0-4?
>>
>>[root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
>>/etc/libvirt
>>/etc/libvirt/libvirtd.conf
>[...]
>>/etc/rc.d/init.d/libvirtd
>>/etc/sysconfig/libvirtd
>>[root@dhcp-66-70 libvirt]# rpm -q libvirt
>>libvirt-0.8.0-4.el6.x86_64
>
> Hum, no, the support is there, but we don't create the /etc/directory
>nor provide any example file. I should do that before 0.8.1, good point.
>But the support is there, if you create the directory and add some
>scripts, then killall -HUP libvirtd it should rescan the directory
>and use the scripts if found.
>
>Daniel
>
--
libvir-list mailing list
libvir-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
--
========================================================
Hugh Brock, hbrock(a)redhat.com, +1-215-564-3232
Deltacloud API + Portal http://deltacloud.org
Libvirt virtualization library http://libvirt.org
========================================================
1:17 a.m.
New subject: [libvirt] Documentation for synchronous hooks
Hi Hugh
sorry, I just see this. Do we need a bug to track this problem any
more?
Thanks
Osier
Hugh O. Brock wrote:
On Tue, May 25, 2010 at 10:43:41AM +0800, Osier Yang wrote:
> still no /etc/libvirt/hooks and example hook scripts in 0.8.1-6.
> anyone can provide some simple hook scripts? thanks
>
> - Osier
>
Osier, could you file a BZ for this to make sure we don't lose track
of it?
Thanks,
--Hugh
> Daniel Veillard wrote:
>
>> On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
>>
>>> hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are
supported. but is it took away in 0.8.0-4?
>>>
>>> [root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
>>> /etc/libvirt
>>> /etc/libvirt/libvirtd.conf
>>>
>> [...]
>>
>>> /etc/rc.d/init.d/libvirtd
>>> /etc/sysconfig/libvirtd
>>> [root@dhcp-66-70 libvirt]# rpm -q libvirt
>>> libvirt-0.8.0-4.el6.x86_64
>>>
>> Hum, no, the support is there, but we don't create the /etc/directory
>> nor provide any example file. I should do that before 0.8.1, good point.
>> But the support is there, if you create the directory and add some
>> scripts, then killall -HUP libvirtd it should rescan the directory
>> and use the scripts if found.
>>
>> Daniel
>>
>>
> --
> libvir-list mailing list
> libvir-list(a)redhat.com
> https://www.redhat.com/mailman/listinfo/libvir-list
>
5:34 a.m.
New subject: [libvirt] Documentation for synchronous hooks
On Thu, Jul 01, 2010 at 02:17:10PM +0800, Osier Yang wrote:
Hi Hugh
sorry, I just see this. Do we need a bug to track this problem
any more?
Thanks
Osier
Hello Osier. If the condition still exists, yes, we definitely need a
BZ. Thanks for checking!
--Hugh
Hugh O. Brock wrote:
>On Tue, May 25, 2010 at 10:43:41AM +0800, Osier Yang wrote:
>>still no /etc/libvirt/hooks and example hook scripts in 0.8.1-6.
>>anyone can provide some simple hook scripts? thanks
>>
>>- Osier
>
>Osier, could you file a BZ for this to make sure we don't lose track
>of it?
>
>Thanks,
>--Hugh
>
>>Daniel Veillard wrote:
>>>On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
>>>>hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are
supported. but is it took away in 0.8.0-4?
>>>>
>>>>[root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
>>>>/etc/libvirt
>>>>/etc/libvirt/libvirtd.conf
>>>[...]
>>>>/etc/rc.d/init.d/libvirtd
>>>>/etc/sysconfig/libvirtd
>>>>[root@dhcp-66-70 libvirt]# rpm -q libvirt
>>>>libvirt-0.8.0-4.el6.x86_64
>>> Hum, no, the support is there, but we don't create the /etc/directory
>>>nor provide any example file. I should do that before 0.8.1, good point.
>>>But the support is there, if you create the directory and add some
>>>scripts, then killall -HUP libvirtd it should rescan the directory
>>>and use the scripts if found.
>>>
>>>Daniel
>>>
>>--
>>libvir-list mailing list
>>libvir-list(a)redhat.com
>>https://www.redhat.com/mailman/listinfo/libvir-list
>
--
libvir-list mailing list
libvir-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
--
========================================================
Hugh Brock, hbrock(a)redhat.com, +1-215-564-3232
Deltacloud API + Portal http://deltacloud.org
Libvirt virtualization library http://libvirt.org
========================================================
4:10 a.m.
New subject: [libvirt] Documentation for synchronous hooks
Hi Hugh
It seems that not provide the sample scripts and directory "/etc/libvirt/hooks"
is okay from the functional view, may be it's just not very kind for end-user. and I
communicated with DV, he said no need to file a bug agaist this.
Thanks
- Osier
----- Original Message -----
From: "Hugh O. Brock" <hbrock(a)redhat.com>
To: "Osier Yang" <jyang(a)redhat.com>
Cc: libvir-list(a)redhat.com
Sent: Thursday, July 1, 2010 6:34:20 PM GMT +08:00 Beijing / Chongqing / Hong Kong /
Urumqi
Subject: Re: [libvirt] Documentation for synchronous hooks
On Thu, Jul 01, 2010 at 02:17:10PM +0800, Osier Yang wrote:
Hi Hugh
sorry, I just see this. Do we need a bug to track this problem
any more?
Thanks
Osier
Hello Osier. If the condition still exists, yes, we definitely need a
BZ. Thanks for checking!
--Hugh
Hugh O. Brock wrote:
>On Tue, May 25, 2010 at 10:43:41AM +0800, Osier Yang wrote:
>>still no /etc/libvirt/hooks and example hook scripts in 0.8.1-6.
>>anyone can provide some simple hook scripts? thanks
>>
>>- Osier
>
>Osier, could you file a BZ for this to make sure we don't lose track
>of it?
>
>Thanks,
>--Hugh
>
>>Daniel Veillard wrote:
>>>On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote:
>>>>hi DV, I saw the changelog of 0.7.8, which told the hooks scripts are
supported. but is it took away in 0.8.0-4?
>>>>
>>>>[root@dhcp-66-70 libvirt]# rpm -ql libvirt | grep etc
>>>>/etc/libvirt
>>>>/etc/libvirt/libvirtd.conf
>>>[...]
>>>>/etc/rc.d/init.d/libvirtd
>>>>/etc/sysconfig/libvirtd
>>>>[root@dhcp-66-70 libvirt]# rpm -q libvirt
>>>>libvirt-0.8.0-4.el6.x86_64
>>> Hum, no, the support is there, but we don't create the /etc/directory
>>>nor provide any example file. I should do that before 0.8.1, good point.
>>>But the support is there, if you create the directory and add some
>>>scripts, then killall -HUP libvirtd it should rescan the directory
>>>and use the scripts if found.
>>>
>>>Daniel
>>>
>>--
>>libvir-list mailing list
>>libvir-list(a)redhat.com
>>https://www.redhat.com/mailman/listinfo/libvir-list
>
--
libvir-list mailing list
libvir-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
--
========================================================
Hugh Brock, hbrock(a)redhat.com, +1-215-564-3232
Deltacloud API + Portal http://deltacloud.org
Libvirt virtualization library http://libvirt.org
========================================================
5256
days inactive
5322
days old
6 comments
5 participants
participants (5)
-
Daniel Veillard -
Hugh O. Brock -
Jintao Yang -
Osier
-
Osier Yang