Commit Graph

75 Commits

Author SHA1 Message Date
Eric Fried 31508ddc71 Use :oslo-config: role in hypervisor-kvm doc
Convert ``option`` to the shiny :oslo.config:option:`section.option`
format in admin/configuration/hypervisore-kvm.

Recognizing this could be done to a lot more files; I just happened to
be looking at this one today.

Change-Id: If1b02ce99152ffd00d4f461dc4539606db1bb13b
2019-02-06 16:41:57 -06:00
Matt Riedemann d3251c3f9f doc: link Kashyap's cpu model talk to the libvirt driver config docs
Change-Id: If9b72290d3e7faa486dc0d3a7b2e4a6928705011
2019-02-04 11:09:13 -05:00
Yikun Jiang e66443770d Per aggregate scheduling weight
This spec proposes to add ability to allow users to use
``Aggregate``'s ``metadata`` to override the global config options
for weights to achieve more fine-grained control over resource
weights.

blueprint: per-aggregate-scheduling-weight

Change-Id: I6e15c6507d037ffe263a460441858ed454b02504
2019-01-21 11:48:44 +08:00
Matt Riedemann 313becd5ff Cleanup soft (anti)affinity weight multiplier options
This resolves the TODO from Ocata change:

  I8871b628f0ab892830ceeede68db16948cb293c8

By adding a min=0.0 value to the soft affinity
weight multiplier configuration options.

It also removes the deprecated [DEFAULT] group
alias from Ocata change:

  I3f48e52815e80c99612bcd10cb53331a8c995fc3

Change-Id: I79e191010adbc0ec0ed02c9d589106debbf90ea8
2019-01-19 18:03:16 -05:00
Matt Riedemann 3c50711249 Add docs for (initial) allocation ratio configuration
This adds a new section to the admin scheduler configuration
docs devoted to allocation ratios to call out the differences
between the override config options and the initial ratio
options, and how they interplay with the resource provider
inventory allocation ratio override that can be performed
via the placement REST API directly.

This moves the note about bug 1804125 into the new section
and also links to the docs from the initial allocation ratio
config option help text.

Part of blueprint initial-allocation-ratios
Related-Bug: #1804125

Change-Id: I7d8e822cd40dccaf5244e2cd95fa1af43fa9ed87
2018-12-05 11:36:29 -05:00
Matt Riedemann d65c18a0a9 Note the aggregate allocation ratio restriction in scheduler docs
This borrows from the release note in change
I01f20f275bbd5451ace5c1e6f41ab38d488dae4e to document the
regression, introduced in Ocata, where allocation ratio settings
in the aggregate core/ram/disk filters are not honored because
of placement being used by the FilterScheduler.

While there is related work going on around this in
blueprint initial-allocation-ratios and
blueprint placement-aggregate-allocation-ratios, it is still
a limitation in the current code base and needs to be called
out in the docs.

Change-Id: Ifaf596a8572637f843f47daf5adce394b0365676
Related-Bug: #1804125
2018-12-05 11:36:29 -05:00
Matt Riedemann 1fa09acf08 Mention meta key suffix in tenant isolation with placement docs
This changes does two things to the admin scheduler configuration
docs:

1. Notes the limitation from bug 1802111 for the older
   AggregateMultiTenancyIsolation filter and mentions that
   starting in Rocky, using tenant isolation with placement
   is better.

2. Notes that when isolating tenants via placement, the metadata
   key "filter_tenant_id" can be suffixed to overcome the limitation
   in bug 1802111.

Change-Id: I792c5df01b7cbc46c8363e261bc7422b09180e56
Closes-Bug: #1802111
2018-11-09 11:30:44 -05:00
Zuul 9947e9cd86 Merge "Explain cpu_model_extra_flags and nested guest support" 2018-10-31 07:58:42 +00:00
Florian Haas e304ad7f4d Explain cpu_model_extra_flags and nested guest support
In the Configuration Guide's section on KVM:

* expand on the implications of selecting a CPU mode and model
  for live migration,
* explain the cpu_model_extra_flags option,
* discuss how to enable nested guests, and the implications and
  limitations of doing so,
* bump the heading level of "Guest agent support".

