Commit Graph

114 Commits

Author SHA1 Message Date
Matt Riedemann 43f91a87cb Re-work the metadata service docs
The metadata service docs were hard to find since they were nested
down in some nova-network admin guide docs, and they were a mix of
end user and admin deployment guide information.

This change splits out the end-user facing content into a user
guide and leaves the deployment-specific information in the admin
guide, and links are updated appropriately.

The admin guide portion also referenced some config options that no
longer exist, so those are also removed and vendordata_providers
is added with a link to the vendordata guide. The options themselves
are cleaned up for their current groups and linked to the config option
docs.

Change-Id: I66035366f3a7ca62ea12d6afa74d13db01ec9f8d
2018-03-08 11:54:41 -05:00
Zuul ee66ad484a Merge "Remove warning in feature support matrix page" 2018-03-01 12:56:11 +00:00
Sylvain Bauza 9526802915 doc: Clarify how to create your own filter
The filter-scheduler doc was pretty old and I was recently asked to give
some guidance on how to create a custom filter.
A doc is better than any chat, so let's make that better.

Change-Id: I64d24fb4337bb8c1e59a04818307b43f181e2ad2
2018-02-15 11:30:32 +01:00
Matt Riedemann 6a67861c44 Remove warning in feature support matrix page
The feature classification effectively died with OSIC, so
let's remove the warning from the page as it's actively
maintained.

Change-Id: I6e601759f6e26d2c9b94229be953490a8342709a
2018-02-13 12:27:06 -05:00
Zuul bfa9e2598a Merge "Fix docs for IsolatedHostsFilter" 2018-02-12 18:08:41 +00:00
Matt Riedemann 60bbec15ed Fix docs for IsolatedHostsFilter
The docs were using variable names from the filter code rather
than the actual config options.

Change-Id: I2694b32e9c90ad098101e41e4e3ae36ddafd8d0f
Related-Bug: #1746483
2018-02-11 17:23:38 -05:00
Marcin Juszkiewicz 30b7a566aa Provide basic data for AArch64 support matrix/functionality
Nova has two pages in documentation listing things supported on several
architectures/hypervisors. This patch adds initial state of AArch64
into support matrix.

Document minimal qemu/libvirt for aarch64. Version 3.6.0 was first one
which worked for us with Nova without a need for extra patches.

Change-Id: I2ee7be9e88e20ed0f77be07fed4fdd800533b3c5
2018-02-09 18:55:23 +00:00
Zuul e8e8fe4eef Merge "Fix wrong link for "Manage Flavors" in CPU topologies doc" 2018-02-07 05:07:33 +00:00
Zuul b37aa54153 Merge "Add late server group policy check to rebuild" 2018-02-07 03:46:34 +00:00
Zuul f622df7c82 Merge "docs: Add booting from an encrypted volume" 2018-02-07 00:44:22 +00:00
Zuul 593e73fb87 Merge "Add PowerVM to feature-classification" 2018-02-06 21:16:02 +00:00
Balazs Gibizer edeeaf9102 Add late server group policy check to rebuild
The affinity and anti-affinity server group policy is enforced by the
scheduler but two parallel scheduling could cause that such policy is
violated. During instance boot a late policy check was performed in
the compute manager to prevent this. This check was missing in case
of rebuild. Therefore two parallel evacuate command could cause that
the server group policy is violated. This patch introduces the late
policy check to rebuild to prevent such situation. When the violation
is detected during boot a re-scheduling happens. However the rebuild
action does not have the re-scheduling implementation so in this case
the rebuild will fail and the evacuation needs to be retried by the
user. Still this is better than allowing a parallel evacuation to
break the server group affinity policy.

To make the late policy check possible in the compute/manager the
rebuild_instance compute RPC call was extended with a request_spec
parameter.

Co-Authored-By: Richard Zsarnoczai <richard.zsarnoczai@ericsson.com>

Change-Id: I752617066bb2167b49239ab9d17b0c89754a3e12
Closes-Bug: #1735407
2018-02-06 13:54:12 +01:00
Yikun Jiang 26de90a14d Fix wrong link for "Manage Flavors" in CPU topologies doc
The last sentence here where it links to "Manage Flavors"
is the wrong link. It goes here:
https://docs.openstack.org/nova/latest/admin/flavors.html which
doesn't talk about NUMA extra specs. It should be pointing at
the "NUMA topology" section of the flavor extra specs page:
https://docs.openstack.org/nova/latest/user/flavors.html#extra-specs-numa-topology

