Bug 1394185

Summary:	[DOCS] Documentation issue / Performing Manual In-place Cluster Upgrades
Product:	OpenShift Container Platform	Reporter:	Vladislav Walek <vwalek>
Component:	Documentation	Assignee:	Ashley Hardin <ahardin>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Anping Li <anli>
Severity:	medium	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	low
Version:	3.3.0	CC:	adellape, anli, aos-bugs, jokerman, mmccomas, robert.bohne
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:	2017-03-15 19:26:35 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:

Description Vladislav Walek 2016-11-11 11:02:36 UTC

Description of problem:

There is a error in the ansible playbook upgrade from 3.2 to 3.3 version. If the yum update atomic-openshift-utils is updated, the examples are updated only on /usr/share/ansible/openshift-ansible/roles/openshift_examples/files/examples - version 1.3,  but NOT in /usr/share/openshift/examples/ - version 1.2.
Unfortunately, the ansible installer is doing task "role openshift_examples" which will import to openshift the examples from /usr/share/openshift/examples/ which is still 1.2 version of examples.
The administrator must then perform the workaround described in [1]. There should be change in the playbook or in rpm package. To update the examples or to import the examples from correct directory.


[1] https://docs.openshift.com/container-platform/3.3/install_config/upgrading/manual_upgrades.html#updating-the-default-image-streams-and-templates

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

OpenShift Container Platform 3.3

How reproducible:

Upgrade to the OSCP 3.3.

Actual results:

in OSCP are imported examples version 1.2 (old now, not the 1.3)

Expected results:

in OSCP should be imported version 1.3

Additional info:

Comment 3 Scott Dodson 2017-02-08 20:56:32 UTC

Reading through the documentation if you simply skip step number 2 the steps that follow will actually update the content. Assigning to docs to have step number 2 removed.

As things may change between the time of this BZ update and when docs are updated, the step I'm suggesting is removed is the following from step #2 at https://docs.openshift.com/container-platform/3.3/install_config/upgrading/manual_upgrades.html#updating-the-default-image-streams-and-templates


Step 2 -- 
Update the global openshift project by running the following commands. Receiving warnings about items that already exist is expected.

# oc create -n openshift -f /usr/share/openshift/examples/image-streams/image-streams-rhel7.json
# oc create -n openshift -f /usr/share/openshift/examples/image-streams/dotnet_imagestreams.json
# oc create -n openshift -f /usr/share/openshift/examples/db-templates
# oc create -n openshift -f /usr/share/openshift/examples/quickstart-templates
# oc create -n openshift -f /usr/share/openshift/examples/xpaas-streams
# oc create -n openshift -f /usr/share/openshift/examples/xpaas-templates
# oc replace -n openshift -f /usr/share/openshift/examples/image-streams/image-streams-rhel7.json
# oc replace -n openshift -f /usr/share/openshift/examples/db-templates
# oc replace -n openshift -f /usr/share/openshift/examples/quickstart-templates
# oc replace -n openshift -f /usr/share/openshift/examples/xpaas-streams
# oc replace -n openshift -f /usr/share/openshift/examples/xpaas-templates

Comment 5 Ashley Hardin 2017-02-09 16:46:52 UTC

Work in progress: https://github.com/openshift/openshift-docs/pull/3701

Comment 6 Anping Li 2017-03-09 07:49:21 UTC

Tested and the fix works.

Comment 7 openshift-github-bot 2017-03-09 14:23:42 UTC

Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/772876f9a8510bf7529f9024b622c19814f85d03
Bug 1394185, Removed repetitive step

https://github.com/openshift/openshift-docs/commit/3a2e6a261fd5d1658904bff3a1ef335bd288cb18
Merge pull request #3701 from ahardin-rh/BZ1394185

Bug 1394185, Removed repetitive step

Comment 8 Ashley Hardin 2017-03-15 19:26:35 UTC

Updates are now published: https://access.redhat.com/documentation/en-us/openshift_container_platform/3.4/html/installation_and_configuration/upgrading-a-cluster#updating-the-default-image-streams-and-templates