Bug 1317513

Summary:	[Docs] [Admin] Address feedback for SPICE Log Files
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Zac Dover <zdover>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.6.0	CC:	astepano, gklein, lbopf, lsurette, rbalakri, srevivo, uril, ylavi, zdover
Target Milestone:	ovirt-4.0.4
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-01-11 05:57:31 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:

Description Lucy Bopf 2016-03-14 12:39:50 UTC

The following items must be addressed in Section 17.3, 'SPICE Log Files':

* In 'Table 17.3. SPICE Logs for Hypervisor SPICE Servers', make it clearer where the user should run 'export SPICE_DEBUG_LEVEL=5'. This variable is parsed by spice-server(qemu). If we make it system-wide all VMs will print debug info. Moreover, if cluster has a few hosts/hypervisors, it is necessary repeat on each host system.

* In 'Table 17.5. SPICE Logs for Client Machines (Browser Plug-ins)', remove "/home" from "~/home/.spicec/spice-xpi.log" (because '~' means home)

* Remove entry for 'USB Redirector on Windows Client' from Table 17.5.

* Update the description for Step 2 of '17.3.4. SPICE Logs for SPICE Clients Launched Using console.vv Files' (for Linux machines). The command shown does not show you to view logs, but how to run SPICE client (remote-viewer) with the debug parameter from the command line, accepting a .vv file (compared to Step 1 where it connects using a spice://host:port).

* In '17.3.4 SPICE Logs for SPICE Clients Launched Using console.vv Files', consider adding that when run from spice-xpi, by default, remote-client log messages go to /var/log/messages (see /usr/libexec/spice-xpi-client-remote-viewer).

* `Download the debug-helper.exe file' - clarify where this file comes from.

* Verify that the log file locations in '17.4. Red Hat Enterprise Virtualization Host Log Files' are correct. No such log files when tested against vdsm-4.17.14-0.el7ev.noarch.

Feedback provided by: Uri Lublin <ulublin> and Andrei Stepanov <astepano>

Comment 3 Lucy Bopf 2016-09-05 02:05:34 UTC

*** Bug 1372689 has been marked as a duplicate of this bug. ***

Comment 9 Zac Dover 2016-10-18 07:04:00 UTC

https://bugzilla.redhat.com/show_bug.cgi?id=1386096