Change-Id: I30f6bc70afc5be00737cdf76e0e47bcb898a3a7f
Closes-Bug: #1747562
2018-02-06 17:33:10 +08:00
Zuul 58328627f5 Merge "Update cells v2 layout doc caveats for Queens" 2018-02-05 17:44:18 +00:00
Sylvain Bauza d133590e8b Provide support matrix and doc for VGPU
Now that Queens supports attaching virtual GPUs to an instance, we need to
properly document which hypervisors support that, how to use that feature and
what the existing caveats are.

Co-Authored-By: Matt Riedemann <mriedem.os@gmail.com>

Change-Id: I871894c3584e92f80f6420dfc009e21b30450f8e
Implements: blueprint add-support-for-vgpu
2018-02-05 08:13:30 +00:00
Matt Riedemann a0ee6b8c9e doc: update the GPU passthrough HPC feature entry
This updates some busted links, adds ironic and powervm to the
table header, and copies a description from the admin guide.

Change-Id: If146a26a8d0c66a3ff218c62624e3a130744dde5
2018-02-05 08:13:05 +00:00
Matt Riedemann 4ac7ef26ce Update cells v2 layout doc caveats for Queens
The instance list performance and reschedules issues have
been fixed in Queens so this updates the caveats section
of the cells v2 layout doc to point out those changes since
Pike.

Change-Id: I882f185554b6d2781534fa93e41e5010ea3a641d
2018-02-04 12:03:27 -05:00
Bruce Benjamin efb966ad64 docs: Add booting from an encrypted volume
Now that the instructions for booting from a volume
have been migrated to nova, the instructions for
booting from an encrypted volume can be added as
well.

This commit adds instructions for how to import an
image into an encrypted volume.

Closes-Bug: 1701614

Change-Id: Ida4cf70a7e53fd37ceeadb5629e3221072219689
2018-02-02 15:41:28 -05:00
Zuul 8ac8c995ca Merge "doc: placement upgrade notes for queens" 2018-02-02 09:55:58 +00:00
Zuul b7de3eca6d Merge "Cleanup launch instance and manage IPs docs" 2018-02-02 03:40:45 +00:00
Zuul 0432555adb Merge "Migrate "launch instance" user guide docs" 2018-02-02 03:40:33 +00:00
Matt Riedemann b06895f030 doc: placement upgrade notes for queens
This adds a mention of the nova-scheduler service requiring
placement 1.17 and also links to the placement upgrade notes
from the more general upgrade notes, since we are now firmly
in a place where placement needs to be upgraded before nova.

Since we consider placement global, this removes the 1.14
note about nova-compute since we assume that if you're going
to upgrade placement to get 1.17 for the scheduler, and control
services should be upgraded before computes, then the computes
are going to get a new enough placement service automatically.

Change-Id: I06937c7642dca4a1932cbbf46569acc9c58e44a6
2018-02-01 17:17:57 -05:00
Zuul fa6f0bb2ec Merge "Mention required traits in the flavors user docs" 2018-02-01 21:25:55 +00:00
Matt Riedemann 49b1bf8c54 Cleanup launch instance and manage IPs docs
This is a follow up to Ie039322660fd0e2e0403843448379b78114c425b.

A few things are changed here:

* The note about using file injection is removed. File injection
  was deprecated in the API in Queens and not something that we
  really want users using.
* Mention that creating a flavor is typically admin-only.
* Link to the BDM docs for more details about BDM parameter values.
* Update the manage-ip-address docs to make the examples rely on
  using the networking resource CLIs rather than any proxy APIs
  that were available in nova.

Change-Id: Ifa2e2bbb4c5f51f13d1a5832bd7dbf9f690fcad7
2018-02-01 15:12:10 -05:00
Matt Riedemann 4ed5e81ee0 Migrate "launch instance" user guide docs
This imports the "launch instance" end user guide docs from
the openstack-manuals repo. As part of the docs migration
in Pike, these were forgotten. The copied contents come from
the stable/ocata branch of openstack-manuals, and therefore
likely need some updating, but that could be done in follow up
changes. This is an initial import to (1) publish the content
again somewhere and (2) fix broken links in the cinder docs
for booting from volume.

Change-Id: Ie039322660fd0e2e0403843448379b78114c425b
Partial-Bug: #1714017
Related-Bug: #1711267
2018-02-01 14:28:18 -05:00
Matt Riedemann 3e9a631ec8 Mention required traits in the flavors user docs
This takes most of the release note and adds it to the user
flavor docs which is more discoverable for an end user.

