Documentation is missing steps to include a dependency for openstack-selinux

[chris murray]

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [x] This doc is inaccurate in this way:
Installing keystone queens on centos 7.4 from documentation

ln -s /usr/share/keystone/wsgi-keystone.conf /etc/httpd/conf.d/
command will not allow httpd to start due to selinux confilicts. Missing dependancy is openstack-selinux which requires the Cloud, OS, and Extras repisitories enabled.

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

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack: http://ask.openstack.org
 - The mailing list: http://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: 13.0.0.0rc3.dev1 on 2018-02-22 22:43
SHA: c06d74fcf4cf5338db6572265c609036f6817466
Source: https://git.openstack.org/cgit/openstack/keystone/tree/doc/source/install/keystone-install-rdo.rst
URL: https://docs.openstack.org/keystone/queens/install/keystone-install-rdo.html

[Colleen Murphy (krinkle)]

The main install guide suggests installing openstack-selinux here: https://docs.openstack.org/install-guide/environment-packages-rdo.html#finalize-the-installation

Since openstack-selinux is not specific to keystone, I tend to think that the note in the main install guide should be enough. Maybe we could add a link back to that main install guide at the top of this keystone install guide?

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/552568

[chris murray (cmurray139)]

Some reference would be helpful. When searching for instructions, I rarely
landed on the page referencing that package. It took some digging to find
it.

You could also just include this package with the other required packages
for each project to ensure that there is no confusion. Then include a
reference back to the source document.

Chris

On Tue, Mar 13, 2018, 11:20 AM OpenStack Infra <email address hidden>
wrote:

> Fix proposed to branch: master
> Review: https://review.openstack.org/552568
>
> ** Changed in: keystone
> Status: Confirmed => In Progress
>
> --
> You received this bug notification because you are subscribed to the bug
> report.
> https://bugs.launchpad.net/bugs/1754413
>
> Title:
> Documention Error
>
> Status in OpenStack Identity (keystone):
> In Progress
>
> Bug description:
> This bug tracker is for errors with the documentation, use the
> following as a template and remove or add fields as you see fit.
> Convert [ ] into [x] to check boxes:
>
> - [x] This doc is inaccurate in this way:
> Installing keystone queens on centos 7.4 from documentation
>
> ln -s /usr/share/keystone/wsgi-keystone.conf /etc/httpd/conf.d/
> command will not allow httpd to start due to selinux confilicts.
> Missing dependancy is openstack-selinux which requires the Cloud, OS, and
> Extras repisitories enabled.
>
> - [ ] This is a doc addition request.
> - [ ] I have a fix to the document that I can paste below including
> example: input and output.
>
> If you have a troubleshooting or support issue, use the following
> resources:
>
> - Ask OpenStack: http://ask.openstack.org
> - The mailing list: http://lists.openstack.org
> - IRC: 'openstack' channel on Freenode
>
> -----------------------------------
> Release: 13.0.0.0rc3.dev1 on 2018-02-22 22:43
> SHA: c06d74fcf4cf5338db6572265c609036f6817466
> Source:
> https://git.openstack.org/cgit/openstack/keystone/tree/doc/source/install/keystone-install-rdo.rst
> URL:
> https://docs.openstack.org/keystone/queens/install/keystone-install-rdo.html
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/keystone/+bug/1754413/+subscriptions
>

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/552568
Committed: https://git.openstack.org/cgit/openstack/keystone/commit/?id=f01edae95c389108ee0ff66c8a0933f6e5c57cf4
Submitter: Zuul
Branch: master

commit f01edae95c389108ee0ff66c8a0933f6e5c57cf4
Author: Russell Tweed <email address hidden>
Date: Tue Mar 13 16:13:00 2018 +0000

    Add prerequisite package note to Keystone install guide

    Added prerequisite package note and associated link to the main Install Guide
    to the Keystone install guide. This is to ensure commands further down the
    Keystone guide don't fail unexpectedly.

    Change-Id: I189854fbc7f1e05945ab0002c08ee84f7bfad196
    Closes-Bug: 1754413
    Closes-Bug: 1754417

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/keystone 14.0.0.0b1 development milestone.