Commit Graph

1372 Commits

Author SHA1 Message Date
Zuul fdf50a1a62 Merge "cleanup mapping/reqspec after archive instance" 2017-11-21 19:04:28 +00:00
Surya Seetharaman 32fd58813f cleanup mapping/reqspec after archive instance
This patch aims at deleting the records of the archived instances from
the instance_mappings and request_specs tables in the API database
immediately following their archival from instances to shadow_instances
table. So upon running the 'nova-manage db archive_deleted_rows' command
the records of the archived instances will be automatically removed from
the instance_mappings and request_specs tables as well. A warning has
also been added to fix the issue of 'nova-manage verify_instance'
returning a valid instance mapping even after the instance is deleted.

The patch also adds InstanceMappingList.destory_bulk() and
RequestSpec.destroy_bulk() methods for ease of bulk deletion of records.

Change-Id: I483701a55576c245d091ff086b32081b392f746e
Closes-Bug: #1724621
Closes-Bug: #1678056
2017-11-21 15:28:07 +01:00
Zuul 1da7510aeb Merge "Add a note about versioned notification samples being per-release" 2017-11-21 12:27:09 +00:00
Zuul 82217e6308 Merge "Using --option ARGUMENT" 2017-11-21 12:26:50 +00:00
Zuul 190579d19a Merge "Fix format in live-migration-usage.rst" 2017-11-21 12:26:44 +00:00
Zuul f7da17b8e3 Merge "[placement] Fix a wrong redirection in placement doc" 2017-11-21 12:23:07 +00:00
Zuul 9633ebdf37 Merge "VMware: serial console log (completed)" 2017-11-21 10:57:15 +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
Zuul b28924b8e4 Merge "doc: fix link to creating unit tests in contributor guide" 2017-11-16 10:35:01 +00:00
Matt Riedemann 94ca0b9023 Add a note about versioned notification samples being per-release
The example versioned notifications don't have any indication of
which release they are available in, and since people can link to
the 'latest' docs, like in I51d0deffc4f42ff2722a8d21aa6b8c8008c62723,
it's important to note that the samples in the latest docs might not
be in the version of nova one is actually using, e.g. ocata or pike.

So this adds a note that people should be aware of that before
relying on some versioned notification.

Change-Id: I2f7db424f0938667895b51f45ea60862a32e22c1
2017-11-15 20:42:06 +00:00
Zuul 6535abdaaa Merge "Fix indent in configuring-migrations.rst" 2017-11-15 20:30:26 +00:00
Matt Riedemann 85235d229b doc: fix link to creating unit tests in contributor guide
The testing strategy doc was linking to the hacking repo docs
on creating unit tests, which are very specific to creating
unit tests for hacking rules.

This changes the link to the 'creating unit tests' section in
the HACKING.rst file, which has more information on testing
within nova.

Along with that change, the HACKING.rst testing section is
updated a bit to point out that we use stestr now instead of
testr and adds a proper link to the development environment
quickstart docs.

The nova/tests/unit/README.rst actually needs a lot of work,
but that's left for another day.

Change-Id: Ie5106d87d632286162b31ce132e947c306d21abd
Closes-Bug: #1732024
2017-11-14 11:22:43 -05:00
Zuul 93d2c5e168 Merge "placement: Contributor doc microversion checklist" 2017-11-13 16:42:04 +00:00
Takashi NATSUME e69f0f1d95 [placement] Fix a wrong redirection in placement doc
Change-Id: I9f404838c36618f5d632c6fb77b69287263f2611
2017-11-06 23:44:05 +00:00
Luong Anh Tuan fb9e4ca578 Using --option ARGUMENT
The OpenStack CLI commands support both --option ARGUMENT and --option=ARGUMENT.
In technical publications, use --option ARGUMENT.[1]

[1]https://docs.openstack.org/doc-contrib-guide/writing-style/code-conventions.html

Change-Id: Ifbf44c2bd9d7bec9308c6fb2c0340fb48811a653
2017-11-06 00:45:13 +00:00
Eric Fried 3e55e77609 Update contributor microversion doc for compute
In the microversion contributor doc, refresh the checklist for creating
a new microversion.

