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

Bug 1075253

Summary: [Docs] [Admin] "Figure 4.3. Optimization Settings" shows old dialog.
Product: Red Hat Enterprise Virtualization Manager Reporter: Stephen Gordon <sgordon>
Component: DocumentationAssignee: Lucy Bopf <lbopf>
Status: CLOSED CURRENTRELEASE QA Contact: Tahlia Richardson <trichard>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.3.0CC: acathrow, gklein, juwu, lbopf, trichard, yeylon
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 13109, Administration Guide-3.3-1 Build Date: 09-01-2014 15:36:24 Topic ID: 7371-563514 [Latest]
Last Closed: 2014-07-25 04:49:05 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Stephen Gordon 2014-03-11 21:34:10 UTC
Title: Optimization Settings Explained

Describe the issue:

"Figure 4.3. Optimization Settings" shows a dialog with three tabs:

General
Memory Optimization
Resilience Policy

The selected tab "Memory Optimization" has one set of radio buttons ("None", "For Server Load", and "For Desktop Load").

This appears to be an old version of RHEV, and in fact even the text refers to new options not in the screenshot.

In RHEV 3.3 the available tabs on this screen are:

* General
* Optimization
* Resilience Policy
* Cluster Policy

All of the options listed in the table appear to be in the Optimization tab, and sections for the other tabs appear to be in the guide. Two of the options discussed don't appear in the screenshot at all and the one that is there has different text to that used on the screen in 3.3.

Suggestions for improvement:

Update screenshot to match RHEV 3.3.

Comment 1 Lucy Bopf 2014-04-09 05:04:31 UTC
This bug turned out to be much more than just the issues listed. Topics in the Admin Guide related to the New/Edit Cluster window were all missing components that appear in RHEV 3.4.

Two elements of this rewrite are in other bugs (which I have also addressed):
BZ#1075534 - Even VM Distribution feature
BZ#1075538 - High-Availability VM Reservation feature 

Two elements were not listed as bugs, but did not appear anywhere in documentation:
Console tab of New Cluster window: Info at http://www.ovirt.org/Features/Display_Address_Override. The same tab appears in the New Host window, and is documented in the Admin Guide. I have added a topic in the Clusters section using similar information as in Host Console Settings. I have updated the Creating a New Cluster procedure of the Install Guide to include this tab option.

Scheduler Optimization: These options appear in the Cluster Policy window, but are undocumented. I have copied and pasted information on these features from the context-sensitive help in the Cluster Policy tab of New Cluster window.

Screen shots of the New Cluster window General tab and the New Cluster window Cluster Policy tab have been updated.

Comment 2 Lucy Bopf 2014-04-24 01:40:50 UTC
Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Administration_Guide/index.html#Cluster_properties

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Administration_Guide/index.html#Moving_a_host_into_maintenance_mode (This is the actual link for the Optimization Settings section)

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Administration_Guide/index.html#Creating_a_New_Cluster

What Changed
------------------------------
The following topics were revised to reflect the actual display and options in the New/Edit Cluster window, including previously undocumented tabs.

General Cluster Settings Explained [ 7911-627975 ]

Optimization Settings Explained [ 7371-627980 ]

Creating a New Cluster [ 7624-629335 ]

Updated revision history: [ 30102-628857 ]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Administration_Guide-3.4-web-en-US-3.4-19.el6eng

Moving to ON_QA.

Comment 3 Tahlia Richardson 2014-07-25 04:49:05 UTC
Peer reviewed.

Listed changes are visible in the doc.

VERIFIED