Bug 1378901

Summary:	RHV 4: It is unclear how to upload a certificate to enable disk image uploads
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Jon Jozwiak <jjozwiak>
Component:	Documentation	Assignee:	Byron Gravenorst <bgraveno>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Megan Lewis <melewis>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	4.0.0	CC:	bgraveno, gklein, lbopf, lsurette, rbalakri, srevivo, ykaul, ylavi
Target Milestone:	ovirt-4.0.5
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-11-16 00:05:58 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 Jon Jozwiak 2016-09-23 13:22:15 UTC

Description of problem:
The documentation for connecting to the admin console and using the disk image upload feature does not clearly indicate how to upload the certificate needed for this feature to work.  

https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/installation-guide/34-connecting-to-the-administration-portal is not clear:

"IMPORTANT
The first time that you connect to the Administration Portal, you are prompted to trust the certificate being used to secure communications between your browser and the web server. You must accept this certificate."


AND: 


 11.6.6. Uploading a Disk Image to a Storage Domain
...
Prerequisites:
You must configure the Image I/O Proxy when running engine-setup. See Configuring the Red Hat Virtualization Manager in the Installation Guide for more information.
You must import the required certificate authority into the web browser used to access the Administration Portal.



Version-Release number of selected component (if applicable):
RHV 4.0

Expected documentation:

IN RHV 4.0 you can download the ca.crt to your machine from the following address:

    http://<engine name>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA

Do not import at this time as it is not the certificate we want to import but the certificate authority.  

The below doc has links for how to import the CA for each browser:
    https://access.redhat.com/solutions/718653

Ideally these links would become part of the product documentation (as they are also needed for the web proxy).  


Additional info:

Comment 4 Byron Gravenorst 2016-11-15 23:56:05 UTC

This content has been published to:

- https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/administration-guide/116-virtual-disk-tasks#Uploading_a_Disk_Image_to_a_Storage_Domain

- https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/installation-guide/34-connecting-to-the-administration-portal