Bug 1062795 - [Docs] [Install] Requirement to install rhevm-websocket-proxy not listed as an optional prerequisite of installation or upgrade to RHEV 3.3
Summary: [Docs] [Install] Requirement to install rhevm-websocket-proxy not listed as a...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 3.3.0
Hardware: Unspecified
OS: Unspecified
high
urgent
Target Milestone: ---
: 3.4.0
Assignee: Andrew Dahms
QA Contact: Lucy Bopf
URL:
Whiteboard:
: 1037763 1039950 1085572 (view as bug list)
Depends On:
Blocks: 1160310
TreeView+ depends on / blocked
 
Reported: 2014-02-08 02:01 UTC by Bryan Yount
Modified: 2019-08-15 03:48 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 1160310 (view as bug list)
Environment:
Last Closed: 2014-07-24 06:45:03 UTC
oVirt Team: ---
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Knowledge Base (Solution) 718653 0 None None None Never

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.


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