Bug 1846320 (OCPRHV-175) - OCPRHV-175: [Docs]: Update IPI install documentation
Summary: OCPRHV-175: [Docs]: Update IPI install documentation
Keywords:
Status: CLOSED DUPLICATE of bug 1911298
Alias: OCPRHV-175
Product: OpenShift Container Platform
Classification: Red Hat
Component: Installer
Version: 4.6
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: 4.7.0
Assignee: Steve Goodman
QA Contact: Michael Burman
URL:
Whiteboard:
: RHV-40027 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-06-11 11:33 UTC by Douglas Schilling Landgraf
Modified: 2021-05-09 13:50 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: No Doc Update
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-05-03 16:10:20 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Douglas Schilling Landgraf 2020-06-11 11:33:19 UTC
Description of problem:

In 4.6, we have simplified the install process for IPI. Based on that, is required to update the documentation.


The IPI installer for oVirt removed the need of:
---------------------------------------------------
          - oVirt API endpoint URL [? for help] (Y/n) 
          - Is the oVirt CA trusted locally? [? for help] (Y/n) 
          - ? oVirt certificate bundle [Enter 2 empty lines to finish]  (Copy/past cert bundle)



Now, the IPI installer only asks:
-------------------------------------
          - Engine FQDN[:PORT] 
          ? The Engine FQDN[:PORT] (engine.example.com:443)

It will automatically download CA Cert from engine and use the cert if the CA is trusted. Otherwise, will continue without ssl (with warning to user).

Comment 1 Douglas Schilling Landgraf 2020-06-11 19:55:21 UTC
Example:
$ openshift-install create cluster --dir=ocp

? SSH Public Key  [Use arrows to move, enter to select, type to filter, ? for more help]
> /home/douglas/.ssh/id_rsa_ocp.pub

? Platform  [Use arrows to move, enter to select, type to filter, ? for more help]
  ovirt

? Engine FQDN[:PORT] [? for help] engine.medogz.home

? Engine username admin@internal
? Engine password ************

? Cluster  [Use arrows to move, enter to select, type to filter, ? for more help]
> Default


? Storage domain  [Use arrows to move, enter to select, type to filter, ? for more help]
> data

? Network  [Use arrows to move, enter to select, type to filter, ? for more help]
> ovirtmgmt

? Internal API virtual IP: 192.168.1.69
? Ingress virtual IP: 192.168.1.70

? Base Domain ocp
? Cluster Name [? for help] cluster
? Pull Secret [? for help] **********************

Comment 5 Douglas Schilling Landgraf 2020-06-18 13:05:46 UTC
Hi Rolfe,

