Bug 1604714

Summary:	[DOCS] ansible_service_broker_etcd_image_prefix needs to be specified in disconnected installation
Product:	OpenShift Container Platform	Reporter:	Kenjiro Nakayama <knakayam>
Component:	Documentation	Assignee:	Kathryn Alexander <kalexand>
Status:	CLOSED DUPLICATE	QA Contact:	Johnny Liu <jialiu>
Severity:	unspecified	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	unspecified
Version:	3.9.0	CC:	aos-bugs, jokerman, knakayam, mmccomas
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2018-07-22 06:53:30 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:

Description Kenjiro Nakayama 2018-07-20 00:07:26 UTC

Document URL/Section Number and Name:

  Running the OpenShift Container Platform Installer
  https://docs.openshift.com/container-platform/3.9/install_config/install/disconnected_install.html#disconnected-running-the-openshift-installer
  "For containerized installations, to install the etcd container, you can set the Ansible variable osm_etcd_image to be the fully qualified name of the etcd image on your local registry, for example, registry.example.com/rhel7/etcd."

Describe the issue:

Although the docs says "For containerized installations", the image is used in asb-etcd as:

  # oc get dc asb-etcd -n openshift-ansible-service-broker -o yaml |grep image:
          image: registry.access.redhat.com/rhel7/etcd:latest

Hence, osm_etcd_image needs to be specified regardless of containerized installations or not.

Suggestions for improvement:

It may mess up the docs, but osm_etcd_image should be added in the table of "Table 1. Registry Variables"(?)

  https://docs.openshift.com/container-platform/3.9/install_config/install/disconnected_install.html#diconnected-configuring-registry-location

Comment 2 Kathryn Alexander 2018-07-20 20:03:42 UTC

@Kenjiro, I have a few questions for you before I try to change the docs.

1) When do you need to set the osm_etcd_image variable? (Do you always set it or set it only if you have etcd installed on your master hosts?)
2) What does the variable do? (I don't see another explanation of that variable in the docs. You pull the image in this step: https://docs.openshift.com/container-platform/3.9/install_config/install/disconnected_install.html#disconnected-syncing-images)

Comment 3 Kenjiro Nakayama 2018-07-22 06:53:30 UTC

@Kathryn, Thank you. I answered below, but I realized that the issue was not only one variable, but many. It was listed in https://bugzilla.redhat.com/show_bug.cgi?id=1516534#c9.

bz#1516534 was still not documented yet, but this docs bz ticket also should be handled in bz#1516534, so I am closing this ticket.

> 1) When do you need to set the osm_etcd_image variable? (Do you always set it or set it only if you have etcd installed on your master hosts?)

If you are not using the default registry at registry.access.redhat.com, we always need to set it. etcd of ansible service broker is installed by default on 3.9.

> 2) What does the variable do? (I don't see another explanation of that variable in the docs. You pull the image in this step: https://docs.openshift.com/container-platform/3.9/install_config/install/disconnected_install.html#disconnected-syncing-images)

I'm sorry, osm_etcd_image is my mistake. The correct value is "ansible_service_broker_etcd_image_prefix". This variable sets the prefix of etcd image for ansible service broker.

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