Closes-Bug: 1791678
Change-Id: I671acd16c7e5eca01b0bd633caf8e58287d0a913
2018-10-30 17:03:48 +01:00
Matt Riedemann 25dadb94db Remove the CachingScheduler
The CachingScheduler has been deprecated since Pike [1].
It does not use the placement service and as more of nova
relies on placement for managing resource allocations,
maintaining compabitility for the CachingScheduler is
exorbitant.

The release note in this change goes into much more detail
about why the FilterScheduler + Placement should be a
sufficient replacement for the original justification
for the CachingScheduler along with details on how to migrate
from the CachingScheduler to the FilterScheduler.

Since the [scheduler]/driver configuration option does allow
loading out-of-tree drivers and the scheduler driver interface
does have the USES_ALLOCATION_CANDIDATES variable, it is
possible that there are drivers being used which are also not
using the placement service. The release note also explains this
but warns against it. However, as a result some existing
functional tests, which were using the CachingScheduler, are
updated to still test scheduling without allocations being
created in the placement service.

Over time we will likely remove the USES_ALLOCATION_CANDIDATES
variable in the scheduler driver interface along with the
compatibility code associated with it, but that is left for
a later change.

[1] Ia7ff98ff28b7265058845e46b277317a2bfc96d2

Change-Id: I1832da2190be5ef2b04953938860a56a43e8cddf
2018-10-18 17:55:36 -04:00
caoyuan 40f8b7cb23 Option "scheduler_default_filters" is deprecated.
The scheduler_default_filters option is deprecated in favor of
the [scheduler]/enabled_filters option. This change updates
the docs to use the enabled_filters option over the deprecated
scheduler_default_filters option.

Change-Id: I6cc78056179e01752e48e51a4e3552d52d66074b
Closes-Bug: #1794306
2018-09-25 19:50:16 +00:00
Matt Riedemann 6bc32481fb Fix docs and add functional test for AggregateMultiTenancyIsolation
The docs for AggregateMultiTenancyIsolation were misleading in that
tenants are not restricted to hosts only in a tenant-isolated
aggregate. It's the opposite: hosts in the tenant-isolated aggregate
are only available for tenants configured for that aggregate.

This fixes the docs including an example for clarification, and also
adds a functional test to show the behavior of the filter.

Change-Id: Ic55b88e7ad21ab5b7ad063eac743ff9406aae559
Related-Bug: #1771523
2018-09-13 16:46:53 -04:00
Chen de8292ccff doc: update info for hypervisors
Update links and add info for UML hypervisor.

Change-Id: Id2a5ed802b2849c4edd5b92debe37c921bc859cc
2018-09-07 15:33:19 +08:00
Radoslav Gerganov e22963d24a doc: add info how to troubleshoot vmware specific problems
Add a new paragraph on how to correlate OpenStack logs with vCenter logs
in order to find what went wrong.

Change-Id: I71069f61af99d1c0f8fda28e6ce0b2873f2042d8
2018-08-29 13:50:07 +03:00
Matt Riedemann 243ba85130 Deprecate Core/Ram/DiskFilter
The time has come.

These filters haven't been necessary since Ocata [1]
when the filter scheduler started using placement
to filter on VCPU, DISK_GB and MEMORY_MB. The
only reason to use them with any in-tree scheduler
drivers is if using the CachingScheduler which doesn't
use placement, but the CachingScheduler itself has
been deprecated since Pike [2]. Furthermore, as of
change [3] in Stein, the ironic driver no longer
reports vcpu/ram/disk inventory for ironic nodes
which will make these filters filter out ironic nodes
thinking they don't have any inventory. Also, as
noted in [4], the DiskFilter does not account for
volume-backed instances and may incorrectly filter
out a host based on disk inventory when it would
otherwise be OK if the instance is not using local
disk.

The related aggregate filters are left intact for
now, see blueprint placement-aggregate-allocation-ratios.

[1] Ie12acb76ec5affba536c3c45fbb6de35d64aea1b
[2] Ia7ff98ff28b7265058845e46b277317a2bfc96d2
[3] If2b8c1a76d7dbabbac7bb359c9e572cfed510800
[4] I9c2111f7377df65c1fc3c72323f85483b3295989

