Install and configure a compute node for Red Hat Enterprise Linux and CentOS in nova

[Piotr Gbyliczek]

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:

- [ ] 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: 18.0.1.dev7 on 2018-09-08 06:55
SHA: f5a528761e1b2599911c7b5ec8c8c99112e02701
Source: https://git.openstack.org/cgit/openstack/nova/tree/doc/source/install/compute-install-rdo.rst
URL: https://docs.openstack.org/nova/rocky/install/compute-install-rdo.html

Going through installation procedure there is a section which could benefit from clarification.

Guide explains how to set up keystone authentication with auth_url parameter, which is correct way of doing it :

[keystone_authtoken]
# ...
auth_url = http://controller:5000/v3

Configuration file however contains two parameters that seem to be service this function :

www_authenticate_uri
auth_uri

Note that "auth_uri" is not equal to "auth_url". In addition "auth_uri" is deprecated in favour of the "www_authenticate_uri".

I have made a mistake of typing "auth_uri" parameter by hand instead of a copy&paste from guide, and as a result had issue starting the nova-api.service

I would think a clarification of this may be helpful for those following guide, either explanation that config file has "auth_uri" parameter, that is different parameter and you need to add "auth_url" to that section, or information that config file has a typo that needs to be corrected.

[Matt Riedemann (mriedem)]

So, you want to see something in the guide that says, "warning: auth_uri is a thing but don't use it"? Because it's not a typo in the config, it's a deprecated config option for keystone.

[Piotr Gbyliczek (peem)]

Hi Matt,

Agreed, it is not typo in config, but when you a person that likes to type config options to get them memorised, thinking that auth_uri is to be used may be an easy mistake to do.
A warning like you said will be certainly helpful.

I would not even bother anybody if the auth_uri would be deprecated by auth_url, but that is not the case unless I misunderstand it. Meaning, auth_url is not the same as www_authentication_uri.

Regards,
Piotr