- Remove reference to "doc team"
- Add bullet about release note
- Add bullet for updating the API reference

Change-Id: I81a8cd68792f06738ee9709d07d557a37367a806
2017-11-03 14:22:18 +00:00
Eric Fried ab5e2e00d2 placement: Contributor doc microversion checklist
I put out a new placement microversion [1] and initially missed updating
the API reference documentation [2].  I'd like to say it would have
helped if the checklist in the Microversion section of the contributor
doc had been up to date, except I didn't even know about that document
at the time.  Anyway, this change set adds that bullet - and I'll know
to refer to it next time.

[1] https://review.openstack.org/499826
[2] https://review.openstack.org/515748

Change-Id: Id0329d9824eeb1d210defe0567286372b72cb1cf
2017-10-31 15:07:57 -05:00
David Rabel 1d81fc891e Fix format in live-migration-usage.rst
It is :command:`some_command` instead of :command:``some_command``.

Change-Id: I8300c55a247d30cb9db93e5025d79d0fdc24cf5e
2017-10-31 12:40:10 +00:00
David Rabel 95c3eeb9be Fix indent in configuring-migrations.rst
Change-Id: Iec2f9b5b497a552c407d75278b0cd3c4c0a8deb6
2017-10-28 16:19:45 +02:00
Zuul e4c96de821 Merge "Import user-data page from openstack-manuals" 2017-10-26 01:04:50 +00:00
Zuul a921ebfd5c Merge "Import the config drive docs from openstack-manuals" 2017-10-26 01:04:44 +00: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
Michael Still 3f7995f586 Move the idmapshift binary into privsep.
I can't see any evidence that anyone else uses our nova-idmapshift
binary, and it adds a lot of complexity (flags we never call for
example). Move the code we do actually use into the privsep
directory and simplify our calls to it. Remove the extra binary
from our install and documentation.

Change-Id: Ibce28d20d166da154833376cf51f1877b829925e
blueprint: hurrah-for-privsep
2017-10-24 18:50:23 +11:00
Zuul fb4e6900e1 Merge "Remove doc todo related to bug/1506667" 2017-10-20 22:39:42 +00:00
Takashi NATSUME f4f17b364e Add 'delete_host' command in 'nova-manage cell_v2'
Add 'delete_host' command in 'nova-manage cell_v2'.
Add an optional 'force' option in 'nova-manage cell_v2 delete_cell'.
If specifying the 'force' option, a cell can be deleted
even if the cell has hosts.

Change-Id: I8cd7826c2c03687c6b85731519778f09d542b236
Closes-Bug: #1721179
2017-10-19 01:31:02 +00:00
Markus Zoeller 19f0acd960 docs: Explain the flow of the "serial console" feature
The serial console feature is a little unknown and it's a little
confusing at first. This change adds a doc to explain this better.

Change-Id: Ia5a336694aec95db29545e31b2c6b364dd825a15
2017-10-18 13:39:57 +00:00
Zuul 06b8ebd56c Merge "doc: Fix command output in scheduler document" 2017-10-17 01:56:17 +00:00
Zuul 4668026a56 Merge "doc: Rework man pages" 2017-10-16 19:05:59 +00:00
evikbas aff78ac53e doc: Fix command output in scheduler document
Change-Id: If2fe3dcac8d32d8a3f83f4db8e2a0b41ac15e888
Closes-Bug: #1723120
2017-10-16 09:21:11 +00:00
Balazs Gibizer 0d4c3cc65b Remove dead code of api.fault notification sending
Based on the description of the notify_on_api_faults config option [1]
and the code that uses it [2] nova sends and api.fault notification
if the nova-api service encounters an unhandle exception.
There is a FaultWrapper class [3] added to the  pipeline of the REST
request which catches every exception and calls the notification sending.

Based on some debugging in devstack this FaultWrapper never catches any
exception. Every REST API method is decorated with expected_errors
decorator [5] which as a last resort translate the unexpected exception
to HTTPInternalServerError. In the wsgi stack the actual REST api call is
guarded with ResourceExceptionHandler context manager [7] which translates
HTTPException to a Fault [8]. Then Fault is catched and translated to
the REST response [7]. This way the exception never propagates back to
the FaultWrapper and therefore the api.fault notification is never emitted.

