Bug 1416508

Summary: [DOCS] Update to logging-support-template cause logging-kibana-proxy mismatch if logging-deployer-template changed
Product: OpenShift Container Platform Reporter: Steven Walter <stwalter>
Component: DocumentationAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED EOL QA Contact: Vikram Goyal <vigoyal>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.3.0CC: aos-bugs, bmcelvee, jokerman, mmccomas, stwalter
Target Milestone: ---Keywords: Reopened
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: 2019-08-10 06:45: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:
Embargoed:

Description Steven Walter 2017-01-25 16:25:08 UTC
Document URL: 
https://docs.openshift.com/container-platform/3.3/install_config/aggregate_logging.html


Section Number and Name: 
troubleshooting-kibana, both of the subheadings:

503 Error When Viewing the Console
Cryptic Error When Viewing the Console


Describe the issue: 

The logging-support-template pulls from the logging-deployer-template. If logging-deployer-template is changed but none of the logging components are (including the secrets), then you rebuild the logging-support-template, it will build from the new information -- whereas the logging-kibana-proxy secret is on the old information. So if the logging-deployer-template was rebuilt based on, say, an ansible playbook, then this would cause a mismatch. This can be resolved by also deleting logging-kibana-proxy before redeploying the logging-support-template.


Suggestions for improvement: 
Add a note before or after the steps saying, "If the logging-deployer-template has been rebuilt at any point, you will need to delete the logging-kibana-proxy secret before redeploying the logging-support template:

$ oc delete secret/logging-kibana-proxy
$ oc delete oauthclient/kibana-proxy
$ oc new-app logging-support-template

Additional information: