Bug 1062795

Summary: [Docs] [Install] Requirement to install rhevm-websocket-proxy not listed as an optional prerequisite of installation or upgrade to RHEV 3.3
Product: Red Hat Enterprise Virtualization Manager Reporter: Bryan Yount <byount>
Component: DocumentationAssignee: Andrew Dahms <adahms>
Status: CLOSED CURRENTRELEASE QA Contact: Lucy Bopf <lbopf>
Severity: urgent Docs Contact:
Priority: high    
Version: 3.3.0CC: acathrow, gchakkar, jcall, yeylon
Target Milestone: ---   
Target Release: 3.4.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1160310 (view as bug list) Environment:
Last Closed: 2014-07-24 06:45:03 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:
Bug Depends On:    
Bug Blocks: 1160310    

Description Bryan Yount 2014-02-08 02:01:51 UTC
Description of problem:
In the Installation Guide, the requirement to install "rhevm-websocket-proxy" prior to installation or upgrade of the engine is not listed in the Installation Section near the beginning of the document. This requirement is only listed in the Appendix B.7. Squid Proxy step 6 "Configure the websockets proxy".

The text from the appendix:
   "Make sure that the ovirt-engine-websocket-proxy package was installed prior to installing the engine, otherwise it won't be correctly configured."

**Please Note:** The above text references "ovirt-engine-websocket-proxy" which is not the correct name of the package. The package name is "rhevm-websocket-proxy".

Version-Release number of selected component (if applicable):
Revision 3.3-34

Customer question:
https://access.redhat.com/site/discussions/710853

Comment 5 Andrew Dahms 2014-02-13 23:43:48 UTC
Documentation Link
------------------------------
Configuring Red Hat Enterprise Virtualization Manager
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Red_Hat_Enterprise_Virtualization_Manager_Configuration_Overview

Squid Proxy
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#sect-Squid_Proxy

What Changed
------------------------------
The following topics were revised as outlined below:

Installing and Configuring a Squid Proxy [ 25669-588840 ]

The description of configuring a websocket proxy server as outlined in Step 6. was re-written.

Previously, this step mentioned that users must confirm that the rhevm-websocket-proxy package was installed prior to installing or upgrading RHEVM. However, upon investigation I discovered that this package is automatically included when installing RHEVM 33. Therefore, the issue is not ensuring that the package is installed, but rather that the websocket proxy server must be configured, and ideally during initial configuration of the Manager.

Because the script for configuring the Manager contains a formal step for configuring a websocket proxy server, this step has been re-written to tell users to do this.

Configuring Red Hat Enterprise Virtualization Manager [ 22200-588855 ]

Previously, the step for configuring a websocket proxy was included in another step. Now, it has been made into its own step - Step 8. - which provides information on why the websocket proxy server should be configured.

Updated revision history: [ 21134-588876 ]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Installation_Guide-3.3-en-US-3.3-36

Moving to ON_QA.

Comment 6 Andrew Dahms 2014-02-14 00:26:36 UTC
*** Bug 1039950 has been marked as a duplicate of this bug. ***

Comment 7 Andrew Dahms 2014-02-28 02:00:34 UTC
*** Bug 1037763 has been marked as a duplicate of this bug. ***

Comment 8 Andrew Dahms 2014-04-09 22:31:23 UTC
*** Bug 1085572 has been marked as a duplicate of this bug. ***

Comment 9 Lucy Bopf 2014-07-24 06:45:03 UTC
Peer reviewed.

The changes made to step 6 of the 'Configuring a Squid Proxy' procedure are accurate and live in the 3.3 docs.

Step 8 of the 'Manager Configuration Overview' procedure is present in the live 3.3 docs.

VERIFIED.