Bug 1965020 - [Docs] Re-write step for installing Placement service for routed provider networks
Summary: [Docs] Re-write step for installing Placement service for routed provider net...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 16.1 (Train)
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: z6
: 16.1 (Train on RHEL 8.2)
Assignee: Greg Rakauskas
QA Contact: RHOS Documentation Team
URL:
Whiteboard: docs-accepted
Depends On: 1876960 1906053 1919882
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-05-26 14:43 UTC by Greg Rakauskas
Modified: 2021-05-26 17:25 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-05-26 17:25:36 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.