Change-Id: Ia83af4dfcc0c040679b0d0cd5282830fca27bd63
2018-01-31 11:07:12 -05:00
Zuul 5de8969ffe Merge "Add exception to no-upcall note of cells doc" 2018-01-27 11:32:19 +00:00
esberglu 32353b3671 Add PowerVM to feature-classification
This adds the PowerVM nova virt driver to the feature-classification
documentation.

Change-Id: Ie296b723408ab420c6cac072d230653c5de32faa
2018-01-22 21:02:56 +00:00
Ildiko Vancsa 7e6ae9afd9 [api] Allow multi-attach in compute api
This change introduces a new microversion which must be used
to create a server from a multiattach volume or attach a multiattach
volume to an existing server instance.

Attaching a multiattach volume to a shelved offloaded instance is not
supported since an instance in that state does not have a compute host
so we can't tell if the compute would support the multiattach volume
or not. This is consistent with the tagged attach validation with 2.49.

When creating a server from a multiattach volume, we'll check to see
if all computes in all cells are upgraded to the point of even supporting
the compute side changes, otherwise the server create request fails with
a 409. We do this because we don't know which compute node the scheduler
will pick and we don't have any compute capability filtering in the
scheduler for multiattach volumes (that may be a future improvement).

Similarly, when attaching a multiattach volume to an existing instance,
if the compute isn't new enough to support multiattach or the virt
driver simply doesn't support the capability, a 409 response is returned.
Presumably, operators will use AZs/aggregates to organize which hosts
support multiattach if they have a mixed hypervisor deployment, or will
simply disable multiattach support via Cinder policy.

The unit tests are covering error conditions with the new flow. A new
functional scenario test is added for happy path testing of the new boot
from multiattach volume flow and attaching a multiattach volume to more
than one instance.

Tempest integration testing for multiattach is added in change
I80c20914c03d7371e798ca3567c37307a0d54aaa.

Devstack support for multiattach is added in change
I46b7eabf6a28f230666f6933a087f73cb4408348.

Co-Authored-By: Matt Riedemann <mriedem.os@gmail.com>

Implements: blueprint multi-attach-volume
Change-Id: I02120ef8767c3f9c9497bff67101e57e204ed6f4
2018-01-22 10:45:13 -05:00
David Rabel 2181335027 Fix format in flavors.rst
Insert newline, so that '.. code:: console' tag is parsed correctly.

Change-Id: Ia1b6c2d506077861f9f2a09a8bdc632a2d5e309b
2018-01-19 15:14:06 +01:00
Zuul c03bbc142f Merge "PowerVM driver: ovs vif" 2018-01-17 18:15:26 +00:00
Qing Wu Wang a31d6b02fc PowerVM driver: ovs vif
This change set adds Open vSwitch VIF support for the PowerVM virt
driver.

Change-Id: If23aeb890c4365014a9f1262647611162f981f12
Partially-Implements: blueprint powervm-nova-it-compute-driver
2018-01-16 19:02:25 -06:00
Zuul 2f52bbc0ab Merge "Update FAQs about listing hosts in cellv2" 2018-01-12 20:40:22 +00:00
Liam Young 30786b892e Add exception to no-upcall note of cells doc
The cells v2 layout documentation clearly states that there are no
upcalls from cells back to the central API services. This mislead
me for sometime as I could not fathom how a compute node in a cell
was supposed to report its resource info.

It turns out nova looks up the placement service in the keystone
catalogue and contacts it directly which to my mind is an upcall. I
wonder if the author of the not felt that the placement service is
not really part of nova?

Change-Id: If14be8b182f0af4e4e6641046fec638c07e26546
Closes-Bug: #1742421
2018-01-10 11:10:57 +00:00
Hongbin Lu df219f666c Update FAQs about listing hosts in cellv2
Document the ``nova-manage cell_v2 list_hosts`` command for listing
hosts in one or all v2 cells.

Change-Id: I46fece55f1647fe7a41906054ad0d6213315187b
Related-Bug: #1735687
2018-01-06 15:08:17 +00:00
Zuul 2281532d0e Merge "Delete the TypeAffinityFilter" 2017-12-21 04:51:12 +00:00
Zuul 024ebdccb5 Merge "Update nova-status and docs for nova-compute requiring placement 1.14" 2017-12-19 22:23:47 +00:00
Matt Riedemann ed3c69cb45 Delete the TypeAffinityFilter
Deprecated in Pike:

  I660e0316b11afcad65c0fe7bd167ddcec9239a8b

