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

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Last Closed:
Target Upstream Version:

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

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.


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