Re: [libvirt] Documentation for synchronous hooks
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@redhat.com> To: libvir-list@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@veillard.com | Rpmfind RPM search engine http://rpmfind.net/ http://veillard.com/ | virtualization library http://libvirt.org/ -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
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@veillard.com | Rpmfind RPM search engine http://rpmfind.net/ http://veillard.com/ | virtualization library http://libvirt.org/
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
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@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
-- ======================================================== Hugh Brock, hbrock@redhat.com, +1-215-564-3232 Deltacloud API + Portal http://deltacloud.org Libvirt virtualization library http://libvirt.org ========================================================
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@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
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:
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
On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote: scripts, then killall -HUP libvirtd it should rescan the directory and use the scripts if found.
Daniel
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
-- ======================================================== Hugh Brock, hbrock@redhat.com, +1-215-564-3232 Deltacloud API + Portal http://deltacloud.org Libvirt virtualization library http://libvirt.org ========================================================
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@redhat.com> To: "Osier Yang" <jyang@redhat.com> Cc: libvir-list@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:
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
On Mon, Apr 26, 2010 at 08:42:12PM -0400, Jintao Yang wrote: scripts, then killall -HUP libvirtd it should rescan the directory and use the scripts if found.
Daniel
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
-- ======================================================== Hugh Brock, hbrock@redhat.com, +1-215-564-3232 Deltacloud API + Portal http://deltacloud.org Libvirt virtualization library http://libvirt.org ========================================================
participants (5)
-
Daniel Veillard -
Hugh O. Brock -
Jintao Yang -
Osier
-
Osier Yang