Commit Graph

270 Commits

Author SHA1 Message Date
Zuul 647eb3911c Merge "Update docs: User token times out during long-running operations" 2019-04-06 11:21:32 +00:00
Zara 3ed1e88bd2 Explain why disk_available_least can be negative
This commit adds a paragaph to explain the circumstances in which
disk_available_least will have a negative value, and why this behaviour is
preferred.

Change-Id: Iaa33c35a14a6f0dc8b1d11803a885dce26722e52
2019-03-28 17:23:10 +00:00
Takashi NATSUME b71a5bae88 doc: Fix openstack CLI command
Replace 'openstack placement aggregate set' with
'openstack resource provider aggregate set'.

Change-Id: If085efd0cfb417764e24e9c7eeb23a4d34bf250f
Closes-Bug: #1821916
2019-03-28 09:45:16 +09:00
Zuul 38ce9d8a11 Merge "Add doc on VGPU allocs and inventories for nrp" 2019-03-27 16:14:00 +00:00
Matt Riedemann 75d4ba6752 Document a warning about using the JsonFilter
People hit problems using the JsonFilter from time to time
and at least I always have to re-learn what it does and am
somewhat horrified to find how flexible it is based on using
HostState attributes as filtering variables, not to mention
we don't do any functional testing with it. The docs are also
misleading in stating it only supports a subset of variables
when it's really anything on the HostState object. A common
case is people filtering on the hypervisor_hostname attribute
to schedule directly to a specific baremetal node with ironic.

This change adds a warning recommending to not use the filter
if possible and find alternatives, like traits. It also mentions
the HostState object as defining the variables that can be used
along with adding the commonly-used hypervisor_hostname variable
to the list.

Change-Id: Ib2b1395715b6bdb25f53ee7c68df44e2d84b895b
Related-Bug: #1821764
2019-03-26 12:13:42 -04:00
Matt Riedemann 45cecbb427 Fix JsonFilter query hint examples in docs
The API reference and part of the scheduler filter docs for
the JsonFilter query hint are using invalid json strings
in the examples.

This fixes both invalid locations using the same json string
used in the openstack server create command example in the
scheduler admin docs.

Change-Id: Iaab8608c7ffa6fbbea40a838dd02d8096f632f7a
Closes-Bug: #1821764
2019-03-26 12:05:30 -04:00
Sylvain Bauza 44490142be Add doc on VGPU allocs and inventories for nrp
Now that we reshape inventories and allocations for VGPU resources in Stein,
we think it's good for operators to know how to verify the resources using
osc-placement.

Change-Id: Ic58709aac2dd1f20f1b8440a3cea4f29eed9a965
Closes-Bug: #1821015
2019-03-26 15:17:39 +01:00
Sylvain Bauza 10234d5926 Remove expiremental note in the VGPU docs
FWIW, we already say in the feature classification documentation that the
feature is experimental [1] but we also now have functional tests that help
to verify that the feature is working.
I think we can just remove the note about this then.

[1] https://docs.openstack.org/nova/latest/user/feature-classification.html#operation_virtual_gpu

Change-Id: I705b3aeb1da33ddc41d4306ad91ad7cb70fcf4e4
2019-03-25 15:11:31 +01:00
Zuul acbbc3eb8b Merge "Documentation for bandwidth support" 2019-03-21 15:59:23 +00:00
Matt Riedemann c16c3062e7 Add docs for compute capabilities as traits
Change I15364d37fb7426f4eec00ca4eaf99bec50e964b6 added the
ability for the compute service to report a subset of driver
capabilities as standard COMPUTE_* traits on the compute node
resource provider.

This adds administrator documentation to the scheduler docs
about the feature and how it could be used with flavors. There
are also some rules and semantic behavior around how these traits
work so that is also documented.

Note that for cases #3 and #4 in the "Rules" section the
update_available_resource periodic task in the compute service
may add the compute-owned traits again automatically but it
depends on the [compute]/resource_provider_association_refresh
configuration option, which if set to 0 will disable that auto
refresh and a restart or SIGHUP is required. To avoid confusion
in these docs, I have opted to omit the mention of that option
and just document the action that will work regardless of
configuration which is to restart or SIGHUP the compute service.

Change-Id: Iaeec92e0b25956b0d95754ce85c68c2d82c4a7f1
2019-03-19 10:09:55 -04:00
Balazs Gibizer 47287f6f94 Documentation for bandwidth support
blueprint: bandwidth-resource-provider
Depends-On: https://review.openstack.org/#/c/640390
Depends-On: https://review.openstack.org/#/c/621494

Change-Id: I166787e092e16857d20f89fba965be2a5509fb4b
2019-03-18 11:24:56 +01:00
Zuul f7af48363f Merge "docs: Fix nits in remote console guide" 2019-03-13 21:03:32 +00:00
ya.wang fa07df1e99 Update docs: User token times out during long-running operations
Keystonemiddleware compares the roles of the service_user with
[Keystone_authtoken]/service_token_roles, we need to explain this so
that users don't get confused.

