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

Bug 1724535

Summary:	Parameter force_migrate of ovirt_vm module has wrong description
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Jan Zmeskal <jzmeskal>
Component:	ansible	Assignee:	Martin Necas <mnecas>
Status:	CLOSED ERRATA	QA Contact:	Lucie Leistnerova <lleistne>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	4.3.4	CC:	lsurette, mgoldboi, mperina, srevivo, tburke
Target Milestone:	ovirt-4.3.5-1	Keywords:	Documentation, ZStream
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	ansible-2.8.3	Doc Type:	No Doc Update
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-08-26 07:21:20 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Infra	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1733654

Description Jan Zmeskal 2019-06-27 08:51:54 UTC

Description of problem:
ovirt_vm module documentation says about force_migrate this:
If true, the VM will migrate even if it is defined as non-migratable.

However, according to Andrej Krejcir:
This is intended. There are 3 migration modes:
- Automatic migration allowed - It is possible to migrate the VM by a script with force_migrate=no
- Manual migration only - The force_migrate has to be 'yes'.
- Migration not allowed - This mode can be useful for example when the VM uses pass-through of host devices.
It looks like a documentation bug.

See here: https://bugzilla.redhat.com/show_bug.cgi?id=1721222#c4

If this is indeed the case, the documentation at https://docs.ansible.com/ansible/latest/modules/ovirt_vm_module.html should be changed.

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

How reproducible:
100 %

Comment 1 Martin Perina 2019-06-27 11:10:57 UTC

Moving to Ansible component, because Ansible module documentation is available only in upstream Ansible doc.

Comment 2 Sandro Bonazzola 2019-07-30 07:37:44 UTC

ansible-2.8.3 has been released, please check this bug is fixed there.

Comment 3 Jan Zmeskal 2019-08-01 10:20:52 UTC

Verified on: 
ansible-2.8.3-1.el7ae.noarch

Verification steps:
1. ansible-doc ovirt_vm | grep -A 5 "force_migrate"

Comment 5 Sandro Bonazzola 2019-08-26 07:21:20 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2019:1935