Compute schedulers in nova - weights section is out of date

Bug #1805233 reported by Matt Riedemann
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Compute (nova)
In Progress
Medium
Harshavardhan Metla

Bug Description

- [x] This doc is inaccurate in this way:

This bug is specifically about the weights section here:

https://docs.openstack.org/nova/rocky/admin/configuration/schedulers.html#weights

There are a few issues:

1. Mentioning cells in here is not qualified as only for cells v1, which is deprecated. We should either note that the mention of cells weights in that section are for cells v1, or just remove them to avoid confusion.

2. The "Host weighting options" section lists several options with their now deprecated config option group:

https://docs.openstack.org/nova/rocky/admin/configuration/schedulers.html#id15

For example, ram_weight_multiplier is now in the [filter_scheduler] group rather than the [DEFAULT] group. We should fix the groups and link to the actual config option docs using the :oslo.config:option:`<group.name>`_ formatting (or just replace the table with descriptions to a list of related options) - or just drop the table and for each option, document it in the section about the filter/weigher that actually uses that option so there is context.

3. We should probably link to https://docs.openstack.org/nova/rocky/user/filter-scheduler.html#weights which actually explains the various in-tree weighers.

-----------------------------------
Release: 18.0.4.dev13 on 2018-11-24 17:12
SHA: 5d9dd1f63fe940479cfa43afffc369eb8e586050
Source: https://git.openstack.org/cgit/openstack/nova/tree/doc/source/admin/configuration/schedulers.rst
URL: https://docs.openstack.org/nova/rocky/admin/configuration/schedulers.html

Tags: doc scheduler
Matt Riedemann (mriedem)
description: updated
tags: added: doc
removed: docs
Changed in nova:
assignee: nobody → Harshavardhan Metla (harsha24)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to nova (stable/rocky)

Fix proposed to branch: stable/rocky
Review: https://review.opendev.org/754349

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on nova (stable/rocky)

Change abandoned by Harshavardhan Metla (<email address hidden>) on branch: stable/rocky
Review: https://review.opendev.org/754349
Reason: Changed in master in another commit

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to nova (master)

Fix proposed to branch: master
Review: https://review.opendev.org/754365

Changed in nova:
status: Triaged → In Progress
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.