Commit Graph

95 Commits

Author SHA1 Message Date
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
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
Radoslav Gerganov d9c03b1ecb VMware: serial console log (completed)
Commit ace11d3 adds a serial port device to instances, so the serial
console output can be sent to a virtual serial port concentrator (VSPC).
This patch finishes the implementation by returning the output saved by
VSPC to the end user. The config option 'serial_log_dir' should have the
same value as in the VSPC configuration (i.e. it must point to the same
directory).

The VSPC implementation is available at
https://github.com/openstack/vmware-vspc

blueprint vmware-console-log-complete

Change-Id: I7e40dc41b0354d414bc8eae331f8257959e1d123
2017-11-17 16:10:26 +02:00
Matt Riedemann 3fc85389e5 Import user-data page from openstack-manuals
This imports the "provide-user-data-to-instances" page
from the old openstack-manuals user guide.

Since we don't have a glossary, the :term: link is removed
and replaced with just giving the glossary definition as
the first part of the doc.

Change-Id: Iae70d9b53d6cefb3bcb107fe68499cccb71fc15e
Partial-Bug: #1714017
2017-10-24 12:22:34 -04:00
Matt Riedemann 59bd2f6adc Import the config drive docs from openstack-manuals
As part of the docs migration from openstack-manuals to
nova in the pike release we missed the config-drive docs.

This change does the following:

1. Imports the config-drive doc into the user guide.
2. Fixes a broken link to the metadata service in the doc.
3. Removes a note about liberty being the current release.
4. Adds a link in the API reference parameters to actually
   point at the document we have in tree now, which is
   otherwise not very discoverable as the main index does
   not link to this page (or the user index for that matter).

Partial-Bug: #1714017
Closes-Bug: #1720873

Change-Id: I1d54e1f5a1a94e9821efad99b7fa430bd8fece0a
2017-10-24 12:22:11 -04:00
Jenkins a6eadd8e30 Merge "doc: Add documentation for cpu_realtime, cpu_realtime_mask" 2017-10-05 10:03:23 +00:00
Jenkins 792868cef4 Merge "[placement] Update the placement deployment instructions" 2017-10-04 20:26:56 +00:00
Jenkins 4e62b38fa1 Merge "Fix inconsistency of 'NOTE:' description" 2017-10-04 20:17:27 +00:00
Jenkins 659b63d84b Merge "fix nova accepting invalid availability zone name with ':'" 2017-10-04 18:54:23 +00:00
Stephen Finucane bd3a4d242f doc: Add documentation for cpu_realtime, cpu_realtime_mask
This wasn't documented anywhere but the spec [1]. Fix this.

We may want to provide a more in-depth overview of using RT features of
OpenStack, but that's a future work item.

[1] https://specs.openstack.org/openstack/nova-specs/specs/mitaka/implemented/libvirt-real-time.html

Change-Id: Id30bc8447a6b482ad114ec6ebd3d5dab20ca0e3a
Closes-Bug: #1715437
2017-10-04 09:43:22 +01:00
Chris Dent 3a9afe608f [placement] Update the placement deployment instructions
The web-server-deployment section of placement.rst has been updated
to provide additional links to information and reflect the fact that
placement is now using uwsgi and mod_proxy_uwsgi in devstack. This
does not provide a full set of installations instructions. This is
somewhat intentional:

* there are many ways to deploy a wsgi application and we'd like the
  packagers and deployers to choose a way that works best for them,
  not impose one, and there's no way for us to document them all. It
  is better to point to resources that explain some of the options
  and allow people to inform themselves so they can make informed
  choices
* we're no longer that keen on the mod_wsgi, but it tends to be the
  easiest to document (fewer moving parts)
* the uwsgi+systemd method in devstack, while great, is abstracted
  enough that the moving parts are not entirely visible and is one
  of several ways for that scenario

Change-Id: Ief07c313e012df63558de632047258e8e11736c1
Related-Bug: #1692375
2017-09-28 14:47:08 +00:00
Takashi NATSUME 48eb371e62 Fix inconsistency of 'NOTE:' description
Use the 'note' directive.

TrivialFix
Change-Id: If342940f8cc64591778ad21ce6cccbe006c0145b
2017-09-28 16:28:49 +09:00
Matt Riedemann 7db0e3c2b6 doc: make host aggregates examples more discoverable
When one is looking for an explanation and examples of
how to associate host aggregates to flavors, it's useful
to be able to point to that from the more top-level
aggregates page, which is linked from the main home page.

This change links from that to a somewhat buried reference
doc on host aggregates, which is actually really useful here.

Change-Id: I9e03c6649afd9a7aa816b9af1d931f9e0cffb94a
2017-09-27 14:58:37 -04:00
Tetsuro Nakamura 38b25397e8 fix nova accepting invalid availability zone name with ':'
Nova has a legacy hack to allow admins to specify hosts via an
availability zone using az:host:node. That means ':' cannot be
included in the name of an availability zone itself.

However, the aggregate API accepts requests which have
availability zone names including ':'.

This patch checks the availabilty zone name when aggregate is
created or updated and raises an error if it contains ':'.

Change-Id: I9b0d8e8d4b3ab2cb3d578c22fa259e0e7c0d325b
Closes-Bug: #1695861
2017-09-24 15:12:43 +09:00
Stephen Finucane 2f36a355f2 docs: Rename cellsv2_layout -> cellsv2-layout
Underscores make for really ugly URLs and every other document here is
now using hyphens for this very reason. Let's try to keep that going.

Change-Id: I5c99ff6b04ee97bac210a0d6762015225775c5ee
2017-09-22 15:56:44 +01:00
Stephen Finucane 0b77e3cdd8 doc: Add documentation for emulator_thread_policy
This wasn't documented anywhere but the spec [1]. Fix this.

We may want to provide a more in-depth overview of using RT features of
OpenStack, but that's a future work item.

[1] https://specs.openstack.org/openstack/nova-specs/specs/ocata/approved/libvirt-emulator-threads-policy.html

Change-Id: I8d79e1f1277fea9a070790a99bebcefe22bed433
Partial-Bug: #1715437
2017-09-20 14:06:43 +01:00
Stephen Finucane a76277f81a doc: Split flavors docs into admin and user guides
There are currently two docs describing flavors in 'admin', which
contain a lot of overlapping information. Fix this by keeping the
configuration guide (how to create, delete, modify flavors) in
'admin', while moving the reference-style parts into 'user'. We
cross-reference the two internally.

Given that large chunks of this needed to be rewritten, we've taken the
opportunity to fix a poor description for the RXTX factor, closing a
longstanding bug in the process.

Change-Id: Ia57c93ef1e72ccf134ba6fc7fcb85ab228d68a47
Closes-Bug: #1688054
2017-09-20 14:06:41 +01:00
Jenkins 8ff61dc4b1 Merge "Document tagged attach in the feature support matrix" 2017-09-10 17:13:23 +00:00
Andreas Jaeger 4e6eec5c9b Fix broken URLs
Fix broken nova URLs that linked to the old developer/nova places and
use the new link instead.

Change-Id: Ideb50626e140201dded19fc82584440f1a407e47
2017-09-07 15:42:31 +02:00
Andreas Jaeger 289fcea89e Fix broken link
It's "configuration" in the URL - the current link gives a 404. Also,
add "." at end of sentence.

Change-Id: I6cda57f0d7027a2b697b9a562cc13d0821428cbc
2017-09-06 21:33:15 +02:00
Jenkins 1389522c68 Merge "doc: Add user index page" 2017-09-06 19:07:43 +00:00