Change-Id: Id62136d293da55e4bb639635ea5421a33b6c3ea2
Related-Bug: #1787910
2018-08-24 19:32:27 -04:00
zhangyangyang 92a459331f Remove ChanceScheduler
ChanceScheduler is deprecated in Pike [1] and will be removed in a
subsequent release.

[1] https://review.openstack.org/#/c/492210/

Change-Id: I44f9c1cabf9fc64b1a6903236bc88f5ed8619e9e
2018-08-20 15:56:13 +01:00
jichenjc a78e27fb89 Add zvm admin intro and hypervisor information
The document adds the hypervisor introduction and links for
z/VM and its related entry in doc/source/admin/configuration/hypervisors.rst

Change-Id: I02b4c7ece38988e916a60cd1d91a5244bf91afa5
blueprint: add-zvm-driver-rocky
2018-08-17 02:05:24 +00:00
zhufl fbc86f8844 Fix none-ascii char in doc
There exist some none-ascii chars in doc, which may cause trouble
in displaying.

Change-Id: I1ebf83fb4e8cc853fd7f3065ecf420a064c9983f
2018-08-07 00:13:00 +00:00
Matt Riedemann 3cd5198d5a doc: fix resize user guide link
The admin config resize doc was linking to a now non-existent
user guide doc which was deleted in pike. This change imports
the resize user guide from the openstack-manuals stable/ocata
branch, fixes the link, and updates the resize user doc to
(1) link to our internal shutdown_timeout config option reference
and (2) link to the image properties doc in glance for the
os_shutdown_timeout image property.

Change-Id: I9988abfd344d1d3b0b6eaf32b036369b51853965
Closes-Bug: #1784715
2018-08-02 12:52:11 +00:00
Zuul 4370aa9c5e Merge "Updated AggregateImagePropertiesIsolation filter illustration" 2018-07-30 21:21:53 +00:00
karimull a9083d13b0 Updated AggregateImagePropertiesIsolation filter illustration
The example given in this section was not matching the explanation
of how the filter works.
Updated the example with right properties and aggregate name

Change-Id: Ieadeb0d736cc83a41093e6f4dfeb75d2396976ec
Closes-Bug: #1684261
2018-07-30 12:31:35 -07:00
Radoslav Gerganov 676a68bb67 doc: add missing permission for the vCenter service account
The service account that is being used by Nova needs "Profile-driven
storage view" permission for SPBM[0] to work. It is located under the
"Profile-driven storage" node in the Privileges tree.
This patch fixes the doc to address this.

[0] https://blueprints.launchpad.net/nova/+spec/vmware-spbm-support

Change-Id: I026b2394e6aa2fef8b1990923f9dcf8b3945175c
2018-07-25 11:53:17 +03:00
leizhang 7637026b90 Add method to get cpu traits
Add a method for libvirt driver to get cpu traits.
This is used for compute nodes to report cpu traits to Placement.

Change-Id: I9bd80adc244c64277d2d00e7d79c3002c8f9d57e
blueprint: report-cpu-features-as-traits
2018-07-24 12:37:46 +00:00
jichen f44d28590b [doc] enhance admin/configuration/api.rst
enhance doc including remove 'nova-api' daemon which is deprecated
to use wsgi instead, and added some operations for password
response.

Change-Id: I4cb7ac55683951aa5900699ba587da03c22fb0a1
2018-07-02 04:24:59 +00:00
Zuul 46bfd6f1c2 Merge "xenapi: drop deprecated vif_driver config option" 2018-06-26 16:14:54 +00:00
naichuans 2dbe8d2cba XenAPI: update the document related to vdi streaming
non-FS based Storage Repository will be supported after vdi streaming
patches finished. Remove SR limitation in the document.

Change-Id: Idaf461c849ac28b46e8971e5dd2f0e986a9a5c32
2018-06-13 02:00:31 +00:00
jianghua wang f7593ded8f XenAPI: define a new image handler to use vdi streaming
With the new image handler, it creates an image proxy which
will use the vdi streaming function from os-xenapi to
remotely export VHD from XenServer(image upload) or import
VHD to Xenerver(image download).
The existing GlanceStore uses custom functionality to directly
manipulate files on-disk, so it has the restriction that SR's
type must be file system based: e.g. ext or nfs. The new
image handler invokes APIs formally supported by XenServer
to export/import VDI remotely, it can support other SR
types also e.g. lvm, iscsi, etc.

