Bug 1048035
| Summary: | database setup is not documented for Heat as are other services | ||
|---|---|---|---|
| Product: | Red Hat OpenStack | Reporter: | Steven Dake <sdake> |
| Component: | doc-Installation_and_Configuration_Guide | Assignee: | Don Domingo <ddomingo> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | ecs-bugs |
| Severity: | urgent | Docs Contact: | |
| Priority: | urgent | ||
| Version: | 4.0 | CC: | fdinitto, jpeeler, sbaker, sclewis, sdake, shardy, yeylon |
| Target Milestone: | z2 | Keywords: | Documentation, ZStream |
| Target Release: | 4.0 | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | 1046326 | Environment: | |
| Last Closed: | 2014-03-04 00:04:45 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: | |||
| Bug Depends On: | |||
| Bug Blocks: | 1046326, 1049118 | ||
|
Description
Steven Dake
2014-01-03 00:26:24 UTC
Several OpenStack services are documented on how to configure MySQL for use with the OpenStack Services. Some examples for Keystone are: https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html/Installation_and_Configuration_Guide/Creating_the_Identity_Database.html https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html/Installation_and_Configuration_Guide/Setting_the_Database_Connection_String.html Heat is missing such documentation. Similar to the documentation cited in comment #1, the following commands will setup the database for Heat: On database server: Connect to the database service using the mysql command. # mysql -u root -p Create the heat database. mysql> CREATE DATABASE heat; Create a heat database user and grant it access to the heat database. mysql> GRANT ALL ON heat.* TO 'heat'@'%' IDENTIFIED BY 'PASSWORD'; mysql> GRANT ALL ON heat.* TO 'heat'@'localhost' IDENTIFIED BY 'PASSWORD'; Replace PASSWORD with a secure password that will be used to authenticate with the database server as this user. Flush the database privileges to ensure that they take effect immediately. mysql> FLUSH PRIVILEGES; Exit the mysql client command. mysql> quit --- On orchestration server: openstack-config --set /etc/heat/heat.conf DEFAULT sql_connection mysql://heat:PASS@IP/heat runuser -s /bin/sh heat -c "heat-manage db_sync" Jeff: thanks, this appears to be working fine. As extra note, the yum invocation on section 16.1 must be updated as well packaging dependencies. # yum install openstack-heat-* python-heatclient -y will results in: [root@fab3 ~]# openstack-config --set /etc/heat/heat.conf DEFAULT sql_connection mysql://heat:heattest.139.56/heat -bash: openstack-config: command not found so either one of the heat packages should Requires: openstack-config or the doc needs fixing. then: [root@fab3 ~]# runuser -s /bin/sh heat -c "heat-manage db_sync" ERROR: No module named MySQLdb yum install MySQL-python fixes it. This should be addressed only in the package providing heat-manage. heat-manage requires mysql-python and that dependency should be expressed properly. Some more notes on configuring heat from the docs. Docs are missing a section on how to setup qpid bits in heat.conf. All other services (for example glance) have a section (pretty much copy/paste around) on how to point a config to a certain qpidd instance. Example: openstack-config --set /etc/heat/heat.conf DEFAULT qpid_hostname IPADDR_OF_QPID_INSTANCE -- Section 16.3 points to an incorrect init script: 16.3. Launching the Orchestration Service ... openstack-heat-api-engine the init script is: [root@fab3 ~]# /etc/init.d/openstack-heat-engine so -api- needs to be dropped for that service. Section 16.2.3 has wrong commands for creating endpoints. All url should be prefixed with http:// Example: [root@fab4 ~(keystone_admin)]# keystone endpoint-create --service_id c7b72143a1414af3938753b3686f8d7e --publicurl "http://10.16.139.66:8000/v1" --adminurl "http://10.16.139.66:8000/v1" --internalurl "http://10.16.139.66:8000/v1" Don, Our shipped documentation references an unsupported developer tool (heat-db-setup) and doesn't match the other components relating to database setup. Could you take the contents of Comment #4 and integrate it into the documentation? Don, Correction to Comment #10. The following issues were found in the documentation: https://bugzilla.redhat.com/show_bug.cgi?id=1048035#c5 https://bugzilla.redhat.com/show_bug.cgi?id=1048035#c6 https://bugzilla.redhat.com/show_bug.cgi?id=1048035#c7 |