Based on the git history of the expected_errors decorator this notification
was never emitted for v2.1 API and as the v2.0 API now supported with the
same codebase than v2.1 it is not emitted for v2.0 calls either. As nobody
reported a bug I assume that nobody tried to use this notification for a very
long time. Therefore instead of fixing this bug this patch propses to remove
the dead code.

See a bit more detailed description on the ML [9].

[1] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/conf/notifications.py#L49
[2] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/notifications/base.py#L84
[3] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/api/openstack/__init__.py#L78
[5] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/api/openstack/extensions.py#L325
[7] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/api/openstack/wsgi.py#L637
[8] https://github.com/openstack/nova/blob/0aeaa2bce8ad15bc2f28e00b30d688514b992e13/nova/api/openstack/wsgi.py#L418
[9] http://lists.openstack.org/pipermail/openstack-dev/2017-June/118639.html

Change-Id: I608b6ebdc69d31eb2a11ac6479fa4f2e8c20f7d1
Closes-Bug: #1699115
2017-10-09 17:29:40 +02:00
Stephen Finucane 3a6e1e2396 doc: Rework man pages
Rework the man pages by:

- Wording the synopsis sections similarly for all commands
- Not using upper-case section names, as this is unnecessary and results
  in worse HTML output
- Formatting code and file names as literals

The 'nova-idmapshift' man page is excluded as this utility will be
removed shortly.

Change-Id: I67914a757f9436461960a8d6b92d157f59ccad66
2017-10-09 16:08:40 +01:00
Matt Riedemann 7055b5305c Note TrustedFilter deprecation in docs
Change 82f16b88f3 deprecated
the TrustedFilter for removal in Queens, but there is an
entire document about using it which doesn't mention this,
so it's noted here.

Change-Id: I4f772a50cfdbc1f50759c67b234e5c7e29e81100
2017-10-05 18:47:40 -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
Ken'ichi Ohmichi bf090ab0d6 Remove doc todo related to bug/1506667
As the bug report 1506667, the bug has been fixed already since 2016-11-22.
In addition, the bug is just kind of reminder to avoid forgetting to
include example config files of upstream in ubuntu packages.
That[1] makes readers confused, so let's just remove it.

[1]: https://docs.openstack.org/nova/pike/install/controller-install-ubuntu.html#install-and-configure-components

Change-Id: I793d58dbc6bad097c772f7715430e75d74521253
Related-bug: #1506667
2017-10-03 17:15:04 -07: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
Jenkins ae4b5d0147 Merge "doc: make host aggregates examples more discoverable" 2017-09-28 03:28:18 +00: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
Eric Fried 6e2d001597 _rollback_live_migration in live-migration seqdiag
Add the _rollback_live_migration call on the source as the first thing
that happens on failed driver.live_migration.

Change-Id: I5db474a072ad12d48f496dcc26c99ea73c90cb66
2017-09-27 09:16:08 -05:00
jolie c7b3a2457c Remove SCREEN_LOGDIR from devstack install setting
Screen support has been completely removed from devstack.
So we should remove this setting.

Change-Id: I574b5d5020edc87cebcc9e10daa9a12a493f9039
2017-09-26 16:27:29 +08:00
Jenkins f5031c3f56 Merge "Live Migration sequence diagram" 2017-09-26 06:45:51 +00:00
Eric Fried f839a97e0f Live Migration sequence diagram
Based on mriedem's hand-drawn version [1] (but not as pretty).

[1] https://photos.google.com/share/AF1QipNpWVQKU8GK4_9wxVbiRJUqJnMzqPcBh6DvjVyBPIjjmi6ZU8r9TleQNo6pV1t9SA?key=NUl3OUFGYkRFTE8tMHhSX0lfc0Y1eEdoeHo4SUhn

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

Change-Id: I63046079cd3135b4b19c0c6745075f090d04e396
2017-09-25 16:19:44 +00:00
Jenkins ef0f6341f4 Merge "Add PowerVM hypervisor configuration doc" 2017-09-25 12:25:02 +00: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