Bug 1184340

Summary: [Doc] Investigate removing 11.1. Using the QEMU guest virtual machine agent section
Product: Red Hat Enterprise Linux 7 Reporter: Dayle Parker <dayleparker>
Component: doc-Virtualization_Deployment_and_Administration_GuideAssignee: Platform Virt Docs <virt-docs>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: unspecified Docs Contact:
Priority: medium    
Version: 7.1CC: eblake, jherrman
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-12-20 08:39:33 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1286552    

Comment 5 Eric Blake 2015-10-29 22:05:27 UTC
From 11.2:

> However, there are the following limitations with regards to isa-serial/virtio-serial transport:
> 
>     The qemu-guest-agent cannot detect whether or not a client has connected to the channel.

As far as I can tell, this sentence should remain - the guest does not know if someone in the host is listening to the channel.

>     There is no way for a client to detect whether or not qemu-guest-agent has disconnected or reconnected to the back-end.

This sentence can be dropped.  Libvirt can now tell if qemu-guest-agent has the channel opened, and recognizes when the guest drops and then reconnects over a qemu-guest-agent restart.  Libvirt is able to intelligently quit attempting guest agent commands if the guest agent is not connected.

>     If the virtio-serial device resets and qemu-guest-agent has not connected to the channel (generally caused by a reboot or hotplug), data from the client will be dropped.

This is still true.  But not very consequential - since libvirt knows when the agent is connected, it is not going to send data before that point. So you can drop the sentence.

>     If qemu-guest-agent has connected to the channel following a virtio-serial device reset, data from the client will be queued (and eventually throttled if available buffers are exhausted), regardless of whether or not qemu-guest-agent is still running or connected.

Again, still true but not very consequential, so you can drop the sentence.

Comment 15 Laura Novich 2015-12-14 20:17:09 UTC
Thanks Eric for your input
Moving to Verified
Laura

Comment 16 Laura Novich 2015-12-20 08:39:33 UTC
Published on December 17 version 2-24

Comment 17 Laura Novich 2015-12-20 08:42:43 UTC
Published on December 17 version 2-24