Bug 1965020

Summary:	[Docs] Re-write step for installing Placement service for routed provider networks
Product:	Red Hat OpenStack	Reporter:	Greg Rakauskas <gregraka>
Component:	documentation	Assignee:	Greg Rakauskas <gregraka>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	high	Docs Contact:
Priority:	high
Version:	16.1 (Train)	CC:	bcafarel, gregraka, igallagh, jamsmith
Target Milestone:	z6	Keywords:	Triaged
Target Release:	16.1 (Train on RHEL 8.2)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	docs-accepted
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2021-05-26 17:25:36 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1876960, 1906053, 1919882
Bug Blocks:

Description Greg Rakauskas 2021-05-26 14:43:43 UTC

In 16.1.6, the RHOSP Placement service (python3-osc-placement) is not installed by default. (See BZ 1906053.) Therefore, we need to remove the step in the "Networking Guide" in the topic, "Preparing for a routed provider network," that instructs users to install it.

Because all customers are not on 16.1.6, a new prerequisite must be added that states:

To query the Placement service, the `python3-osc-placement` package must be installed on the undercloud. This package is available on the undercloud from Red Hat OpenStack Platform (RHOSP) 16.1.6. For earlier versions of RHOSP you must install the package manually. To check which version of RHOSP you are running, enter the following command on the undercloud:
   # cat /etc/rhosp-release
   Red Hat OpenStack Platform release 16.1.6 (Train)

To install the Placement service, log in to the undercloud as root and run this command:
   # yum install python3-osc-placement

Comment 1 Greg Rakauskas 2021-05-26 14:47:41 UTC

Hi,

Whoops! in Comment 0, I should have written, the "...Placement service IS NOW
installed by default!"

--Greg

Comment 2 Greg Rakauskas 2021-05-26 14:52:56 UTC

Hi,

The doc in question is step 5 in the topic, "Preparing for a routed provider network," in the RHOSP 16.1 "Networking Guide:"

   5. The OpenStackClient plug-in for the Placement service must be installed.

      On the undercloud, install this plug-in as root by running this command:

      # yum install python3-osc-placement

Located here:

   https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/networking_guide/index#prepare-routed-prov-network

--Greg

Comment 3 Greg Rakauskas 2021-05-26 16:22:12 UTC

Hi,

The step has been re-written to reflect that the Placement service is now
installed by default:

   5. Ensure that the RHOSP Placement service, the python3-osc-placement 
      package, is installed on the undercloud.

      This package is available on the undercloud in RHOSP 16.1.6 and later. For
      earlier versions of RHOSP you must install the package manually. To check
      which version of RHOSP you are running, enter the following command on the
      undercloud:

      # cat /etc/rhosp-release
      Red Hat OpenStack Platform release 16.1.5 (Train)

      To install the Placement service, log in to the undercloud as root, and
      run this command:

      # yum install python3-osc-placement

--Greg

Comment 4 Greg Rakauskas 2021-05-26 17:25:36 UTC

Hi,

The change has been made to the RHOSP 16.1 "Networking Guide." Customers can see
this change here:

   https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/networking_guide/index#prepare-routed-prov-network

Thanks,
--Greg