Bug 1724535 - Parameter force_migrate of ovirt_vm module has wrong description
Summary: Parameter force_migrate of ovirt_vm module has wrong description
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: ansible
Version: 4.3.4
Hardware: Unspecified
OS: Unspecified
unspecified
low
Target Milestone: ovirt-4.3.5-1
: ---
Assignee: Martin Necas
QA Contact: Lucie Leistnerova
URL:
Whiteboard:
Depends On:
Blocks: 1733654
TreeView+ depends on / blocked
 
Reported: 2019-06-27 08:51 UTC by Jan Zmeskal
Modified: 2019-08-26 07:21 UTC (History)
5 users (show)

Fixed In Version: ansible-2.8.3
Doc Type: No Doc Update
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-08-26 07:21:20 UTC
oVirt Team: Infra
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Github ansible ansible pull 58577 0 None None None 2019-07-18 07:38:33 UTC
Github ansible ansible pull 58717 0 None None None 2019-07-19 14:27:56 UTC

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


Note You need to log in before you can comment on or make changes to this bug.