Bug 1654797 - [Docs] [OSP13] Director Troubleshooting Guide Contains Inaccurate Troubleshooting Steps
Summary: [Docs] [OSP13] Director Troubleshooting Guide Contains Inaccurate Troubleshoo...
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 13.0 (Queens)
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: ---
: ---
Assignee: RHOS Documentation Team
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-11-29 17:12 UTC by Alberto Rivera Laporte
Modified: 2020-11-06 15:14 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-11-06 15:14:09 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Alberto Rivera Laporte 2018-11-29 17:12:34 UTC
Description of problem:


The Red Hat Openstack Platform 13 Directors Installation and Usage Guide[0] contains what I suspect are deprecated troubleshooting functions regarding restarting the Heat API in the Director Troubleshooting/Tuning the Undercloud section [0].

--------------
Chapter 13
Section 13.8
-------------------

Section content: 
-------------------
The openstack-heat-engine and openstack-heat-api services might consume too many resources at times. If so, set max_resources_per_stack=-1 in /etc/heat/heat.conf and restart the heat services:

$ sudo systemctl restart openstack-heat-engine openstack-heat-api
-------------------


Issue: 
-------------------
In Red Hat Openstack 13 the heat-api service is configured as a WSGI application under the control of Apache. Restarting the openstack-heat-api service as instructed by the troubleshooting guide will cause issues with port conflicts as it attempts to bound to port 8004 which is already bound by the apache/wsgi interface of the openstack-heat-api and will not yield the desired results.
-------------------








[0]
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/director_installation_and_usage/chap-troubleshooting_director_issues#sect-Tuning_the_Undercloud

Comment 2 Alberto Rivera Laporte 2020-11-06 15:14:09 UTC
Closing this BZ as is no longer relevant.


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