Bug 1368054

Summary: Misleading command in adding provider doc
Product: Red Hat CloudForms Management Engine Reporter: Victor Estival <vestival>
Component: DocumentationAssignee: Chris Budzilowicz <cbudzilo>
Status: CLOSED CURRENTRELEASE QA Contact: Dayle Parker <dayleparker>
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 5.6.0CC: adahms, cbolz, dayleparker, hhudgeon, jhardy, krain, lavenel, obarenbo, vestival
Target Milestone: GA   
Target Release: 5.7.0   
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: 2018-02-13 14:00:03 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: Openstack Target Upstream Version:

Description Victor Estival 2016-08-18 08:47:39 UTC 
Document URL: https://access.redhat.com/documentation/en/red-hat-cloudforms/4.1/paged/managing-providers/chapter-3-cloud-providers

Section Number and Name: 3.1.1.1. Configuring the Overcloud to Store Events

Describe the issue: In the instructions it says:
Log in to the undercloud host.
Create an environment file called ceilometer.yaml, and add the following contents:

parameter_defaults:
  CeilometerStoreEvents: true
Add the environment file to the overcloud deploy command:

# openstack overcloud deploy --templates -e ~/ceilometer.yaml

Suggestions for improvement: 

The last command is not enough, since it should contain the whole OSP deployment command, for instance:
openstack overcloud deploy --templates /usr/share/openstack-tripleo-heat-templates/ \
  --ntp-server 10.104.1.1 \
  --control-flavor control --compute-flavor compute  \
  --control-scale 3 --compute-scale 3  \
  --neutron-tunnel-types vxlan --neutron-network-type vxlan   \
  -e ~/templates/network-environment.yaml  \
  -e ~/templates/network-isolation.yaml \
  -e ~/templates/timezone.yaml \
  -e ~/templates/storage-environment.yaml  \
  -e ~/templates/ceilometer.yaml

Additional information: 

If an user just execute "openstack overcloud deploy --templates -e ~/ceilometer.yaml" as suggested in the doc, the whole OSP environment breaks.
Comment 3 Andrew Dahms 2016-10-28 06:06:42 UTC 
Assigning to Chris for review.

Chris - we can raise a needinfo request again Loic Avenal for confirmation of any OSP-related details if needed.