TripleO Install Guide in tripleo-docs -- openstack unified command line client.

[Toure Dunnon]

When deploying a new stack or updating a preexisting deployment, it is
important to avoid using command line clients which are similar in
functionality to prevent unexpected behaviors.

An example of this is using the openstack unified command line client and
the project based command line client. In this case this issue arose when
issuing a deployment command with the openstack unified cli and the
heatclient.

The following will present a behavior where the my_roles_data will persist,
due to the location of the custom roles data, which is within swift.

    * openstack overcloud deploy --templates -r my_roles_data.yaml
    * heat stack-delete overcloud

    Allow the stack to be deleted then continue.

    * openstack overcloud deploy --templates

    The reason for the failure is because the heatclient does not remove the
    custom roles data from swift as it is unaware.

    The correct course of action should be as followed:

    * openstack overcloud deploy --templates -r my_roles_data.yaml
    * openstack overcloud delete <stack name>

    Allow the stack to be deleted then continue.

    * openstack overcloud deploy --templates

This bug tracker is for additional notes which highlight the possible problems that may arise when mixing command line clients.

- [ ] This doc is inaccurate in this way: ______
- [x] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.

-----------------------------------
Release: 0.0.1.dev875 on 2018-07-22 16:56
SHA: 9b507c66fbfd68ff1e96eb85e4ce21fd7d00e077
Source: https://git.openstack.org/cgit/openstack/tripleo-docs/tree/doc/source/install/index.rst
URL: https://docs.openstack.org/tripleo-docs/latest/install/index.html

[OpenStack Infra (hudson-openstack)]

Change abandoned by Toure Dunnon (<email address hidden>) on branch: master
Review: https://review.openstack.org/570971
Reason: closing this to move the content into the documentation instead of release notes.

https://review.openstack.org/589192

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/589192
Committed: https://git.openstack.org/cgit/openstack/tripleo-docs/commit/?id=2e75d12bdd7336e4d24604cd11a77cbb4f0c35bc
Submitter: Zuul
Branch: master

commit 2e75d12bdd7336e4d24604cd11a77cbb4f0c35bc
Author: Toure Dunnon <email address hidden>
Date: Mon Aug 6 11:28:37 2018 -0400

    Notes warning for mixing multiple command line clients.

    This note is a warning against using project native command line clients
    and unified command line client together within a specific operator
    workflow.

    Change-Id: Ifcadef8b5ffa6454a9d92b6cb390dc3ccd9c87f5
    Closes-Bug: 1783180