Note:
vdi streaming would be supported by XenServer 6.5 or above.
The function of image handler depends on os-xenapi 0.3.3 or
above, so bump os-xenapi's version to 0.3.3 and also declare
depends on the patch which bump version in openstack/requirements.

Blueprint: xenapi-image-handler-option-improvement
Change-Id: I0ad8e34808401ace9b85e1b937a542f4c4e61690
Depends-On: Ib8bc0f837c55839dc85df1d1f0c76b320b9d97b8
2018-06-13 01:59:07 +00:00
Matt Riedemann c791cc4e04 xenapi: drop deprecated vif_driver config option
The vif_driver option was deprecated in Ocata:

  I599f3449f18d2821403961fb9d52e9a14dd3366b

And can now be removed. The only supported networking
backend is neutron + ovs.

Related to blueprint remove-nova-network

Co-Authored-By: Naichuan Sun <naichuan.sun@citrix.com>

Change-Id: Ia977f115335f00bc36249fa67437b4336d524251
2018-06-11 14:29:47 -04:00
jichen e3c5bd43cc doc follow https://review.openstack.org/#/c/572195
some doc need to be updated as well.

Change-Id: Id69535f2f520db074b9171aaf68d8d6f7fc1c9be
2018-06-11 15:06:33 +08:00
Zuul f7e6d721f5 Merge "Change consecutive build failure limit to a weigher" 2018-06-07 05:22:20 +00:00
Dan Smith 91e29079a0 Change consecutive build failure limit to a weigher
There is concern over the ability for compute nodes to reasonably
determine which events should count against its consecutive build
failures. Since the compute may erronenously disable itself in
response to mundane or otherwise intentional user-triggered events,
this patch adds a scheduler weigher that considers the build failure
counter and can negatively weigh hosts with recent failures. This
avoids taking computes fully out of rotation, rather treating them as
less likely to be picked for a subsequent scheduling
operation.

This introduces a new conf option to control this weight. The default
is set high to maintain the existing behavior of picking nodes that
are not experiencing high failure rates, and resetting the counter as
soon as a single successful build occurs. This is minimal visible
change from the existing behavior with default configuration.

The rationale behind the default value for this weigher comes from the
values likely to be generated by its peer weighers. The RAM and Disk
weighers will increase the score by number of available megabytes of
memory (range in thousands) and disk (range in millions). The default
value of 1000000 for the build failure weigher will cause competing
nodes with similar amounts of available disk and a small (less than ten)
number of failures to become less desirable than those without, even
with many terabytes of available disk.

Change-Id: I71c56fe770f8c3f66db97fa542fdfdf2b9865fb8
Related-Bug: #1742102
2018-06-06 15:18:50 -07:00
Zuul 0f80b76e7e Merge "Fix doc nit" 2018-06-06 16:02:19 +00:00
jichen 47423dfb7f Fix doc nit
use openstack hypervisor list instead nova hypervisor-list
to sync with sample given

Change-Id: Ib2224d317745738dd0bde62ac832d8308b369164
2018-06-06 14:52:36 +08:00
tianhui 8fce9f474b Fix bug for hypervisors
There are some wrong formats in the doc, it causes a wrong url.

Change-Id: Id85ec752bccec462936346ae546c8069242f20e8
2018-06-05 09:30:46 +08:00
Zuul b30a34a8b6 Merge "PowerVM Driver: vSCSI Fibre Channel volume adapter" 2018-05-31 20:46:45 +00:00
Zuul dd87118acc Merge "mirror nova host aggregate members to placement" 2018-05-31 00:45:41 +00:00
Jay Pipes 5eda1fab85 mirror nova host aggregate members to placement
This patch is the first step in syncing the nova host aggregate
information with the placement service. The scheduler report client gets
a couple new public methods -- aggregate_add_host() and
aggregate_remove_host(). Both of these methods do **NOT** impact the
provider tree cache that the scheduler reportclient keeps when
instantiated inside the compute resource tracker.

Instead, these two new reportclient methods look up a resource provider
by *name* (not UUID) since that is what is supplied by the
os-aggregates Compute API when adding or removing a "host" to/from a
nova host aggregate.

