Bug 1448491

Summary: Need to document right-click context menu (and power-off function)
Product: [oVirt] ovirt-engine Reporter: Derek Atkins <warlord>
Component: DocumentationAssignee: Eli Marcus <emarcus>
Status: CLOSED CURRENTRELEASE QA Contact: Steve Goodman <sgoodman>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 4.2.0CC: adahms, bugs, emarcus, sgoodman, warlord, ylavi
Target Milestone: ---Keywords: Reopened
Target Release: ---Flags: warlord: needinfo-
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: 2021-01-31 21:19:27 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:

Description Derek Atkins 2017-05-05 14:42:04 UTC
Description of problem:

I was trying to force power-off a VM.  There's the "Shutdown" button on the VM tab, but no indication of additional functionality.  There's no documentation that indicates the existence of the right-click context menu where one can find power off.

Version-Release number of selected component (if applicable):

4.0.6

How reproducible:

100%   Go to the VM tab.  There is no "power off" button.
Google for "ovirt power off" and nothing comes up to indicate the right-click context menu.

Steps to Reproduce:
1. See above
2.
3.

Actual results:

I couldn't shutdown my VM

Expected results:

power off function location should be documented

Additional info:

Comment 1 Yaniv Lavi 2017-05-16 07:59:27 UTC
Isn't this covered in any feature page?

Comment 2 Derek Atkins 2017-05-16 14:59:00 UTC
(In reply to Yaniv Dary from comment #1)
> Isn't this covered in any feature page?

None that I've found.  Google certainly didn't bring up anything when I was trying to determine how to "Power Off" a VM.  If it had I would not have filed this report.

Moreover, it was suggested on ovirt users that I submit this report.

Thanks

Comment 3 Andrew Dahms 2017-05-23 03:25:46 UTC
Hi Derek,

Thank you for raising this bug.

Andrew from Red Hat documentation here. I used to write some of the documentation for RHV, and while I am not as closely connected with the oVirt and RHV documentation these days, I saw this bug come up, and wanted to jump in and comment.

First, are you looking for some content in the oVirt documentation itself?

If so, there is a procedure that you can follow here -

http://www.ovirt.org/documentation/vmm-guide/chap-Administrative_Tasks/#shutting-down-a-virtual-machine

This is a procedure about shutting down virtual machines rather than using the right-click context menu itself, but it does contain a note about this functionality, and there are several other procedures that provide some details as well.

Does this provide enough detail?

Kind regards,

Andrew

Comment 4 Derek Atkins 2017-05-23 14:51:25 UTC
(In reply to Andrew Dahms from comment #3)

> First, are you looking for some content in the oVirt documentation itself?
>
> If so, there is a procedure that you can follow here -
> 
> http://www.ovirt.org/documentation/vmm-guide/chap-Administrative_Tasks/
> #shutting-down-a-virtual-machine

Thank you.  This page did not come up on google searches..

> This is a procedure about shutting down virtual machines rather than using
> the right-click context menu itself, but it does contain a note about this
> functionality, and there are several other procedures that provide some
> details as well.
> 
> Does this provide enough detail?

Well, it DOES (obliquely) mention the right click context menu.  However nowhere on the page does it mention "power off".  I would recommend this page get a small update saying:

  If the Shutdown fails (e.g. the VM is hung and not responding to the soft shutdown request) then you can force power-off the VM by right clicking the Virtual Machine and using the Power Off method in the menu.
 
> Kind regards,
> 
> Andrew

Thanks!

Comment 5 Yaniv Lavi 2017-06-13 07:21:57 UTC
Can you open a ticket on the ovirt site to fix this?
https://github.com/oVirt/ovirt-site/

Comment 6 Derek Atkins 2019-11-04 15:07:52 UTC
Done.  https://github.com/oVirt/ovirt-site/issues/2132

Comment 10 Sandro Bonazzola 2021-01-29 15:53:01 UTC
Is this going to be published before 4.4.5 GA? If so, can you please target this to 4.4.4?