Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1425314

Summary: [Docs][RFE][VMM] Document support for hooks in the guest agent
Product: Red Hat Enterprise Virtualization Manager Reporter: Lucy Bopf <lbopf>
Component: DocumentationAssignee: Avital Pinnick <apinnick>
Status: CLOSED CURRENTRELEASE QA Contact: Tahlia Richardson <trichard>
Severity: unspecified Docs Contact:
Priority: medium    
Version: 4.0.0CC: lsurette, rbalakri, srevivo, vfeenstr, ykaul, ylavi
Target Milestone: ovirt-4.1.6Keywords: FutureFeature
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-09-13 05:10:25 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Docs RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1287544, 1298120    
Bug Blocks:    

Description Lucy Bopf 2017-02-21 07:44:51 UTC 
With this update, the ability to trigger activity inside of a virtual guest during live migration has been added. Examples of events that can be used as a trigger are before migration, after migration, before hibernation, or after hibernation. 

The hooks configuration base directory is located in the /etc/ovirt-guest-agent/hooks.d directory on Linux systems and in Red Hat Virtualization Agent directory on Windows systems. Each event has a corresponding subdirectory and all files or symlinks in that directory will be executed. The executing user on Linux systems is 'ovirtagent'. If the script needs root permissions, the elevation must be executed by the creator of the hook script. The executing user on Windows systems is the System Service user.

This functionality should be called out in the documentation.
Comment 1 Lucy Bopf 2017-08-11 06:59:12 UTC 
Assigning to Avital for review.
Comment 7 Avital Pinnick 2017-09-13 05:10:25 UTC 
Updated documents:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html-single/virtual_machine_management_guide/

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/virtual_machine_management_guide/