Change-Id: Ibd7aa4f8c4ea787774becece324d9051521c44b6
blueprint: placement-mirror-host-aggregates
2018-05-30 12:45:20 -04:00
Zuul d741f624c8 Merge "doc: Start using openstackdoctheme's extlink extension" 2018-05-30 15:21:12 +00:00
Zuul e2b0b469be Merge "Honor availability_zone hint via placement" 2018-05-24 06:54:56 +00:00
esberglu e997ca68b3 PowerVM Driver: vSCSI Fibre Channel volume adapter
This change adds vSCSI Fibre Channel volume support via cinder for the
PowerVM virt driver. Attach, detach, and extend are the supported
volume operations by the PowerVM vSCSI FC adapter. PowerVM CI volume
tests are run on-demand only which can be done by leaving a comment
with "powervm:volume-check".

Blueprint: powervm-vscsi
Change-Id: I632993abe70f9f98a032a35891b690db15ded6a0
2018-05-22 11:39:32 -05:00
Dan Smith 96f1071166 Honor availability_zone hint via placement
This adds a request filter that, if enabled, allows us to use placement
to select hosts in the desired availability zone by looking up the uuid
of the associated host aggregate and using that in our query for
allocation candidates. The deployer needs the same sort of mirrored
aggregate setup as the tenant filter, and documentation is added here to
make that clear.

Related to blueprint placement-req-filter

Change-Id: I7eb6de435e10793f5445724d847a8f1bf25ec6e3
2018-05-22 08:56:50 -07:00
Matthew Edmonds 30c87c5a9d Update PowerVM hypervisor docs
This refreshes the PowerVM hypervisor docs with a clearer flow and
additional information.

Change-Id: I0b33200b710960e4e8df7333d06c98456c4b0c00
2018-05-18 22:00:22 +00:00
Zuul 0f70337718 Merge "Fix typo in NUMATopologyFilter docs" 2018-05-18 18:18:18 +00:00
Takashi NATSUME 18a018033c Fix auth_url example in hypervisor-hyper-v.rst
The url path should be 'v3' instead of 'v3.0'
in the 'auth_url'.

TrivialFix
Change-Id: I91528d61bbadc1b30c27985de9511e51ad71e771
2018-05-17 08:30:42 +09:00
caoyuan 17105cce3a Update auth_url in install docs
1. Beginning with the Queens release, the keystone install guide
recommends running all interfaces on the same port. This patch
updates the install guide to reflect that change.
2. update the deprecated neutron auth options

Change-Id: I5c0a6389b759153bae06fa43846f03ac083c3db4
2018-05-15 13:06:07 +00:00
Zuul b60c3fc394 Merge "[doc]remove nova-cert leftover in doc" 2018-05-07 20:09:45 +00:00
Daniel Abad 72633d955f Fix typos in Host aggregates documentation
Change-Id: I5835928b51435149cb1557080b03ae3ab6bf3fa8
2018-05-07 16:41:39 +02:00
Stephen Finucane dd1a416bc9 doc: Start using openstackdoctheme's extlink extension
This ensures we have version-specific references to other projects [1].
Note that this doesn't mean the URLs are actually valid - we need to do
more work (linkcheck?) here, but it's an improvement nonetheless.

[1] https://docs.openstack.org/openstackdocstheme/latest/#external-link-helper

Change-Id: Ifb99e727110c4904a85bc4a13366c2cae300b8df
2018-05-03 14:34:47 +01:00
jichen e1c269b742 [doc]remove nova-cert leftover in doc
commit f2121f5880
cleaned up nova-cert, this patched removed remainings in doc

Change-Id: I0adf653976ccda77d56a752d3b4408c57621a428
2018-05-03 17:47:49 +08:00
zhangyangyang 3c756ac659 Remove ExactCoreFilter ExactDiskFilter ExactRamFilter
ExactCoreFilter, ExactDiskFilter and ExactRamFilter were deprecated
for removal in the Pike release [1] and are now being removed.

Now scheduling will use the custom resource class defined for each
baremetal node to make its selection.

[1] I843353427c90142a366ae9ca63ee4298b4f3ecd4

Change-Id: Ie25a5f6c28c20f589016791970da8d5849ec291c
2018-05-01 10:33:23 -04:00