(In reply to Rolfe Dlugy-Hegwer from comment #4)
> https://github.com/openshift/installer/blob/master/docs/user/customization.
> md#platform-customization
> https://github.com/openshift/installer/blob/master/docs/user/ovirt/
> customization.md

Sorry, I think I was not clear in my BZ description. I am referring to the doc below. The others docs you mentioned in comment#4 is not related.
https://docs.openshift.com/container-platform/4.4/installing/installing_rhv/installing-rhv-default.html

Fell free to reach me if you have any question.

Comment 6 Douglas Schilling Landgraf 2020-07-09 12:10:25 UTC
due to capacity constraints we will be revisiting this bug in the upcoming sprint

Comment 7 Sandro Bonazzola 2020-09-14 09:34:00 UTC
same as comment #6

Comment 9 Rolfe Dlugy-Hegwer 2020-12-04 18:44:41 UTC
*** Bug 1903359 has been marked as a duplicate of this bug. ***

Comment 10 Rolfe Dlugy-Hegwer 2020-12-04 18:47:54 UTC
Please also remove

```
[NOTE]
====
The third static IP address does not require a DNS entry. The {product-title} cluster uses that address for its internal DNS service.
====
```

from modules/installing-rhv-preparing-network-environment.adoc.

Comment 11 Steve Goodman 2021-02-25 13:50:39 UTC
(In reply to Douglas Schilling Landgraf from comment #0)
> Description of problem:

> Now, the IPI installer only asks:
> -------------------------------------
>           - Engine FQDN[:PORT] 
>           ? The Engine FQDN[:PORT] (engine.example.com:443)
> 
> It will automatically download CA Cert from engine and use the cert if the
> CA is trusted. Otherwise, will continue without ssl (with warning to user).

Where in the sequence does this happen?

Please enter as a comment in the pull request:

https://github.com/openshift/openshift-docs/pull/29834

Comment 12 Steve Goodman 2021-03-08 05:30:59 UTC
(In reply to Rolfe Dlugy-Hegwer from comment #10)
> Please also remove
> 
> ```
> [NOTE]
> ====
> The third static IP address does not require a DNS entry. The
> {product-title} cluster uses that address for its internal DNS service.
> ====
> ```
> 
> from modules/installing-rhv-preparing-network-environment.adoc.

Removed.

(In reply to Steve Goodman from comment #11)
> (In reply to Douglas Schilling Landgraf from comment #0)
> > Description of problem:
> 
> > Now, the IPI installer only asks:
> > -------------------------------------
> >           - Engine FQDN[:PORT] 
> >           ? The Engine FQDN[:PORT] (engine.example.com:443)
> > 
> > It will automatically download CA Cert from engine and use the cert if the
> > CA is trusted. Otherwise, will continue without ssl (with warning to user).
> 
> Where in the sequence does this happen?
> 
> Please enter as a comment in the pull request:
> 
> https://github.com/openshift/openshift-docs/pull/29834

Douglas, I am now addressing these changes in this PR: 
https://github.com/openshift/openshift-docs/pull/30181

So the only change I am addressing for this bug is the one that Rolfe mentioned in comment 10. Please review.

Comment 13 Steve Goodman 2021-03-08 05:32:05 UTC
(In reply to Rolfe Dlugy-Hegwer from comment #10)
> Please also remove
> 
> ```
> [NOTE]
> ====
> The third static IP address does not require a DNS entry. The
> {product-title} cluster uses that address for its internal DNS service.
> ====
> ```
> 
> from modules/installing-rhv-preparing-network-environment.adoc.

Rolfe, what versions of OCP does this request apply to?

Comment 14 Rolfe Dlugy-Hegwer 2021-03-08 11:33:59 UTC
(In reply to Steve Goodman from comment #13)
> Rolfe, what versions of OCP does this request apply to?

I don't know. Please check with the SMEs.

Comment 15 Steve Goodman 2021-03-08 11:55:11 UTC
In reply to Rolfe Dlugy-Hegwer from comment #14)
> (In reply to Steve Goodman from comment #13)
> > Rolfe, what versions of OCP does this request apply to?
> 
> I don't know. Please check with the SMEs.

Douglas, which versions of OCP does Rolfe's comment 12 apply to?

Comment 16 Douglas Schilling Landgraf 2021-03-29 19:02:04 UTC
(In reply to Steve Goodman from comment #15)
> In reply to Rolfe Dlugy-Hegwer from comment #14)
> > (In reply to Steve Goodman from comment #13)
> > > Rolfe, what versions of OCP does this request apply to?
> > 
> > I don't know. Please check with the SMEs.
> 
> Douglas, which versions of OCP does Rolfe's comment 12 apply to?

4.7 or higher.

Comment 17 Steve Goodman 2021-05-03 16:10:20 UTC
I'm closing this as a duplicate of bug 1911298, as I address this in the same PR[1]

[1] https://github.com/openshift/openshift-docs/pull/30181

*** This bug has been marked as a duplicate of bug 1911298 ***

Comment 18 Steve Goodman 2021-05-09 13:50:03 UTC
(In reply to Rolfe Dlugy-Hegwer from comment #10)
> Please also remove
> 
> ```
> [NOTE]
> ====
> The third static IP address does not require a DNS entry. The
> {product-title} cluster uses that address for its internal DNS service.
> ====
> ```
> 
> from modules/installing-rhv-preparing-network-environment.adoc.

I addressed this in bug 1893182.


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