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

Bug 1213615

Summary:	[Docs] [Technical] Tech Guide Chapter C in appendix about certificates is not clear
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Marina Kalinin <mkalinin>
Component:	Documentation	Assignee:	Lucy Bopf <lbopf>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Andrew Burden <aburden>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	3.5.0	CC:	adahms, alonbl, ecohen, gklein, lsurette, mkalinin, rbalakri, yeylon
Target Milestone:	---
Target Release:	3.5.3
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-08-04 03:59:33 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:	902971, 1227301

Description Marina Kalinin 2015-04-20 22:19:28 UTC

Tech Guide Chapter C in appendix about certificates is not clear:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5/html-single/Technical_Guide/index.html#appe-Certificates

It seems like it has plenty of useful information, but not really clear how and why would I apply that information to RHEV. 

Can we update it with a purpose of that procedure and reasoning / warning, as for when exactly we would need to run it.

Also, does it have any relation to this procedure?
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5/html-single/Administration_Guide/index.html#Replacing_the_SSL_certificate_used_by_Red_Hat_Enterprise_Virtualization_Manager_to_identify_itself_to_users_connecting_over_https

If so, please specify.

Comment 2 Alon Bar-Lev 2015-04-21 06:25:44 UTC

(In reply to Marina from comment #0)
> Tech Guide Chapter C in appendix about certificates is not clear:
> https://access.redhat.com/documentation/en-US/
> Red_Hat_Enterprise_Virtualization/3.5/html-single/Technical_Guide/index.
> html#appe-Certificates
> 
> It seems like it has plenty of useful information, but not really clear how
> and why would I apply that information to RHEV. 
> 
> Can we update it with a purpose of that procedure and reasoning / warning,
> as for when exactly we would need to run it.

I am unsure what useful information is there... :)
Why someone ever want to create its own manual local CA.

> Also, does it have any relation to this procedure?
> https://access.redhat.com/documentation/en-US/
> Red_Hat_Enterprise_Virtualization/3.5/html-single/Administration_Guide/index.
> html#Replacing_the_SSL_certificate_used_by_Red_Hat_Enterprise_Virtualization_
> Manager_to_identify_itself_to_users_connecting_over_https

no, this procedure is to use 3rd party CA, it does not discuss how 3rd party issues a certificate but how to integrate them into apache.

Comment 3 Andrew Dahms 2015-05-19 04:20:37 UTC

Assigning to Lucy for review.

Lucy - this bug will likely involve simply removing the section in question from the Technical Guide. We have content on certificates in the Administration Guide that is a good reference, but the content here is very general.