Bug 1255223

Summary:	[Docs] [Beta] [Admin] New live migration features
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Andrew Dahms <adahms>
Component:	Documentation	Assignee:	Lucy Bopf <lbopf>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	3.6.0	CC:	adahms, ecohen, gklein, ipinto, lbopf, lsurette, rbalakri, tjelinek, yeylon
Target Milestone:	ovirt-3.6.0-rc	Flags:	adahms: Triaged+
Target Release:	3.6.0
Hardware:	Unspecified
OS:	Unspecified
URL:	http://www.ovirt.org/Features/XBZRLE_and_Auto-Convergence
Whiteboard:	docs
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-11-24 01:40:35 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:
Bug Depends On:	867453, 1109154
Bug Blocks:	1265080

Description Andrew Dahms 2015-08-20 03:17:32 UTC

Users can now enable two new live migration features for virtual machines. While this does not affect users much directly, there is an option to set this using the engine-config command that should be called out in the documentation.

The command is the following -

 engine-config -s (DefaultAutoConvergence|DefaultMigrationCompression)=(true|false) 

A good way to tackle this bug might be to add a short note or two about the two new features to the section on live migration in the Admin Guide and tell users how to run the above to turn this feature on. 

Note: After running the above, users must restart the ovirt-engine service for the change to take effect.

Comment 1 Andrew Dahms 2015-08-24 05:00:35 UTC

Assigning to Lucy for review.

Comment 5 Israel Pinto 2015-11-11 10:03:39 UTC

I am missing:
1. Configure form engine CLI:
engine-config -s (DefaultAutoConvergence|DefaultMigrationCompression)=(true|false) 
     
2. VM option in host tab --> Migration Options: 
    Auto Converge migrations
    Enable migration compression

3. The links below don't work:
Links:
http://docbuilder.usersys.redhat.com/23128/#Virtual_Machine_Host_settings_explained
http://docbuilder.usersys.redhat.com/23128/#Optimizing_Live_Migration

Comment 6 Lucy Bopf 2015-11-11 23:56:51 UTC

Hi Israel,

After this bug was completed, content related to virtual machines was moved to a new Virtual Machine Management Guide, including those topics you mention above. The updated links are here:

http://docbuilder.usersys.redhat.com/23141/#Virtual_Machine_Host_settings_explained

http://docbuilder.usersys.redhat.com/23141/#Optimizing_Live_Migration


Kind Regards,

Lucy

Comment 7 Tomas Jelinek 2015-11-12 12:54:24 UTC

Only one note:

"The VDSM default value is 0." sounds like the default value is 0. Actually if you type 0 it means "use VDSM default". So I would rephrase it to: "0 means to use the VDSM default".

Comment 8 Israel Pinto 2015-11-12 14:42:24 UTC

I read the:

http://docbuilder.usersys.redhat.com/23141/#Virtual_Machine_Host_settings_explained

http://docbuilder.usersys.redhat.com/23141/#Optimizing_Live_Migration

and the give all the info needed

Comment 9 Lucy Bopf 2015-11-24 01:40:35 UTC

(In reply to Tomas Jelinek from comment #7)
> Only one note:
> 
> "The VDSM default value is 0." sounds like the default value is 0. Actually
> if you type 0 it means "use VDSM default". So I would rephrase it to: "0
> means to use the VDSM default".

Thank you, Tomas, for the correction and explanation. I've updated that sentence now. The change will appear when the guides are republished. Since the content for this bug has been verified and published, I will now close this bug.

The live migration content is available at the following links:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6-Beta/html-single/Administration_Guide/index.html#Cluster_general_entities
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6-Beta/html-single/Virtual_Machine_Management_Guide/index.html#Virtual_Machine_Host_settings_explained
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6-Beta/html-single/Virtual_Machine_Management_Guide/index.html#Optimizing_Live_Migration