← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1778227] [NEW] Docs needed for optional placement database

 

Public bug reported:

Blueprint https://blueprints.launchpad.net/nova/+spec/optional-
placement-database added support for configuring a separate database for
the placement service so it's not just part of the nova_api database
(even though it's the same schema for now).

This is important for extracting placement from nova, and should be part
of a new base install so people don't have to migrate later.

There are at least two places we should update in the docs:

1. The install guide for fresh installs should tell people to create a
database for placement and configure nova.conf appropriately using the
new placement database config options.

Looking at the install guide, we have 3 different guides to update
(ubuntu, rdo, suse), but looks like:

a) https://docs.openstack.org/nova/latest/install/controller-install-
ubuntu.html#prerequisites - create a placement database using the
nova_api schema.

b) configure the placement db

https://docs.openstack.org/nova/latest/install/controller-install-
ubuntu.html#install-and-configure-components

I think that's it. "nova-manage api_db sync" will sync the placement
database and the nova_api database, so we should be good there.

2. Update the placement upgrade docs for Rocky to mention the new config
option and, at a high level, the options people have for migrating from
nova_api to placement db, e.g. stop api services, copy the nova_api db,
deploy placement db using the nova_api copy, config and restart api
services.

https://docs.openstack.org/nova/latest/user/placement.html#rocky-18-0-0

** Affects: nova
     Importance: Medium
         Status: Confirmed


** Tags: docs placement

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1778227

Title:
  Docs needed for optional placement database

Status in OpenStack Compute (nova):
  Confirmed

Bug description:
  Blueprint https://blueprints.launchpad.net/nova/+spec/optional-
  placement-database added support for configuring a separate database
  for the placement service so it's not just part of the nova_api
  database (even though it's the same schema for now).

  This is important for extracting placement from nova, and should be
  part of a new base install so people don't have to migrate later.

  There are at least two places we should update in the docs:

  1. The install guide for fresh installs should tell people to create a
  database for placement and configure nova.conf appropriately using the
  new placement database config options.

  Looking at the install guide, we have 3 different guides to update
  (ubuntu, rdo, suse), but looks like:

  a) https://docs.openstack.org/nova/latest/install/controller-install-
  ubuntu.html#prerequisites - create a placement database using the
  nova_api schema.

  b) configure the placement db

  https://docs.openstack.org/nova/latest/install/controller-install-
  ubuntu.html#install-and-configure-components

  I think that's it. "nova-manage api_db sync" will sync the placement
  database and the nova_api database, so we should be good there.

  2. Update the placement upgrade docs for Rocky to mention the new
  config option and, at a high level, the options people have for
  migrating from nova_api to placement db, e.g. stop api services, copy
  the nova_api db, deploy placement db using the nova_api copy, config
  and restart api services.

  https://docs.openstack.org/nova/latest/user/placement.html#rocky-18-0-0

To manage notifications about this bug go to:
https://bugs.launchpad.net/nova/+bug/1778227/+subscriptions


Follow ups