Bug 1394185 - [DOCS] Documentation issue / Performing Manual In-place Cluster Upgrades
Summary: [DOCS] Documentation issue / Performing Manual In-place Cluster Upgrades
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.3.0
Hardware: Unspecified
OS: Unspecified
low
medium
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Anping Li
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-11-11 11:02 UTC by Vladislav Walek
Modified: 2020-05-14 15:24 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-03-15 19:26:35 UTC
Target Upstream Version:


Attachments (Terms of Use)

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.


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