Bug 1401708

Summary:	[Docs][Install] Add a note at the end of installation procedures advising users to keep environments up to date for best performance
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Marina Kalinin <mkalinin>
Component:	Documentation	Assignee:	Emma Heftman <eheftman>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	high	Docs Contact:
Priority:	medium
Version:	3.6.9	CC:	lbopf, lsurette, mgoldboi, mkalinin, rbalakri, srevivo, ykaul, ylavi
Target Milestone:	ovirt-4.1.2
Target Release:	---
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:	2017-05-25 14:11:06 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 Marina Kalinin 2016-12-05 22:22:23 UTC

We should add a section to the Upgrade Guide (or Admin Guide), that as a recommended practice, RHV System Administrator should keep the environments up-to-date. Since bug fixes to known issues are being pushed frequently, it is recommended to have scheduled upgrade tasks for hosts and the managers and not to wait till new minor upgrade.
Or something between those lines.

Maybe PM team can review the syntax.

Possible location for this :
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/upgrade-guide/chapter-2-updates-between-minor-releases

Comment 1 Marina Kalinin 2016-12-05 22:23:43 UTC

Yaniv / Moran,
Can you please review?

Comment 2 Yaniv Lavi 2016-12-06 13:02:12 UTC

This seems like a unneeded comment. It's clear that user should do this as best practice. I don't see a point in mentioning it.

Comment 4 Marina Kalinin 2016-12-07 19:46:20 UTC

Discussing this with the team today, this definitely should be added to the documentation.

Comment 6 Lucy Bopf 2017-05-12 06:23:28 UTC

Assigning to Emma for review.

Emma, this should be a simple addition to the Installation Guide, perhaps after Manager and host installation procedures. To lower future maintenance, we could point users to our new upgrade/update article for more info: https://access.redhat.com/articles/2974891

Comment 9 Emma Heftman 2017-05-25 14:11:06 UTC

The documentation is available on the Customer Portal:

Administration Guide:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/#sect-Host_Tasks

Installation Guide:
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/installation_guide/#Connecting_to_the_Administration_Portal