Red Hat Bugzilla – Bug 1272144
[Docs] [Director] Basic Deployment Guide Does Not Include Deployment Paramaters
Last modified: 2017-05-11 23:00:57 EDT
Description of problem:
In the basic deployment guide, we only give the most basic command-line parameters. However, most of the time you need to enter additional parameters to end up with a successful deployment. We cover a lot of CLI parameters in the Advanced Deployment section, but not in the Basic Deployment.
Steps to Reproduce:
1. Follow Basic Deployment guide
2. Deploy with "openstack overcloud deploy --templates"
3. (Probably fail to deploy)
In the majority of cases, additional parameters will be required, so the deployment will fail, or hang, or will complete but be non-functional.
The Basic Deployment guide should indicate which additional CLI parameters will be required under certain scenarios.
If the deployment is on virt, then the paramater '--libvirt-type qemu' is required.
If the deployment is on bare metal, then '--neutron-public-interface <NIC>' should be used to indicate which NIC will be used for the external bridge (br-ex).
The '--ntp-server <HOST>' should be used to make sure the computes and controllers don't skew too far apart (which can create token timeout errors), this is absolutely required for HA deployments
The '--neutron-network-type' and '--neutron-tunnel-types' parameters are valid for a Basic deployment, but we don't document them.
Examples should be given for different quantities of hosts:
1 controller + 1 compute: openstack deploy blahblahblah
HA: 3 controllers + 2 compute + 3 ceph: openstack deploy blahblahblah
was this meant to be filed against Director? It is posted to rdo-list.
(In reply to John Trowbridge from comment #2)
> was this meant to be filed against Director? It is posted to rdo-list.
No, that was a mistake on my part. Thanks for catching it.
Assigning to Dan for review.
This change is now live: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/sect-Scenario_2_Using_the_CLI_to_Create_a_Basic_Overcloud.html#sect-Creating_the_Basic_Overcloud
Dan, any further changes required for this section?
No response in over a month. Closing this BZ. If changes are required, feel free to reopen.