For example:
Nova send request to neutron with both service_user_token and
user_token, neutron first sends them to Keystonemiddleware for
authenrication, Keystonemiddleware will compare service_user's role
with [Keystone_authtoken]/service_token_roles which configured in
neutron, then decide whether to fetch user_token based on the result.

Change-Id: I024885adad2d14bc2568382c677198132dc88a13
2019-03-12 16:41:44 +08:00
Takashi NATSUME 892ead1438 doc: Fix a typo
Replace 'listeing' with 'listening'.

TrivialFix
Change-Id: I0fe3b75c5005e3ca83b3e6bcc2998327595635ab
2019-03-11 17:45:25 +09:00
Zuul c756e868b6 Merge "Remove cells v1 (for the most part) from the docs" 2019-03-08 01:29:10 +00:00
Stephen Finucane fbb3b53a3b docs: Fix nits in remote console guide
These were missed in I08991796aaced2abc824f608108c0c786181eb65.

Change-Id: Ibb31d7d8460c6376f42bcb65c94796d5e68f3d9d
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
2019-03-07 17:44:55 +00:00
Zuul 4ae7fb4ec7 Merge "doc: cleanup pci.alias references" 2019-03-07 00:52:18 +00:00
Matt Riedemann fbfb1a25df doc: cleanup pci.alias references
The admin and user flavor docs on pci.alias were not super
helpful by just throwing the user to the config docs or
flavor docs and letting them figure it out. This change
helps the reader by linking directly to the things being
referenced.

Also cleans up a pci.passthrough config option reference
while in here.

Change-Id: Ie2e28a14ff4655e38a5db3925adcd605ac773843
2019-03-06 17:59:26 +00:00
Zuul 0b3809fec0 Merge "FUP: docs nit" 2019-03-05 18:28:10 +00:00
Zuul c7db20d140 Merge "Remove wrong description for auto resize confirm" 2019-03-04 14:04:35 +00:00
Takashi NATSUME 5fdcb2ca49 Remove wrong description for auto resize confirm
Remove wrong description for auto resize confirm
in the API guide.
Move a description of a configuration option
'resize_confirm_window' from the API guide
to the admin configuration guide.
Add a description of automatic resize confirm
in the user guide.

Change-Id: If739877422d5743e221c57be53ed877475db0647
Closes-Bug: #1816859
2019-03-03 20:03:09 +00:00
Stephen Finucane 1fae0052f2 conf: Deprecate 'disable_libvirt_livesnapshot' option
This was added to handle gate issues seen with libvirt 1.2.2. We haven't
supported that version of libvirt for some time and we don't enable this
in the gate anymore. Deprecate it and remove unnecessary references to
it from tests and the support FAQ document.

Change-Id: Ie3fa537a42d208a35467f03bd2110c2976927477
2019-02-28 10:37:10 +00:00
Sylvain Bauza 04180e331a FUP: docs nit
Follow-up patch for the reshape series

Part of blueprint reshape-provider-tree
Change-Id: I52247f33faa27a0e0340ea007490302d0fef76ac
2019-02-28 09:49:30 +00:00
Zuul 1a155847a5 Merge "Mention SR-IOV cold migration limitation in admin docs" 2019-02-27 01:47:44 +00:00
Surya Seetharaman 57eb9424b9 [Doc] Best practices for effectively tolerating down cells
Adds a section in the admin guide with the config options related to
down cells.

Related to blueprint handling-down-cell

Change-Id: I6a6cc71e83896aaccd5dd98bc2ea024d6f22d528
2019-02-26 15:54:49 +01:00
Zuul 3b3d0442e4 Merge "Remove deprecated 'os-flavor-manage' policy" 2019-02-15 01:56:08 +00:00
Zuul 3505fde741 Merge "doc: specify --os-compute-api-version when setting flavor description" 2019-02-14 17:05:32 +00:00
Takashi NATSUME dedeff70a7 Remove deprecated 'os-flavor-manage' policy
Remove the 'os_compute_api:os-flavor-manage' policy.
The 'os_compute_api:os-flavor-manage' policy has been deprecated
since 16.0.0 Pike.
The policy has been replaced with the following policies.

- os_compute_api:os-flavor-manage:create
- os_compute_api:os-flavor-manage:delete

Change-Id: I856498dfcebfa330598a22dd7c660bd6f158351b
2019-02-14 15:00:37 +00:00
Zuul 37f3a96a74 Merge "Use :oslo-config: role in hypervisor-kvm doc" 2019-02-14 04:05:31 +00:00
Matt Riedemann bc5ef2ff06 Remove cells v1 (for the most part) from the docs
As discussed in the mailing list [1] since cells v1
has been deprecated since Pike and the biggest user
of it (CERN as far as we know) moved to cells v2
in Queens, we can start rolling back the cells v1
specific documentation to avoid confusing people
new to nova about what cells is and making them
understand there was an optional v1.

There are still a few mentions of cells v1 left in
here for things like adding a new cell which need
to be re-written and for that I've left a todo.

Users can still get at cells v1 specific docs from
published stable branches and/or rebuilding the
docs from before this change.

