Bug 1251533 - [Docs] [Director] Update of overcloud deploy command with Ceph
Summary: [Docs] [Director] Update of overcloud deploy command with Ceph
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 7.0 (Kilo)
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: async
: Director
Assignee: Dan Macpherson
QA Contact: Martin Lopes
URL:
Whiteboard:
Depends On: 1247585
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-08-07 15:29 UTC by Jiri Stransky
Modified: 2016-01-11 10:11 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-01-11 10:11:24 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Jiri Stransky 2015-08-07 15:29:03 UTC
When fixes for bug 1247585 get released, a simultaneous change to the documentation should be made.

The change is described in this comment:
https://bugzilla.redhat.com/show_bug.cgi?id=1247585#c6

and it's also described in the doc text of that same BZ.


Specifically, deploying via `openstack overcloud deploy` done with `--templates` parameter and some Ceph nodes (having `--ceph-storage-count` greater than 0) will need to get an additional parameter:

-e /usr/share/openstack-tripleo-heat-templates/environments/storage-environment.yaml

An update will be needed at least in section "6.3.8. Creating the Advanced Overcloud", where the deployment command is affected by this change.


Additional info:
----------------

The environment file above is meant for users to customize what storage backends are used in OpenStack services. The file defaults to using Ceph for Cinder, Glance and Nova ephemeral storage, so if this is what user wants, they can just reference the file directly. If they want some other combination of storage backends, they would copy the file somewhere and customize it, and then pass the customized version to `openstack overcloud deploy` instead. Here's how the file looks inside currently:

https://github.com/openstack/tripleo-heat-templates/blob/e96c087509193d5ad63caa3014977a2baf0db0d3/environments/storage-environment.yaml


Please let me know if more info is needed. Thanks :)

Comment 5 jliberma@redhat.com 2015-08-07 17:27:49 UTC
full command example:

openstack overcloud deploy -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml -e /home/stack/network-environment.yaml --control-flavor control --compute-flavor compute --ceph-storage-flavor ceph --ntp-server 10.16.255.2 --control-scale 3 --compute-scale 4 --ceph-storage-scale 4 --block-storage-scale 0 --swift-storage-scale 0 -t 90 --templates -e /usr/share/openstack-tripleo-heat-templates/environments/storage-environment.yaml

Comment 6 jliberma@redhat.com 2015-08-07 17:48:30 UTC
If you deploy ceph with tuskar or use templates but omit the -e /usr/share/openstack-tripleo-heat-templates/environments/storage-environment.yaml parameter you will see the following error in in undercloud heat-engine.log:

2015-08-07 01:01:09.691 17016 INFO heat.engine.stack [-] Stack CREATE FAILED (overcloud): Resource CREATE failed: ResourceUnknownStatus: Resource failed - Unknown status FAILED due to "Resource CREATE failed: ResourceUnknownStatus: Resource failed - Unknown status FAILED due to "Resource CREATE failed: Error: Deployment to server failed: deploy_status_code : Deployment exited with non-zero status code: 6"

Correct deployment command syntax:

openstack overcloud deploy -e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml -e /home/stack/network-environment.yaml --control-flavor control --compute-flavor compute --ceph-storage-flavor ceph --ntp-server 10.16.255.2 --control-scale 3 --compute-scale 4 --ceph-storage-scale 4 --block-storage-scale 0 --swift-storage-scale 0 -t 90 --templates -e /usr/share/openstack-tripleo-heat-templates/environments/storage-environment.yaml

Related bugs:
https://bugzilla.redhat.com/show_bug.cgi?id=1247585
https://bugzilla.redhat.com/show_bug.cgi?id=1236167

Comment 8 Dan Macpherson 2015-08-10 15:16:20 UTC
Docs updated, but still need to make a note aout adding storage config through tuskar.

Comment 9 Dan Macpherson 2015-08-10 15:43:22 UTC
Discussed with jistr. For the moment, we won't be documenting Ceph deployment with tuskar plans. The recommended/supported way is through Heat templates.

Comment 10 Andrew Dahms 2015-08-12 23:36:15 UTC
Assigning Martin as the QA contact.

Martin - could you review the changes made above?

Comment 11 Martin Lopes 2015-08-30 23:28:20 UTC
Completed peer review. Looks good to me.

Comment 12 Andrew Dahms 2016-01-11 10:11:24 UTC
This content is live on the Customer Portal.

Closing.


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