This filter relies on the flavor.id primary key which will
change as (1) flavors were migrated to the API database and
(2) when a flavor is changed by deleting and re-creating the
flavor.

Also, as noted in blueprint put-host-manager-instance-info-on-a-diet,
this is one step forward in getting us to a point where the only
thing that the in-tree filters care about in the HostState.instances
dict is the instance uuid (for the affinity filters). Which means
we can eventually stop RPC casting all instance information from
all nova-compute services to the scheduler for every instance create,
delete, move or periodic sync task - we only would need to send the
list of instance UUIDs. That should help with RPC traffic in a large
and busy deployment.

Change-Id: Icb43fe2ef5252d2838f6f8572c7497840a9797a1
2017-12-14 17:09:56 -05:00
Zuul 63a038fab9 Merge "Fix some typos in nova doc" 2017-12-14 21:31:53 +00:00
Zuul 6a09908757 Merge "doc: link in some Sydney summit content" 2017-12-14 14:26:19 +00:00
zhufl 915bd8f829 Fix some typos in nova doc
There are some typos in nova doc:
  affinty
  runnning
  containts
  abolute

This is to fix them.

Change-Id: I18e61e41fd31af4885b449dff3f6988b4bc3065b
2017-12-14 12:49:49 +08:00
Matt Riedemann 4b7a150584 Update nova-status and docs for nova-compute requiring placement 1.14
With change I2f367b06e683ed7c815dd9e0536a46e5f0a27e6c, nova-compute
now unconditionally requires Placement 1.14 to be available (the
client side code doesn't check to see if 1.14 is available before
trying to use it).

This change updates the nova-status check for the minimum required
version of Placement and also starts the "Queens" section of the
Placement upgrade notes docs.

Change-Id: I37415e384d375bc9b548a0223f787a9236286bb0
2017-12-13 15:18:27 -05:00
jichenjc f5dab6e379 Add quiesce and unquiesce in support matrix
quiesce and unquiesce are virt driver and supported in libvirt
we need document those functions into the support matrix
to let admin/user be able to refer to.

Change-Id: If1277cde2aff44b5651154fc05c3cd4377237c60
2017-12-11 08:27:05 +00:00
Matt Riedemann 1772abbb52 doc: link in some Sydney summit content
This adds some links to talks from the Sydney summit to the docs
for cells v2, bug triage, and the metadata service.

While adding a "References" section to the metadata docs, I figured
it was also useful to link to a blog post from mikal about vendordata
since it also includes code samples.

Change-Id: Ifc47a5472db37f5526004d2e00751365a026975a
2017-12-07 22:27:50 -05:00
Zuul 690f8e4e24 Merge "Remove deprecated TrustedFilter" 2017-11-29 20:05:26 +00:00
Zuul 7e2d8cb89b Merge "PowerVM support matrix update" 2017-11-29 06:41:57 +00:00
zhangyangyang aecc165a58 Remove deprecated TrustedFilter
The TrustedFilter and the related trusted_computing config options
were deprecated in Pike:

  If6e53feeb97e6050c1eb7962110ed89504c952fc

Co-Authored-By: Matt Riedemann <mriedem.os@gmail.com>

Change-Id: I0a7ab3a4fb2cfad567a8644bed4de574393ee11a
2017-11-28 14:54:31 -05:00
Zuul 114817560b Merge "Update document related to host aggregate" 2017-11-28 15:26:28 +00:00
esberglu 948517756f PowerVM support matrix update
This updates the config drive status to complete for PowerVM [1]. It
also updates the status for PowerVM features previously classified as
unknown.

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

Change-Id: Idc5e40f2473d27c31c5a620ad9b93cce01dc7f85
2017-11-27 08:52:56 -06:00
Takashi NATSUME fa43227f6e Update document related to host aggregate
The arguments of nova CLI commands related to host aggregate
(I93f44a12b6d5a91b448f6f8d238311d58bf40c01) are fixed.
The host APIs have been deprecated since microversion 2.43.
So remove description related to nova host commands.
And add description about nova hypervisor commands.

Change-Id: Ibf78865844da6f007b610f12430df4866076f00b
Closes-Bug: #1726658
2017-11-21 02:01:40 +00:00