[1] http://lists.openstack.org/pipermail/openstack-discuss/2019-February/002569.html

Change-Id: Idaa04a88b6883254cad9a8c6665e1c63a67e88d3
2019-02-13 13:59:09 -05:00
Zuul 95287619c9 Merge "doc: link admin/configuration from admin home page" 2019-02-12 08:07:00 +00:00
Zuul 484003ceb5 Merge "doc: update the security groups admin doc" 2019-02-12 08:06:51 +00:00
Zuul 782d742e60 Merge "Drop nova-multiattach job" 2019-02-09 22:46:34 +00:00
Matt Riedemann 8e8834cd47 doc: specify --os-compute-api-version when setting flavor description
This is a follow up to change I0f206d9db70465d8ce6b1404f546f3e00eeb6e23
where we changed the docs from using "nova flavor-update" to
"openstack flavor set --description" but unlike nova CLI which
negotiates the highest available microversion by default, OSC does not
and defaults to 2.1 which won't work when trying to set a flavor
description. This change adds the --os-compute-api-version option
to the command line example to make that command work.

Change-Id: I7eacc30b4cf3a5ef89f90ec599f21eaa12bf2a10
2019-02-07 08:31:36 -05:00
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
Sean Mooney 80ad7d9df6 update flavor admin docs
- This change updates the admin flavor docs
  to reflect the use of osc to update flavor
  descriptions

- This change documents that modifcations to
  flavor extra_specs are not reflected in an
  instance's embedded flavor.

Change-Id: I0f206d9db70465d8ce6b1404f546f3e00eeb6e23
2019-02-06 14:38:56 -05:00
Matt Riedemann e9dd8c0f48 Drop nova-multiattach job
The dependent tempest change enables the volume multiattach
tests in the tempest-full and tempest-slow jobs, on which
nova already gates, which allows us to drop the special
nova-multiattach job which is mostly redundant test coverage
of the other tempest.api.compute.* tests, and allows us to
run one fewer job on nova/cinder/tempest changes in Stein.

The docs are updated to reflect the source of the testing
now.

Also depends on cinder dropping its usage of the nova-multiattach
job before we can drop the job definition from nova.

Depends-On: https://review.openstack.org/606978
Depends-On: https://review.openstack.org/606985
Change-Id: I744afa1df9a6ed8e0eba4310b20c33755ce1ba88
2019-02-05 09:13:02 -05:00
Zuul a62cf91282 Merge "doc: link Kashyap's cpu model talk to the libvirt driver config docs" 2019-02-04 23:27:04 +00:00
Zuul 7997fb68bb Merge "doc: Add solution to live migration ssh issues" 2019-02-04 22:22:46 +00:00
Zuul b7611e8236 Merge "doc: Switch header styles in support doc" 2019-02-04 22:22:38 +00:00
Stephen Finucane 76aea693dc doc: Add solution to live migration ssh issues
This took me a good hour to suss and while there were a couple of Google
hits for it, the top suggestion was to use TCP (rather than SSH) and
disable all security, which is rarely good advice.

Paste an sample error and link to the doc where you can find advice of
resolving the issue.

Change-Id: I3805361834f7d954ae6759a22f61f02db139bcc5
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
2019-02-04 17:35:56 +00:00
Matt Riedemann 14b45dce61 doc: update the security groups admin doc
This makes the following changes:

* re-orders the page to move the nova-network
  specific information to the bottom
* creates two sections: one for CLI and one for
  nova-network
* mentions at the top that by default neutron
  manages security groups and their quota and
  links to the neutron docs
* drops the mention of the 'nova' CLI since there
  are no examples in this doc using that CLI

Change-Id: Ifd23424ac14bacf4bf7a0716c268f48ec869a41e
2019-02-04 11:31:06 -05: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
Matt Riedemann b768496f10 doc: link admin/configuration from admin home page
There is some important stuff in the admin/configuration
docs sub-tree like information about configuring hypervisor
drivers and scheduler filters/weighers but it wasn't easily
found since it wasn't in the admin toc tree. This adds it
to the overall admin home page and adds a TODO that we need
to organize that admin page into sections somehow.

Change-Id: I5952a2dd590407b1ce56805df6f90a472cc878bf
2019-02-04 11:00:03 -05:00
Zuul 5be2638ebb Merge "docs: Update references to "QEMU-native TLS" document" 2019-01-29 17:36:21 +00:00
Zuul 9419c3e054 Merge "Per aggregate scheduling weight" 2019-01-24 19:58:52 +00:00
Zuul 31956108e6 Merge "Cleanup soft (anti)affinity weight multiplier options" 2019-01-22 18:25:15 +00:00
Kashyap Chamarthy 6a61b68c31 docs: Update references to "QEMU-native TLS" document
Link to the "Secure live migration with QEMU-native TLS" document from
other relevant guides, and small blurbs of text where appropriate.

Blueprint: support-qemu-native-tls-for-live-migration

Change-Id: I9c6676897d27254e2e16bf7e36a74bf9f3da3832
Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
2019-01-22 11:09:09 +01: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