Bug 1297501 - [DOCS] Openshift examples directory location missing steps
Summary: [DOCS] Openshift examples directory location missing steps
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: ---
Assignee: Traci Morrison
QA Contact: Anping Li
Vikram Goyal
URL:
Whiteboard: 3.7-release-plan
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-01-11 16:53 UTC by Ryan Howe
Modified: 2020-12-11 12:02 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-10-18 19:37:45 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Ryan Howe 2016-01-11 16:53:54 UTC
Document URL: https://docs.openshift.com/enterprise/3.1/install_config/upgrades.html#updating-the-default-image-streams-and-templates

Section Number and Name: Updating the Default Image Streams and Templates

Describe the issue: 

When installing or updating atomic-openshift-utils to obtain the latest image streams and template, /usr/share/openshift/examples/ does not get updated with the latest templates. 

The following needs to happen to move the files to the correct location:

# mkdir /usr/share/openshift/examples
# cp -R /usr/share/ansible/openshift-ansible/roles/openshift_examples/files/examples/v1.1/* /usr/share/openshift/examples/



Suggestions for improvement: 

Either change the the file location use to update the streams and templates or add steps to cp the contents over

Comment 2 Traci Morrison 2017-09-06 19:52:45 UTC
Work in progress: https://github.com/openshift/openshift-docs/pull/5200

Comment 3 Anping Li 2017-09-15 09:11:30 UTC
@Traci, 
For installation:
/usr/share/openshift/examples/ are installed on the first master only.

For automate upgrade, Those files get updated on the first master by playbook. 

For manually upgrade, The templates and imagestreams are updated on the OCP client where atomic-openshift-utils was installed. and the /usr/share/openshift/examples/ does not get updated  on first master.


If we want to persist the /usr/share/openshift/examples/ on first master. add step as following manually upgrade doc,

Update /usr/share/openshift/examples/_*  to v3.x on the first master.
scp -R /usr/share/ansible/openshift-ansible/roles/openshift_examples/files/examples/v3.6/* user@master1:/usr/share/openshift/examples/



If we want to persist the /usr/share/openshift/examples/ on all masters. add steps as following on both automate upgrade and manually upgrade

Update /usr/share/openshift/examples/_*  to v3.x on all masters

mkdir /usr/share/openshift/examples
scp -R /usr/share/ansible/openshift-ansible/roles/openshift_examples/files/examples/v3.6/* user@masterx:/usr/share/openshift/examples

Comment 4 Traci Morrison 2017-09-21 16:28:58 UTC
Updated PR: https://github.com/openshift/openshift-docs/pull/5200

Comment 5 openshift-github-bot 2017-10-11 18:53:22 UTC
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/50d45b878d5c44d031036169bb26f694cdefd026
Bug 1297501 added substep to obtain the latest image stream

https://github.com/openshift/openshift-docs/commit/c5875a618ca3e68aa99cf951ab1b2e7c776f164b
Merge pull request #5200 from tmorriso-rh/directory-location

Bug 1297501 added substep to obtain the latest image stream


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