OpenDev Migration Patch

This commit was bulk generated and pushed by the OpenDev sysadmins as a part of the Git hosting and code review systems migration detailed in these mailing list posts: http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html Attempts have been made to correct repository namespaces and hostnames based on simple pattern matching, but it's possible some were updated incorrectly or missed entirely. Please reach out to us via the contact information listed at https://opendev.org/ with any questions you may have.
Replace openstack.org git:// URLs with https://
2019-04-19 19:40:46 +00:00 · 2019-03-24 20:36:26 +00:00 · 2018-12-10 13:55:44 +00:00 · 2018-11-06 13:39:14 +00:00 · 2018-10-16 08:37:45 +00:00 · 2018-09-21 12:31:04 +00:00
372 changed files with 4654 additions and 13967 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -23,10 +23,11 @@ pip-log.txt
 # Unit test / coverage reports
 .coverage*
 .tox
+nosetests.xml
 .stestr/
+.testrepository
 .venv
 .idea
-.testrepository/

 # Translations
 *.mo
@@ -75,6 +76,3 @@ releasenotes/build

 # Autogenerated sample config file
 etc/watcher/watcher.conf.sample
-
-# Atom
-.remote-sync.json
--- a/.gitreview
+++ b/.gitreview
@@ -2,4 +2,4 @@
 host=review.opendev.org
 port=29418
 project=openstack/watcher.git
-defaultbranch=stable/stein
+defaultbranch=stable/queens
--- a/.stestr.conf
+++ b/.stestr.conf
@@ -1,4 +1,4 @@
 [DEFAULT]
-test_path=./watcher/tests
+test_path=${OS_TEST_PATH:-./watcher/tests}
 top_dir=./

--- a/.testr.conf
+++ b/.testr.conf
@@ -0,0 +1,7 @@
+[DEFAULT]
+test_command=OS_STDOUT_CAPTURE=${OS_STDOUT_CAPTURE:-1} \
+             OS_STDERR_CAPTURE=${OS_STDERR_CAPTURE:-1} \
+             OS_TEST_TIMEOUT=${OS_TEST_TIMEOUT:-160} \
+             ${PYTHON:-python} -m subunit.run discover -t ./ ${OS_TEST_PATH:-./watcher/tests} $LISTOPT $IDOPTION
+test_id_option=--load-list $IDFILE
+test_list_option=--list
--- a/.zuul.yaml
+++ b/.zuul.yaml
@@ -1,228 +1,45 @@
 - project:
-    queue: watcher
    templates:
-      - check-requirements
-      - openstack-cover-jobs
-      - openstack-lower-constraints-jobs
      - openstack-python-jobs
      - openstack-python35-jobs
-      - openstack-python36-jobs
-      - publish-openstack-docs-pti
-      - release-notes-jobs-python3
+      - publish-openstack-sphinx-docs
+      - check-requirements
+      - release-notes-jobs
    check:
      jobs:
-        - watcher-tempest-functional
-        - watcher-grenade:
-            voting: false
-        - watcher-tempest-dummy_optim
-        - watcher-tempest-actuator
-        - watcher-tempest-basic_optim
-        - watcher-tempest-vm_workload_consolidation
-        - watcher-tempest-workload_balancing
-        - watcher-tempest-zone_migration
-        - watcher-tempest-host_maintenance
-        - watcher-tempest-storage_balance
-        - watcher-tls-test
+        - watcher-tempest-multinode
+
    gate:
-      jobs:
-        - watcher-tempest-functional
-
+      queue: watcher
 - job:
-    name: watcher-tempest-dummy_optim
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_dummy_optim
-
- job:
-    name: watcher-tempest-actuator
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_actuator
-
- job:
-    name: watcher-tempest-basic_optim
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_basic_optim
-
- job:
-    name: watcher-tempest-vm_workload_consolidation
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_vm_workload_consolidation
-      devstack_local_conf:
-        test-config:
-          $WATCHER_CONFIG:
-            watcher_strategies.vm_workload_consolidation:
-              datasource: ceilometer
-
- job:
-    name: watcher-tempest-workload_balancing
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_workload_balancing
-
- job:
-    name: watcher-tempest-zone_migration
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_zone_migration
-
- job:
-    name: watcher-tempest-host_maintenance
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_host_maintenance
-
- job:
-    name: watcher-tempest-storage_balance
-    parent: watcher-tempest-multinode
-    voting: false
-    vars:
-      tempest_test_regex: watcher_tempest_plugin.tests.scenario.test_execute_storage_balance
-      devstack_local_conf:
-        test-config:
-          $TEMPEST_CONFIG:
-            volume:
-              backend_names: ['BACKEND_1', 'BACKEND_2']
-            volume-feature-enabled:
-              multi_backend: true
-
- job:
-    name: watcher-tls-test
-    parent: watcher-tempest-multinode
-    group-vars:
-      subnode:
-          devstack_services:
-            tls-proxy: true
-    vars:
-      devstack_services:
-        tls-proxy: true
-
- job:
-    name: watcher-tempest-multinode
-    parent: watcher-tempest-functional
-    nodeset: openstack-two-node-bionic
-    roles:
-      - zuul: openstack/tempest
-    group-vars:
-      subnode:
-        devstack_local_conf:
-          post-config:
-            $WATCHER_CONF:
-              watcher_cluster_data_model_collectors.compute:
-                period: 120
-              watcher_cluster_data_model_collectors.baremetal:
-                period: 120
-              watcher_cluster_data_model_collectors.storage:
-                period: 120
-        devstack_services:
-          watcher-api: false
-          watcher-decision-engine: true
-          watcher-applier: false
-          # We need to add TLS support for watcher plugin
-          tls-proxy: false
-          ceilometer: false
-          ceilometer-acompute: false
-          ceilometer-acentral: false
-          ceilometer-anotification: false
-          watcher: false
-          gnocchi-api: false
-          gnocchi-metricd: false
-          rabbit: false
-          mysql: false
-    vars:
-      devstack_local_conf:
-        post-config:
-          $WATCHER_CONF:
-            watcher_cluster_data_model_collectors.compute:
-              period: 120
-            watcher_cluster_data_model_collectors.baremetal:
-              period: 120
-            watcher_cluster_data_model_collectors.storage:
-              period: 120
-        test-config:
-          $TEMPEST_CONFIG:
-            compute:
-              min_compute_nodes: 2
-            compute-feature-enabled:
-              live_migration: true
-              block_migration_for_live_migration: true
-      devstack_plugins:
-        ceilometer: https://opendev.org/openstack/ceilometer
-
- job:
-    name: watcher-tempest-functional
-    parent: devstack-tempest
-    timeout: 7200
+    name: watcher-tempest-base-multinode
+    parent: legacy-dsvm-base-multinode
+    run: playbooks/legacy/watcher-tempest-base-multinode/run.yaml
+    post-run: playbooks/legacy/watcher-tempest-base-multinode/post.yaml
+    timeout: 4200
    required-projects:
-      - openstack/ceilometer
      - openstack/devstack-gate
      - openstack/python-openstackclient
      - openstack/python-watcherclient
      - openstack/watcher
      - openstack/watcher-tempest-plugin
-      - openstack/tempest
-    vars:
-      devstack_plugins:
-        watcher: https://opendev.org/openstack/watcher
-      devstack_services:
-        tls-proxy: false
-        watcher-api: true
-        watcher-decision-engine: true
-        watcher-applier: true
-        tempest: true
-        s-account: false
-        s-container: false
-        s-object: false
-        s-proxy: false
-      devstack_localrc:
-        TEMPEST_PLUGINS: /opt/stack/watcher-tempest-plugin
-      tempest_test_regex: watcher_tempest_plugin.tests.api
-      tox_envlist: all
-      tox_environment:
-        # Do we really need to set this? It's cargo culted
-        PYTHONUNBUFFERED: 'true'
-      zuul_copy_output:
-        /etc/hosts: logs
+    nodeset: legacy-ubuntu-xenial-2-node

 - job:
-    name: watcher-grenade
-    parent: legacy-dsvm-base
-    timeout: 10800
-    run: playbooks/legacy/grenade-devstack-watcher/run.yaml
-    post-run: playbooks/legacy/grenade-devstack-watcher/post.yaml
-    irrelevant-files:
-      - ^(test-|)requirements.txt$
-      - ^.*\.rst$
-      - ^api-ref/.*$
-      - ^doc/.*$
-      - ^watcher/hacking/.*$
-      - ^watcher/tests/.*$
-      - ^releasenotes/.*$
-      - ^setup.cfg$
-      - ^tools/.*$
-      - ^tox.ini$
-    required-projects:
-      - openstack/grenade
-      - openstack/devstack-gate
-      - openstack/watcher
-      - openstack/python-watcherclient
-      - openstack/watcher-tempest-plugin
-
- job:
-    # This job is used in python-watcherclient repo
-    name: watcherclient-tempest-functional
-    parent: watcher-tempest-functional
+    name: watcher-tempest-multinode
+    parent: watcher-tempest-base-multinode
    voting: false
+
+- job:
+    # This job is used by python-watcherclient repo
+    name: watcherclient-tempest-functional
+    parent: legacy-dsvm-base
+    run: playbooks/legacy/watcherclient-tempest-functional/run.yaml
+    post-run: playbooks/legacy/watcherclient-tempest-functional/post.yaml
    timeout: 4200
-    vars:
-      tempest_concurrency: 1
-      tempest_test_regex: watcher_tempest_plugin.tests.client_functional
+    required-projects:
+      - openstack/devstack
+      - openstack/devstack-gate
+      - openstack/python-openstackclient
+      - openstack/python-watcherclient
+      - openstack/watcher
--- a/HACKING.rst
+++ b/HACKING.rst
@@ -8,4 +8,4 @@
 watcher Style Commandments
 ==========================

-Read the OpenStack Style Commandments https://docs.openstack.org/hacking/latest/
+Read the OpenStack Style Commandments https://docs.openstack.org/developer/hacking/
--- a/README.rst
+++ b/README.rst
@@ -2,8 +2,8 @@
 Team and repository tags
 ========================

-.. image:: https://governance.openstack.org/tc/badges/watcher.svg
-    :target: https://governance.openstack.org/tc/reference/tags/index.html
+.. image:: https://governance.openstack.org/badges/watcher.svg
+    :target: https://governance.openstack.org/reference/tags/index.html

 .. Change things from this point on

@@ -22,11 +22,10 @@ service for multi-tenant OpenStack-based clouds.
 Watcher provides a robust framework to realize a wide range of cloud
 optimization goals, including the reduction of data center
 operating costs, increased system performance via intelligent virtual machine
-migration, increased energy efficiency and more!
+migration, increased energy efficiency-and more!

 * Free software: Apache license
 * Wiki: https://wiki.openstack.org/wiki/Watcher
-* Source: https://github.com/openstack/watcher
+* Source:  https://github.com/openstack/watcher
 * Bugs: https://bugs.launchpad.net/watcher
 * Documentation: https://docs.openstack.org/watcher/latest/
-* Release notes: https://docs.openstack.org/releasenotes/watcher/
--- a/api-ref/source/conf.py
+++ b/api-ref/source/conf.py
@@ -1,90 +0,0 @@
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-#
-# nova documentation build configuration file, created by
-# sphinx-quickstart on Sat May  1 15:17:47 2010.
-#
-# This file is execfile()d with the current directory set to
-# its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-from watcher import version as watcher_version
-
-
-extensions = [
-    'openstackdocstheme',
-    'os_api_ref',
-]
-
-# -- General configuration ----------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'Infrastructure Optimization API Reference'
-copyright = u'2010-present, OpenStack Foundation'
-
-# openstackdocstheme options
-repository_name = 'openstack/watcher'
-bug_project = 'watcher'
-bug_tag = ''
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The full version, including alpha/beta/rc tags.
-release = watcher_version.version_info.release_string()
-# The short X.Y version.
-version = watcher_version.version_string
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# -- Options for HTML output --------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  Major themes that come with
-# Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'openstackdocs'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-html_theme_options = {
-    "sidebar_mode": "toc",
-}
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-html_last_updated_fmt = '%Y-%m-%d %H:%M'
-
-# -- Options for LaTeX output -------------------------------------------------
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass
-# [howto/manual]).
-latex_documents = [
-    ('index', 'Watcher.tex', u'Infrastructure Optimization API Reference',
-     u'OpenStack Foundation', 'manual'),
-]
--- a/api-ref/source/index.rst
+++ b/api-ref/source/index.rst
@@ -1,17 +0,0 @@
-:tocdepth: 2
-
-===========
-Watcher API
-===========
-
-.. rest_expand_all::
-
-.. include:: watcher-api-versions.inc
-.. include:: watcher-api-v1-audittemplates.inc
-.. include:: watcher-api-v1-audits.inc
-.. include:: watcher-api-v1-actionplans.inc
-.. include:: watcher-api-v1-actions.inc
-.. include:: watcher-api-v1-goals.inc
-.. include:: watcher-api-v1-strategies.inc
-.. include:: watcher-api-v1-services.inc
-.. include:: watcher-api-v1-scoring_engines.inc
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -1,546 +0,0 @@
-# variables in header
-header_version:
-  description: |
-    Specific API microversion used to generate this response.
-  in: header
-  required: true
-  type: string
-openstack-api-max-version:
-  description: |
-    Maximum API microversion supported by this endpoint, eg. "1.1"
-  in: header
-  required: true
-  type: string
-openstack-api-min-version:
-  description: |
-    Minimum API microversion supported by this endpoint, eg. "1.0"
-  in: header
-  required: true
-  type: string
-openstack-api-version:
-  description: >
-    A request SHOULD include this header to indicate to the Watcher API service what
-    version the client supports. The server will transform the response object into
-    compliance with the requested version, if it is supported, or return a
-    406 Not Acceptable error.
-    If this header is not supplied, the server will response with server minimum
-    supported version.
-  in: header
-  required: true
-  type: string
-openstack-request-id:
-  description: >
-    An unique ID for tracking the request. The request ID associated with the request
-    appears in the log lines for that request. By default, the middleware configuration
-    ensures that the request ID appears in the log files.
-  in: header
-  required: false
-  type: string
-
-# Path
-action_ident:
-  description: |
-    The UUID of the Action.
-  in: path
-  required: true
-  type: string
-actionplan_ident:
-  description: |
-    The UUID of the Action Plan.
-  in: path
-  required: true
-  type: string
-audit_ident:
-  description: |
-    The UUID or name of the Audit.
-  in: path
-  required: true
-  type: string
-audittemplate_ident:
-  description: |
-    The UUID or name of the Audit Template.
-  in: path
-  required: true
-  type: string
-goal_ident:
-  description: |
-    The UUID or name of the Goal.
-  in: path
-  required: true
-  type: string
-scoring_engine_ident:
-  description: |
-    The UUID or name of the Scoring Engine.
-  in: path
-  required: true
-  type: string
-service_ident:
-  description: |
-    The ID or name of the Service.
-  in: path
-  required: true
-  type: string
-strategy_ident:
-  description: |
-    The UUID or name of the Strategy.
-  in: path
-  required: true
-  type: string
-
-# Query body
-limit:
-  description: |
-    Requests a page size of items. Returns a number of items up to a ``limit``
-    value. Use the limit parameter to make an initial limited request and use
-    the ID of the last-seen item from the response as the ``marker`` parameter
-    value in a subsequent limited request.
-  in: query
-  required: false
-  type: integer
-marker:
-  description: |
-    The ID of the last-seen item. Use the ``limit`` parameter to make an
-    initial limited request and use the ID of the last-seen item from the
-    response as the ``marker`` parameter value in a subsequent limited request.
-  in: query
-  required: false
-  type: string
-r_action_plan:
-  description: |
-    UUID of the action plan used for filtering.
-  in: query
-  required: false
-  type: string
-r_audit:
-  description: |
-    Optional UUID of an audit, to get only actions for that audit.
-  in: query
-  required: false
-  type: string
-r_goal:
-  description: |
-    The UUID or name of the Goal.
-  in: query
-  required: false
-  type: string
-r_strategy:
-  description: |
-    The UUID or name of the Strategy.
-  in: query
-  required: false
-  type: string
-sort_dir:
-  description: |
-    Sorts the response by the requested sort direction.
-    A valid value is ``asc`` (ascending) or ``desc`` (descending).
-    Default is ``asc``.
-  in: query
-  required: false
-  type: string
-sort_key:
-  description: |
-    Sorts the response by the this attribute value. Default is ``id``.
-  in: query
-  required: false
-  type: string
-
-# variables in the API response body
-
-# Action
-action_action_plan_uuid:
-  description: |
-    The action plan this action belongs to.
-  in: body
-  required: true
-  type: string
-action_description:
-  description: |
-    Action description.
-  in: body
-  required: true
-  type: string
-action_input_parameters:
-  description: |
-    Input parameters which are used by appropriate action type. For example,
-    ``migration`` action takes into account such parameters as
-    ``migration_type``, ``destination_node``, ``resource_id`` and
-    ``source_node``. To see a list of supported action types and their input
-    parameters visit `Action plugins page <https://docs.openstack.org/watcher/latest/contributor/plugin/plugins.html#actions>`_.
-  in: body
-  required: true
-  type: JSON
-action_parents:
-  description: |
-    UUIDs of parent actions.
-  in: body
-  required: true
-  type: array
-action_state:
-  description: |
-    State of Action.
-  in: body
-  required: true
-  type: string
-action_type:
-  description: |
-    Action type based on specific API action. Actions in Watcher are
-    pluggable, to see a list of supported action types visit
-    `Action plugins page <https://docs.openstack.org/watcher/latest/contributor/plugin/plugins.html#actions>`_.
-  in: body
-  required: true
-  type: string
-
-# Action Plan
-actionplan_audit_uuid:
-  description: |
-    The UUID of the audit this acton plan belongs to.
-  in: body
-  required: false
-  type: string
-actionplan_efficacy_indicators:
-  description: |
-    The list of efficacy indicators associated to this action plan.
-  in: body
-  required: false
-  type: array
-actionplan_global_efficacy:
-  description: |
-    The global efficacy of this action plan.
-  in: body
-  required: false
-  type: array
-actionplan_hostname:
-  description: |
-    Hostname the actionplan is running on
-  in: body
-  required: false
-  type: string
-actionplan_state:
-  description: |
-    State of this action plan. To get more information about states and
-    action plan's lifecycle, visit `Action Plan State Machine page <https://docs.openstack.org/watcher/latest/architecture.html#action-plan-state-machine>`_.
-  in: body
-  required: false
-  type: string
-
-# Audit
-audit_autotrigger:
-  description: |
-    Auto execute action plan once audit is succeeded.
-  in: body
-  required: false
-  type: boolean
-audit_endtime_req:
-  description: |
-    The local time after which audit can't be executed.
-    It will be converted to UTC time by Watcher.
-  in: body
-  required: false
-  type: string
-  min_version: 1.1
-audit_endtime_resp:
-  description: |
-    The UTC time after which audit can't be executed.
-  in: body
-  required: false
-  type: string
-  min_version: 1.1
-audit_goal:
-  description: |
-    The UUID or name of the Goal.
-  in: body
-  required: false
-  type: string
-audit_hostname:
-  description: |
-    Hostname the audit is running on
-  in: body
-  required: false
-  type: string
-audit_interval:
-  description: |
-    Time interval between audit's execution.
-    Can be set either in seconds or cron syntax.
-    Should be defined only for CONTINUOUS audits.
-  in: body
-  required: false
-  type: string
-audit_name:
-  description: |
-    Name of this audit.
-  in: body
-  required: false
-  type: string
-audit_next_run_time:
-  description: |
-    The next time audit launch. Defined only for CONTINUOUS audits.
-  in: body
-  required: false
-  type: string
-audit_parameters:
-  description: |
-    The strategy parameters for this audit.
-  in: body
-  required: false
-  type: JSON
-audit_starttime_req:
-  description: |
-    The local time after which audit can be executed in accordance
-    with interval. It will be converted to UTC time by Watcher.
-  in: body
-  required: false
-  type: string
-  min_version: 1.1
-audit_starttime_resp:
-  description: |
-    The UTC time after which audit can be executed in accordance with interval.
-  in: body
-  required: false
-  type: string
-  min_version: 1.1
-audit_state:
-  description: |
-    State of this audit. To get more information about states and
-    audit's lifecycle, visit `Audit State Machine page <https://docs.openstack.org/watcher/latest/architecture.html#audit-state-machine>`_.
-  in: body
-  required: true
-  type: string
-audit_strategy:
-  description: |
-    The UUID or name of the Strategy.
-  in: body
-  required: false
-  type: string
-audit_type:
-  description: |
-    Type of this audit. Can only be either ONESHOT or CONTINUOUS.
-  in: body
-  required: true
-  type: string
-
-# Audit Template
-audittemplate_description:
-  description: |
-    Short description of the Audit Template.
-  in: body
-  required: false
-  type: string
-audittemplate_goal:
-  description: |
-    The UUID or name of the Goal.
-  in: body
-  required: true
-  type: string
-audittemplate_name:
-  description: |
-    The name of the Audit template.
-  in: body
-  required: true
-  type: string
-audittemplate_scope:
-  description: |
-    Audit Scope.
-  in: body
-  required: false
-  type: JSON
-audittemplate_strategy:
-  description: |
-    The UUID or name of the Strategy.
-  in: body
-  required: false
-  type: string
-audittemplate_uuid:
-  description: |
-    The UUID of the Audit template.
-  in: body
-  required: true
-  type: string
-
-created_at:
-  description: |
-    The date and time when the resource was created. The date and time
-    stamp format is `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
-  in: body
-  required: true
-  type: string
-deleted_at:
-  description: |
-    The date and time when the resource was deleted. The date and time
-    stamp format is `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
-  in: body
-  required: true
-  type: string
-
-# Goal
-goal_display_name:
-  description: |
-    Localized name of the goal.
-  in: body
-  required: true
-  type: string
-goal_efficacy_specification:
-  description: |
-    Efficacy specifications as result of stategy's execution.
-  in: body
-  required: true
-  type: array
-goal_name:
-  description: |
-    Name of the goal.
-  in: body
-  required: true
-  type: string
-goal_uuid:
-  description: |
-    Unique UUID for this goal.
-  in: body
-  required: true
-  type: string
-
-links:
-  description: |
-    A list of relative links. Includes the self and bookmark links.
-  in: body
-  required: true
-  type: array
-
-# Scoring Engine
-scoring_engine_description:
-  description: |
-    A human readable description of the Scoring Engine.
-  in: body
-  required: true
-  type: string
-scoring_engine_metainfo:
-  description: |
-    A metadata associated with the scoring engine
-  in: body
-  required: true
-  type: string
-scoring_engine_name:
-  description: |
-    The name of the scoring engine.
-  in: body
-  required: true
-  type: string
-# Service
-service_host:
-  description: |
-    Name of host where service is placed on.
-  in: body
-  required: true
-  type: string
-service_id:
-  description: |
-    ID of service.
-  in: body
-  required: true
-  type: integer
-service_last_seen_up:
-  description: |
-    Time when Watcher service sent latest heartbeat.
-  in: body
-  required: true
-  type: string
-service_name:
-  description: |
-    Name of service like ``watcher-applier``.
-  in: body
-  required: true
-  type: string
-service_status:
-  description: |
-    State of service. It can be either in ACTIVE or FAILED state.
-  in: body
-  required: true
-  type: string
-
-# Strategy
-strategy_check_comment:
-  description: |
-    Requirement comment.
-  in: body
-  required: true
-  type: string
-strategy_check_mandatory:
-  description: |
-    Whether this requirement mandatory or not.
-  in: body
-  required: true
-  type: boolean
-strategy_check_state:
-  description: |
-    State of requirement for Strategy.
-  in: body
-  required: true
-  type: string or JSON
-strategy_check_type:
-  description: |
-    Type of requirement for Strategy.
-  in: body
-  required: true
-  type: string
-strategy_display_name:
-  description: |
-    Localized name of the strategy.
-  in: body
-  required: true
-  type: string
-strategy_name:
-  description: |
-    Name of the strategy.
-  in: body
-  required: true
-  type: string
-strategy_parameters_spec:
-  description: |
-    Parameters specifications for this strategy.
-  in: body
-  required: true
-  type: JSON
-strategy_uuid:
-  description: |
-    Unique UUID for this strategy.
-  in: body
-  required: true
-  type: string
-
-updated_at:
-  description: |
-    The date and time when the resource was updated. The date and time
-    stamp format is `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
-  in: body
-  required: true
-  type: string
-uuid:
-  description: |
-    The UUID for the resource.
-  in: body
-  required: true
-  type: string
-
-# Version
-version:
-  description: |
-    Versioning of this API response, eg. "1.1".
-  in: body
-  required: true
-  type: string
-version_description:
-  description: |
-    Descriptive text about the Watcher service.
-  in: body
-  required: true
-  type: string
-version_id:
-  description: |
-    Major API version, eg, "v1"
-  in: body
-  required: true
-  type: string
-versions:
-  description: |
-    Array of information about currently supported versions.
-  in: body
-  required: true
-  type: array
--- a/api-ref/source/samples/actionplan-cancel-request-cancelling.json
+++ b/api-ref/source/samples/actionplan-cancel-request-cancelling.json
@@ -1,7 +0,0 @@
-[
-    {
-        "op": "replace",
-        "value": "CANCELLING",
-        "path": "/state"
-    }
-]
--- a/api-ref/source/samples/actionplan-cancel-request-pending.json
+++ b/api-ref/source/samples/actionplan-cancel-request-pending.json
@@ -1,7 +0,0 @@
-[
-    {
-        "op": "replace",
-        "value": "CANCELLED",
-        "path": "/state"
-    }
-]
--- a/api-ref/source/samples/actionplan-list-detailed-response.json
+++ b/api-ref/source/samples/actionplan-list-detailed-response.json
@@ -1,27 +0,0 @@
-{
-    "action_plans": [
-        {
-            "state": "ONGOING",
-            "efficacy_indicators": [],
-            "strategy_uuid": "7dae0eea-9df7-42b8-bb3e-313958ff2242",
-            "global_efficacy": [],
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-                }
-            ],
-            "updated_at": "2018-04-10T11:59:52.640067+00:00",
-            "strategy_name": "dummy_with_resize",
-            "deleted_at": null,
-            "uuid": "4cbc4ede-0d25-481b-b86e-998dbbd4f8bf",
-            "audit_uuid": "7d100b05-0a86-491f-98a7-f93da19b272a",
-            "created_at": "2018-04-10T11:59:52.640067+00:00",
-            "hostname": "controller"
-        }
-    ]
-}
--- a/api-ref/source/samples/actionplan-list-response.json
+++ b/api-ref/source/samples/actionplan-list-response.json
@@ -1,24 +0,0 @@
-{
-    "action_plans": [
-        {
-            "state": "ONGOING",
-            "efficacy_indicators": [],
-            "strategy_uuid": "7dae0eea-9df7-42b8-bb3e-313958ff2242",
-            "global_efficacy": [],
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-                }
-            ],
-            "updated_at": "2018-04-10T11:59:52.640067+00:00",
-            "strategy_name": "dummy_with_resize",
-            "uuid": "4cbc4ede-0d25-481b-b86e-998dbbd4f8bf",
-            "audit_uuid": "7d100b05-0a86-491f-98a7-f93da19b272a"
-        }
-    ]
-}
--- a/api-ref/source/samples/actionplan-show-response.json
+++ b/api-ref/source/samples/actionplan-show-response.json
@@ -1,21 +0,0 @@
-{
-    "state": "ONGOING",
-    "efficacy_indicators": [],
-    "strategy_uuid": "7dae0eea-9df7-42b8-bb3e-313958ff2242",
-    "global_efficacy": [],
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-        }
-    ],
-    "updated_at": "2018-04-10T11:59:52.640067+00:00",
-    "strategy_name": "dummy_with_resize",
-    "uuid": "4cbc4ede-0d25-481b-b86e-998dbbd4f8bf",
-    "audit_uuid": "7d100b05-0a86-491f-98a7-f93da19b272a",
-    "hostname": "controller"
-}
--- a/api-ref/source/samples/actionplan-start-response.json
+++ b/api-ref/source/samples/actionplan-start-response.json
@@ -1,23 +0,0 @@
-{
-    "state": "PENDING",
-    "efficacy_indicators": [],
-    "strategy_uuid": "7dae0eea-9df7-42b8-bb3e-313958ff2242",
-    "global_efficacy": [],
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/action_plans/4cbc4ede-0d25-481b-b86e-998dbbd4f8bf"
-        }
-    ],
-    "updated_at": "2018-04-10T11:59:41.602430+00:00",
-    "strategy_name": "dummy_with_resize",
-    "uuid": "4cbc4ede-0d25-481b-b86e-998dbbd4f8bf",
-    "audit_uuid": "7d100b05-0a86-491f-98a7-f93da19b272a",
-    "created_at": "2018-04-10T11:59:12.592729+00:00",
-    "deleted_at": null,
-    "hostname": null
-}
--- a/api-ref/source/samples/actions-list-detailed-response.json
+++ b/api-ref/source/samples/actions-list-detailed-response.json
@@ -1,30 +0,0 @@
-{
-    "actions": [
-        {
-            "state": "PENDING",
-            "description": "Wait for a given interval in seconds.",
-            "parents": [
-                "8119d16e-b419-4729-b015-fc04c4e45783"
-            ],
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/actions/7182a988-e6c4-4152-a0d6-067119475c83"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/actions/7182a988-e6c4-4152-a0d6-067119475c83"
-                }
-            ],
-            "action_plan_uuid": "c6bba9ed-a7eb-4370-9993-d873e5e22cba",
-            "uuid": "7182a988-e6c4-4152-a0d6-067119475c83",
-            "deleted_at": null,
-            "updated_at": null,
-            "input_parameters": {
-                "duration": 3.2
-            },
-            "action_type": "sleep",
-            "created_at": "2018-03-26T11:56:08.235226+00:00"
-        }
-    ]
-}
--- a/api-ref/source/samples/actions-list-response.json
+++ b/api-ref/source/samples/actions-list-response.json
@@ -1,23 +0,0 @@
-{
-    "actions": [
-        {
-            "state": "PENDING",
-            "parents": [
-                "8119d16e-b419-4729-b015-fc04c4e45783"
-            ],
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/actions/7182a988-e6c4-4152-a0d6-067119475c83"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/actions/7182a988-e6c4-4152-a0d6-067119475c83"
-                }
-            ],
-            "action_plan_uuid": "c6bba9ed-a7eb-4370-9993-d873e5e22cba",
-            "uuid": "7182a988-e6c4-4152-a0d6-067119475c83",
-            "action_type": "sleep"
-        }
-    ]
-}
--- a/api-ref/source/samples/actions-show-response.json
+++ b/api-ref/source/samples/actions-show-response.json
@@ -1,26 +0,0 @@
-{
-    "state": "SUCCEEDED",
-    "description": "Logging a NOP message",
-    "parents": [
-        "b4529294-1de6-4302-b57a-9b5d5dc363c6"
-    ],
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/actions/54acc7a0-91b0-46ea-a5f7-4ae2b9df0b0a"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/actions/54acc7a0-91b0-46ea-a5f7-4ae2b9df0b0a"
-        }
-    ],
-    "action_plan_uuid": "4cbc4ede-0d25-481b-b86e-998dbbd4f8bf",
-    "uuid": "54acc7a0-91b0-46ea-a5f7-4ae2b9df0b0a",
-    "deleted_at": null,
-    "updated_at": "2018-04-10T11:59:44.026973+00:00",
-    "input_parameters": {
-        "message": "Welcome"
-    },
-    "action_type": "nop",
-    "created_at": "2018-04-10T11:59:12.725147+00:00"
-}
--- a/api-ref/source/samples/api-root-response.json
+++ b/api-ref/source/samples/api-root-response.json
@@ -1,30 +0,0 @@
-{
-  "default_version": {
-    "id": "v1",
-    "links": [
-      {
-        "href": "http://controller:9322/v1/",
-        "rel": "self"
-      }
-    ],
-    "min_version": "1.0",
-    "status": "CURRENT",
-    "max_version": "1.1"
-  },
-  "description": "Watcher is an OpenStack project which aims to improve physical resources usage through better VM placement.",
-  "name": "OpenStack Watcher API",
-  "versions": [
-    {
-      "id": "v1",
-      "links": [
-        {
-          "href": "http://controller:9322/v1/",
-          "rel": "self"
-        }
-      ],
-      "min_version": "1.0",
-      "status": "CURRENT",
-      "max_version": "1.1"
-    }
-  ]
-}
--- a/api-ref/source/samples/api-v1-root-response.json
+++ b/api-ref/source/samples/api-v1-root-response.json
@@ -1,80 +0,0 @@
-{
-  "scoring_engines": [
-    {
-      "href": "http://controller:9322/v1/scoring_engines/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/scoring_engines/",
-      "rel": "bookmark"
-    }
-  ],
-  "media_types": [
-    {
-      "base": "application/json",
-      "type": "application/vnd.openstack.watcher.v1+json"
-    }
-  ],
-  "links": [
-    {
-      "href": "http://controller:9322/v1/",
-      "rel": "self"
-    },
-    {
-      "href": "http://docs.openstack.org/developer/watcher/dev/api-spec-v1.html",
-      "type": "text/html",
-      "rel": "describedby"
-    }
-  ],
-  "actions": [
-    {
-      "href": "http://controller:9322/v1/actions/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/actions/",
-      "rel": "bookmark"
-    }
-  ],
-  "audit_templates": [
-    {
-      "href": "http://controller:9322/v1/audit_templates/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/audit_templates/",
-      "rel": "bookmark"
-    }
-  ],
-  "action_plans": [
-    {
-      "href": "http://controller:9322/v1/action_plans/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/action_plans/",
-      "rel": "bookmark"
-    }
-  ],
-  "services": [
-    {
-      "href": "http://controller:9322/v1/services/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/services/",
-      "rel": "bookmark"
-    }
-  ],
-  "audits": [
-    {
-      "href": "http://controller:9322/v1/audits/",
-      "rel": "self"
-    },
-    {
-      "href": "http://controller:9322/audits/",
-      "rel": "bookmark"
-    }
-  ],
-  "id": "v1"
-}
--- a/api-ref/source/samples/audit-cancel-request.json
+++ b/api-ref/source/samples/audit-cancel-request.json
@@ -1,7 +0,0 @@
-[
-    {
-        "op": "replace",
-        "value": "CANCELLED",
-        "path": "/state"
-    }
-]
--- a/api-ref/source/samples/audit-cancel-response.json
+++ b/api-ref/source/samples/audit-cancel-response.json
@@ -1,54 +0,0 @@
-{
-    "interval": "*/2 * * * *",
-    "strategy_uuid": "6b3b3902-8508-4cb0-bb85-67f32866b086",
-    "goal_uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-    "name": "audit1",
-    "parameters": {
-        "host_choice": "retry",
-        "instance_metrics": {
-            "cpu_util": "compute.node.cpu.percent",
-            "memory.resident": "hardware.memory.used"
-        },
-        "granularity": 300,
-        "weights": {
-            "cpu_util_weight": 1.0,
-            "memory.resident_weight": 1.0
-        },
-        "retry_count": 1,
-        "metrics": [
-            "cpu_util"
-        ],
-        "periods": {
-            "instance": 720,
-            "node": 600
-        },
-        "thresholds": {
-            "cpu_util": 0.2,
-            "memory.resident": 0.2
-        }
-    },
-    "auto_trigger": false,
-    "uuid": "65a5da84-5819-4aea-8278-a28d2b489028",
-    "goal_name": "workload_balancing",
-    "scope": [],
-    "created_at": "2018-04-06T07:27:27.820460+00:00",
-    "deleted_at": null,
-    "state": "CANCELLED",
-    "audit_type": "CONTINUOUS",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        }
-    ],
-    "strategy_name": "workload_stabilization",
-    "next_run_time": "2018-04-06T11:56:00",
-    "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller",
-    "start_time": null,
-    "end_time": null
-}
--- a/api-ref/source/samples/audit-create-request-continuous.json
+++ b/api-ref/source/samples/audit-create-request-continuous.json
@@ -1,14 +0,0 @@
-{
-    "auto_trigger": false,
-    "audit_template_uuid": "76fddfee-a9c4-40b0-8da0-c19ad6904f09",
-    "name": "test_audit",
-    "parameters": {
-        "metrics": [
-            "cpu_util"
-        ]
-    },
-    "audit_type": "CONTINUOUS",
-    "interval": "*/2 * * * *",
-    "start_time":"2018-04-02 20:30:00",
-    "end_time": "2018-04-04 20:30:00"
-}
--- a/api-ref/source/samples/audit-create-request-oneshot.json
+++ b/api-ref/source/samples/audit-create-request-oneshot.json
@@ -1,5 +0,0 @@
-{
-    "audit_type": "ONESHOT",
-    "auto_trigger": false,
-    "audit_template_uuid": "5e70a156-ced7-4012-b1c6-88fcb02ee0c1"
-}
--- a/api-ref/source/samples/audit-create-response.json
+++ b/api-ref/source/samples/audit-create-response.json
@@ -1,54 +0,0 @@
-{
-    "interval": "*/2 * * * *",
-    "strategy_uuid": "6b3b3902-8508-4cb0-bb85-67f32866b086",
-    "goal_uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-    "name": "test_audit",
-    "parameters": {
-        "host_choice": "retry",
-        "granularity": 300,
-        "thresholds": {
-            "cpu_util": 0.2,
-            "memory.resident": 0.2
-        },
-        "periods": {
-            "node": 600,
-            "instance": 720
-        },
-        "retry_count": 1,
-        "metrics": [
-            "cpu_util"
-        ],
-        "weights": {
-            "cpu_util_weight": 1.0,
-            "memory.resident_weight": 1.0
-        },
-        "instance_metrics": {
-            "cpu_util": "compute.node.cpu.percent",
-            "memory.resident": "hardware.memory.used"
-        }
-    },
-    "auto_trigger": false,
-    "uuid": "65a5da84-5819-4aea-8278-a28d2b489028",
-    "goal_name": "workload_balancing",
-    "scope": [],
-    "created_at": "2018-04-06T07:27:27.820460+00:00",
-    "deleted_at": null,
-    "state": "PENDING",
-    "audit_type": "CONTINUOUS",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        }
-    ],
-    "strategy_name": "workload_stabilization",
-    "next_run_time": null,
-    "updated_at": null,
-    "hostname": null,
-    "start_time": null,
-    "end_time": null
-}
--- a/api-ref/source/samples/audit-list-detailed-response.json
+++ b/api-ref/source/samples/audit-list-detailed-response.json
@@ -1,58 +0,0 @@
-{
-    "audits": [
-        {
-            "interval": "*/2 * * * *",
-            "strategy_uuid": "6b3b3902-8508-4cb0-bb85-67f32866b086",
-            "goal_uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-            "name": "test_audit",
-            "parameters": {
-                "host_choice": "retry",
-                "instance_metrics": {
-                    "cpu_util": "compute.node.cpu.percent",
-                    "memory.resident": "hardware.memory.used"
-                },
-                "granularity": 300,
-                "weights": {
-                    "cpu_util_weight": 1.0,
-                    "memory.resident_weight": 1.0
-                },
-                "retry_count": 1,
-                "metrics": [
-                    "cpu_util"
-                ],
-                "periods": {
-                    "instance": 720,
-                    "node": 600
-                },
-                "thresholds": {
-                    "cpu_util": 0.2,
-                    "memory.resident": 0.2
-                }
-            },
-            "auto_trigger": false,
-            "uuid": "65a5da84-5819-4aea-8278-a28d2b489028",
-            "goal_name": "workload_balancing",
-            "scope": [],
-            "created_at": "2018-04-06T07:27:27.820460+00:00",
-            "deleted_at": null,
-            "state": "ONGOING",
-            "audit_type": "CONTINUOUS",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-                }
-            ],
-            "strategy_name": "workload_stabilization",
-            "next_run_time": "2018-04-06T09:46:00",
-            "updated_at": "2018-04-06T09:44:01.604146+00:00",
-            "hostname": "controller",
-            "start_time": null,
-            "end_time": null
-        }
-    ]
-}
--- a/api-ref/source/samples/audit-list-response.json
+++ b/api-ref/source/samples/audit-list-response.json
@@ -1,28 +0,0 @@
-{
-    "audits": [
-        {
-            "interval": null,
-            "strategy_uuid": "e311727b-b9b3-43ef-a5f7-8bd7ea80df25",
-            "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-            "name": "dummy-2018-03-26T11:56:07.950400",
-            "auto_trigger": false,
-            "uuid": "ccc69a5f-114e-46f4-b15e-a77eaa337b01",
-            "goal_name": "dummy",
-            "scope": [],
-            "state": "SUCCEEDED",
-            "audit_type": "ONESHOT",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/audits/ccc69a5f-114e-46f4-b15e-a77eaa337b01"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/audits/ccc69a5f-114e-46f4-b15e-a77eaa337b01"
-                }
-            ],
-            "strategy_name": "dummy",
-            "next_run_time": null
-        }
-    ]
-}
--- a/api-ref/source/samples/audit-show-response.json
+++ b/api-ref/source/samples/audit-show-response.json
@@ -1,54 +0,0 @@
-{
-    "interval": "*/2 * * * *",
-    "strategy_uuid": "6b3b3902-8508-4cb0-bb85-67f32866b086",
-    "goal_uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-    "name": "test_audit",
-    "parameters": {
-        "host_choice": "retry",
-        "instance_metrics": {
-            "cpu_util": "compute.node.cpu.percent",
-            "memory.resident": "hardware.memory.used"
-        },
-        "granularity": 300,
-        "weights": {
-            "cpu_util_weight": 1.0,
-            "memory.resident_weight": 1.0
-        },
-        "retry_count": 1,
-        "metrics": [
-            "cpu_util"
-        ],
-        "periods": {
-            "instance": 720,
-            "node": 600
-        },
-        "thresholds": {
-            "cpu_util": 0.2,
-            "memory.resident": 0.2
-        }
-    },
-    "auto_trigger": false,
-    "uuid": "65a5da84-5819-4aea-8278-a28d2b489028",
-    "goal_name": "workload_balancing",
-    "scope": [],
-    "created_at": "2018-04-06T07:27:27.820460+00:00",
-    "deleted_at": null,
-    "state": "ONGOING",
-    "audit_type": "CONTINUOUS",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        }
-    ],
-    "strategy_name": "workload_stabilization",
-    "next_run_time": "2018-04-06T11:56:00",
-    "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller",
-    "start_time": null,
-    "end_time": null
-}
--- a/api-ref/source/samples/audit-update-request.json
+++ b/api-ref/source/samples/audit-update-request.json
@@ -1,12 +0,0 @@
-[
-    {
-        "value": "CANCELLED",
-        "path": "/state",
-        "op": "replace"
-    },
-    {
-        "value": "audit1",
-        "path": "/name",
-        "op": "replace"
-    }
-]
--- a/api-ref/source/samples/audit-update-response.json
+++ b/api-ref/source/samples/audit-update-response.json
@@ -1,54 +0,0 @@
-{
-    "interval": "*/2 * * * *",
-    "strategy_uuid": "6b3b3902-8508-4cb0-bb85-67f32866b086",
-    "goal_uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-    "name": "audit1",
-    "parameters": {
-        "host_choice": "retry",
-        "instance_metrics": {
-            "cpu_util": "compute.node.cpu.percent",
-            "memory.resident": "hardware.memory.used"
-        },
-        "granularity": 300,
-        "weights": {
-            "cpu_util_weight": 1.0,
-            "memory.resident_weight": 1.0
-        },
-        "retry_count": 1,
-        "metrics": [
-            "cpu_util"
-        ],
-        "periods": {
-            "instance": 720,
-            "node": 600
-        },
-        "thresholds": {
-            "cpu_util": 0.2,
-            "memory.resident": 0.2
-        }
-    },
-    "auto_trigger": false,
-    "uuid": "65a5da84-5819-4aea-8278-a28d2b489028",
-    "goal_name": "workload_balancing",
-    "scope": [],
-    "created_at": "2018-04-06T07:27:27.820460+00:00",
-    "deleted_at": null,
-    "state": "CANCELLED",
-    "audit_type": "CONTINUOUS",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audits/65a5da84-5819-4aea-8278-a28d2b489028"
-        }
-    ],
-    "strategy_name": "workload_stabilization",
-    "next_run_time": "2018-04-06T11:56:00",
-    "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller",
-    "start_time": null,
-    "end_time": null
-}
--- a/api-ref/source/samples/audittemplate-create-request-full.json
+++ b/api-ref/source/samples/audittemplate-create-request-full.json
@@ -1,7 +0,0 @@
-{
-    "name": "at2",
-    "goal": "dummy",
-    "strategy": "dummy",
-    "description": "the second audit template",
-    "scope": []
-}
--- a/api-ref/source/samples/audittemplate-create-request-minimal.json
+++ b/api-ref/source/samples/audittemplate-create-request-minimal.json
@@ -1,4 +0,0 @@
-{
-    "name": "at2",
-    "goal": "dummy"
-}
--- a/api-ref/source/samples/audittemplate-create-response.json
+++ b/api-ref/source/samples/audittemplate-create-response.json
@@ -1,23 +0,0 @@
-{
-    "description": null,
-    "strategy_uuid": null,
-    "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-    "name": "at3",
-    "uuid": "b4041d8c-85d7-4224-851d-649fe48b7196",
-    "goal_name": "dummy",
-    "scope": [],
-    "created_at": "2018-04-04T08:38:33.110432+00:00",
-    "deleted_at": null,
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-        }
-    ],
-    "strategy_name": null,
-    "updated_at": null
-}
--- a/api-ref/source/samples/audittemplate-list-detailed-response.json
+++ b/api-ref/source/samples/audittemplate-list-detailed-response.json
@@ -1,23 +0,0 @@
-{
-    "audit_templates":[
-        {
-            "strategy_uuid": null,
-            "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-            "name": "at3",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-                },
-                {
-                    "rel": "bookmark", "href":
-                    "http://controller:9322/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-                }
-            ],
-            "strategy_name": null,
-            "uuid": "b4041d8c-85d7-4224-851d-649fe48b7196",
-            "goal_name": "dummy", "scope": [],
-            "description": null
-        }
-    ]
-}
--- a/api-ref/source/samples/audittemplate-list-response.json
+++ b/api-ref/source/samples/audittemplate-list-response.json
@@ -1,22 +0,0 @@
-{
-    "audit_templates":[
-        {
-            "strategy_uuid": null,
-            "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-            "name": "at3",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-                },
-                {
-                    "rel": "bookmark", "href":
-                    "http://controller:9322/audit_templates/b4041d8c-85d7-4224-851d-649fe48b7196"
-                }
-            ],
-            "strategy_name": null,
-            "uuid": "b4041d8c-85d7-4224-851d-649fe48b7196",
-            "goal_name": "dummy", "scope": []
-        }
-    ]
-}
--- a/api-ref/source/samples/audittemplate-show-response.json
+++ b/api-ref/source/samples/audittemplate-show-response.json
@@ -1,23 +0,0 @@
-{
-    "description": "test 1",
-    "strategy_uuid": null,
-    "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-    "name": "at1",
-    "uuid": "0d100c27-14af-4962-86fb-f6079287c9c6",
-    "goal_name": "dummy",
-    "scope": [],
-    "created_at": "2018-04-04T07:48:36.175472+00:00",
-    "deleted_at": null,
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audit_templates/0d100c27-14af-4962-86fb-f6079287c9c6"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audit_templates/0d100c27-14af-4962-86fb-f6079287c9c6"
-        }
-    ],
-    "strategy_name": null,
-    "updated_at": "2018-04-05T07:57:55.803650+00:00"
-}
--- a/api-ref/source/samples/audittemplate-update-request.json
+++ b/api-ref/source/samples/audittemplate-update-request.json
@@ -1,7 +0,0 @@
-[
-    {
-        "op": "replace",
-        "value": "PENDING",
-        "path": "/state"
-    }
-]
--- a/api-ref/source/samples/audittemplate-update-response.json
+++ b/api-ref/source/samples/audittemplate-update-response.json
@@ -1,23 +0,0 @@
-{
-    "description": "test 1",
-    "strategy_uuid": null,
-    "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-    "name": "at11",
-    "uuid": "0d100c27-14af-4962-86fb-f6079287c9c6",
-    "goal_name": "dummy",
-    "scope": [],
-    "created_at": "2018-04-04T07:48:36.175472+00:00",
-    "deleted_at": null,
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/audit_templates/0d100c27-14af-4962-86fb-f6079287c9c6"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/audit_templates/0d100c27-14af-4962-86fb-f6079287c9c6"
-        }
-    ],
-    "strategy_name": null,
-    "updated_at": "2018-04-05T07:57:42.139127+00:00"
-}
--- a/api-ref/source/samples/goal-list-response.json
+++ b/api-ref/source/samples/goal-list-response.json
@@ -1,55 +0,0 @@
-{
-    "goals": [
-        {
-            "efficacy_specification": [],
-            "uuid": "e1a5a45b-f251-47cf-9c5f-fa1e66e1286a",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/goals/e1a5a45b-f251-47cf-9c5f-fa1e66e1286a"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/goals/e1a5a45b-f251-47cf-9c5f-fa1e66e1286a"
-                }
-            ],
-            "name": "workload_balancing",
-            "display_name": "Workload Balancing"
-        },
-        {
-            "efficacy_specification": [
-                {
-                    "description": "The total number of enabled compute nodes.",
-                    "schema": "Range(min=0, max=None, min_included=True, max_included=True, msg=None)",
-                    "name": "compute_nodes_count",
-                    "unit": null
-                },
-                {
-                    "description": "The number of compute nodes to be released.",
-                    "schema": "Range(min=0, max=None, min_included=True, max_included=True, msg=None)",
-                    "name": "released_compute_nodes_count",
-                    "unit": null
-                },
-                {
-                    "description": "The number of VM migrations to be performed.",
-                    "schema": "Range(min=0, max=None, min_included=True, max_included=True, msg=None)",
-                    "name": "instance_migrations_count",
-                    "unit": null
-                }
-            ],
-            "uuid": "cb9afa5e-aec7-4a8c-9261-c15c33f2262b",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/goals/cb9afa5e-aec7-4a8c-9261-c15c33f2262b"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/goals/cb9afa5e-aec7-4a8c-9261-c15c33f2262b"
-                }
-            ],
-            "name": "server_consolidation",
-            "display_name": "Server Consolidation"
-        }
-    ]
-}
--- a/api-ref/source/samples/goal-show-response.json
+++ b/api-ref/source/samples/goal-show-response.json
@@ -1,19 +0,0 @@
-{
-    "efficacy_specification": [],
-    "name": "saving_energy",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/goals/6f52889a-9dd4-4dbb-8e70-39b56c4836cc"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/goals/6f52889a-9dd4-4dbb-8e70-39b56c4836cc"
-        }
-    ],
-    "uuid": "6f52889a-9dd4-4dbb-8e70-39b56c4836cc",
-    "updated_at": null,
-    "display_name": "Saving Energy",
-    "created_at": "2018-03-26T11:55:24.365584+00:00",
-    "deleted_at": null
-}
--- a/api-ref/source/samples/scoring_engine-list-detailed-response.json
+++ b/api-ref/source/samples/scoring_engine-list-detailed-response.json
@@ -1,20 +0,0 @@
-{
-    "scoring_engines": [
-        {
-            "description": "Dummy Scorer calculating the average value",
-            "uuid": "5a44f007-55b1-423c-809f-6a274a9bd93b",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/scoring_engines/5a44f007-55b1-423c-809f-6a274a9bd93b"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/scoring_engines/5a44f007-55b1-423c-809f-6a274a9bd93b"
-                }
-            ],
-            "name": "dummy_avg_scorer",
-            "metainfo": ""
-        }
-    ]
-}
--- a/api-ref/source/samples/scoring_engine-list-response.json
+++ b/api-ref/source/samples/scoring_engine-list-response.json
@@ -1,19 +0,0 @@
-{
-    "scoring_engines": [
-        {
-            "description": "Dummy Scorer calculating the average value",
-            "uuid": "5a44f007-55b1-423c-809f-6a274a9bd93b",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/scoring_engines/5a44f007-55b1-423c-809f-6a274a9bd93b"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/scoring_engines/5a44f007-55b1-423c-809f-6a274a9bd93b"
-                }
-            ],
-            "name": "dummy_avg_scorer"
-        }
-    ]
-}
--- a/api-ref/source/samples/scoring_engine-show-response.json
+++ b/api-ref/source/samples/scoring_engine-show-response.json
@@ -1,16 +0,0 @@
-{
-    "description": "Dummy Scorer calculating the maximum value",
-    "uuid": "1ac42282-4e77-473e-898b-62ea007f1deb",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/scoring_engines/1ac42282-4e77-473e-898b-62ea007f1deb"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/scoring_engines/1ac42282-4e77-473e-898b-62ea007f1deb"
-        }
-    ],
-    "name": "dummy_max_scorer",
-    "metainfo": ""
-}
--- a/api-ref/source/samples/service-list-detailed-response.json
+++ b/api-ref/source/samples/service-list-detailed-response.json
@@ -1,24 +0,0 @@
-{
-    "services": [
-        {
-            "status": "ACTIVE",
-            "name": "watcher-applier",
-            "host": "controller",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/services/1"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/services/1"
-                }
-            ],
-            "id": 1,
-            "deleted_at": null,
-            "updated_at": "2018-04-26T08:52:37.652895+00:00",
-            "last_seen_up": "2018-04-26T08:52:37.648572",
-            "created_at": "2018-03-26T11:55:24.075093+00:00"
-        }
-    ]
-}
--- a/api-ref/source/samples/service-list-response.json
+++ b/api-ref/source/samples/service-list-response.json
@@ -1,36 +0,0 @@
-{
-    "services": [
-        {
-            "id": 1,
-            "status": "ACTIVE",
-            "name": "watcher-applier",
-            "host": "controller",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/services/1"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/services/1"
-                }
-            ]
-        },
-        {
-            "id": 2,
-            "status": "ACTIVE",
-            "name": "watcher-decision-engine",
-            "host": "controller",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/services/2"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/services/2"
-                }
-            ]
-        }
-    ]
-}
--- a/api-ref/source/samples/service-show-response.json
+++ b/api-ref/source/samples/service-show-response.json
@@ -1,20 +0,0 @@
-{
-    "status": "ACTIVE",
-    "name": "watcher-applier",
-    "host": "controller",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/services/1"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/services/1"
-        }
-    ],
-    "id": 1,
-    "deleted_at": null,
-    "updated_at": "2018-04-26T09:45:37.653061+00:00",
-    "last_seen_up": "2018-04-26T09:45:37.649314",
-    "created_at": "2018-03-26T11:55:24.075093+00:00"
-}
--- a/api-ref/source/samples/strategy-list-detailed-response.json
+++ b/api-ref/source/samples/strategy-list-detailed-response.json
@@ -1,35 +0,0 @@
-{
-    "strategies": [
-        {
-            "goal_uuid": "cb9afa5e-aec7-4a8c-9261-c15c33f2262b",
-            "name": "vm_workload_consolidation",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/strategies/6382b2d7-259e-487d-88db-78c852ffea54"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/strategies/6382b2d7-259e-487d-88db-78c852ffea54"
-                }
-            ],
-            "parameters_spec": {
-                "properties": {
-                    "granularity": {
-                        "default": 300,
-                        "type": "number",
-                        "description": "The time between two measures in an aggregated timeseries of a metric."
-                    },
-                    "period": {
-                        "default": 3600,
-                        "type": "number",
-                        "description": "The time interval in seconds for getting statistic aggregation"
-                    }
-                }
-            },
-            "uuid": "6382b2d7-259e-487d-88db-78c852ffea54",
-            "goal_name": "server_consolidation",
-            "display_name": "VM Workload Consolidation Strategy"
-        }
-    ]
-}
--- a/api-ref/source/samples/strategy-list-response.json
+++ b/api-ref/source/samples/strategy-list-response.json
@@ -1,21 +0,0 @@
-{
-    "strategies": [
-        {
-            "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-            "name": "dummy",
-            "links": [
-                {
-                    "rel": "self",
-                    "href": "http://controller:9322/v1/strategies/e311727b-b9b3-43ef-a5f7-8bd7ea80df25"
-                },
-                {
-                    "rel": "bookmark",
-                    "href": "http://controller:9322/strategies/e311727b-b9b3-43ef-a5f7-8bd7ea80df25"
-                }
-            ],
-            "uuid": "e311727b-b9b3-43ef-a5f7-8bd7ea80df25",
-            "goal_name": "dummy",
-            "display_name": "Dummy strategy"
-        }
-    ]
-}
--- a/api-ref/source/samples/strategy-show-response.json
+++ b/api-ref/source/samples/strategy-show-response.json
@@ -1,33 +0,0 @@
-{
-    "goal_uuid": "4690f8ba-18ff-45c1-99e9-159556d23810",
-    "name": "dummy",
-    "links": [
-        {
-            "rel": "self",
-            "href": "http://controller:9322/v1/strategies/e311727b-b9b3-43ef-a5f7-8bd7ea80df25"
-        },
-        {
-            "rel": "bookmark",
-            "href": "http://controller:9322/strategies/e311727b-b9b3-43ef-a5f7-8bd7ea80df25"
-        }
-    ],
-    "parameters_spec": {
-        "properties": {
-            "para2": {
-                "default": "hello",
-                "type": "string",
-                "description": "string parameter example"
-            },
-            "para1": {
-                "maximum": 10.2,
-                "type": "number",
-                "minimum": 1.0,
-                "description": "number parameter example",
-                "default": 3.2
-            }
-        }
-    },
-    "uuid": "e311727b-b9b3-43ef-a5f7-8bd7ea80df25",
-    "goal_name": "dummy",
-    "display_name": "Dummy strategy"
-}
--- a/api-ref/source/samples/strategy-state-response.json
+++ b/api-ref/source/samples/strategy-state-response.json
@@ -1,49 +0,0 @@
-[
-    {
-        "state": "gnocchi: available",
-        "comment": "",
-        "mandatory": true,
-        "type": "Datasource"
-    },
-    {
-        "state": [
-            {
-                "compute.node.cpu.percent": "available"
-            },
-            {
-                "cpu_util": "available"
-            },
-            {
-                "memory.resident": "available"
-            },
-            {
-                "hardware.memory.used": "available"
-            }
-        ],
-        "comment": "",
-        "mandatory": false,
-        "type": "Metrics"
-    },
-    {
-        "state": [
-            {
-                "compute_model": "available"
-            },
-            {
-                "storage_model": "not available"
-            },
-            {
-                "baremetal_model": "not available"
-            }
-        ],
-        "comment": "",
-        "mandatory": true,
-        "type": "CDM"
-    },
-    {
-        "state": "workload_stabilization",
-        "mandatory": "",
-        "comment": "",
-        "type": "Name"
-    }
-]
--- a/api-ref/source/watcher-api-v1-actionplans.inc
+++ b/api-ref/source/watcher-api-v1-actionplans.inc
@@ -1,258 +0,0 @@
-.. -*- rst -*-
-
-============
-Action Plans
-============
-
-An ``Action Plan`` specifies a flow of ``Actions`` that should be executed
-in order to satisfy a given ``Goal``. It also contains an estimated
-``global efficacy`` alongside a set of ``efficacy indicators``.
-
-An ``Action Plan`` is generated by Watcher when an ``Audit`` is successful
-which implies that the ``Strategy`` which was used has found a ``Solution``
-to achieve the ``Goal`` of this ``Audit``.
-
-In the default implementation of Watcher, an action plan is composed of
-a graph of linked ``Actions``. Each action may have parent actions, which
-should be executed prior to child action.
-
-Start Action Plan
-=================
-
-.. rest_method::  POST /v1/action_plans/{actionplan_ident}/start
-
-Starts a created Action Plan resource.
-
-Normal response codes: 200
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - actionplan_ident: actionplan_ident
-
-Response
--------
-
-The list and example below are representative of the response as of API
-version 1:
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - state: actionplan_state
-    - audit_uuid: actionplan_audit_uuid
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - efficacy_indicators: actionplan_efficacy_indicators
-    - global_efficacy: actionplan_global_efficacy
-    - links: links
-    - hostname: actionplan_hostname
-
-**Example JSON representation of an Action Plan:**
-
-.. literalinclude:: samples/actionplan-start-response.json
-   :language: javascript
-
-List Action Plan
-================
-
-.. rest_method::  GET /v1/action_plans
-
-Returns a list of Action Plan resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_uuid: r_audit
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - state: actionplan_state
-    - audit_uuid: actionplan_audit_uuid
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - efficacy_indicators: actionplan_efficacy_indicators
-    - global_efficacy: actionplan_global_efficacy
-    - links: links
-
-**Example JSON representation of an Action Plan:**
-
-.. literalinclude:: samples/actionplan-list-response.json
-   :language: javascript
-
-List Action Plan detailed
-=========================
-
-.. rest_method::  GET /v1/action_plans/detail
-
-Returns a list of Action Plan resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_uuid: r_audit
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - deleted_at: deleted_at
-    - updated_at: updated_at
-    - created_at: created_at
-    - uuid: uuid
-    - state: actionplan_state
-    - audit_uuid: actionplan_audit_uuid
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - efficacy_indicators: actionplan_efficacy_indicators
-    - global_efficacy: actionplan_global_efficacy
-    - links: links
-    - hostname: actionplan_hostname
-
-**Example JSON representation of an Action Plan:**
-
-.. literalinclude:: samples/actionplan-list-detailed-response.json
-   :language: javascript
-
-Show Action Plan
-================
-
-.. rest_method::  GET /v1/action_plans/{actionplan_ident}
-
-Shows details for an Action Plan.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - actionplan_ident: actionplan_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - state: actionplan_state
-    - audit_uuid: actionplan_audit_uuid
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - efficacy_indicators: actionplan_efficacy_indicators
-    - global_efficacy: actionplan_global_efficacy
-    - links: links
-    - hostname: actionplan_hostname
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/actionplan-show-response.json
-   :language: javascript
-
-Cancel Action Plan
-==================
-
-.. rest_method::  PATCH /v1/action_plans/{actionplan_ident}
-
-Cancels a created Action Plan resource.
-
-.. note:
-    If Action Plan is in ONGOING state, then ``state`` attribute should be
-    replaced with ``CANCELLING`` value. Otherwise, ``CANCELLED`` is to be
-    used.
-
-Normal response codes: 200
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - actionplan_ident: actionplan_ident
-
-**Example Action Plan ONGOING cancelling request:**
-
-.. literalinclude:: samples/actionplan-cancel-request-cancelling.json
-   :language: javascript
-
-**Example Action Plan PENDING cancelling request:**
-
-.. literalinclude:: samples/actionplan-cancel-request-pending.json
-   :language: javascript
-
-Response
--------
-
-The list and example below are representative of the response as of API
-version 1:
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - state: actionplan_state
-    - audit_uuid: actionplan_audit_uuid
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - efficacy_indicators: actionplan_efficacy_indicators
-    - global_efficacy: actionplan_global_efficacy
-    - links: links
-    - hostname: actionplan_hostname
-
-**Example JSON representation of an Action Plan:**
-
-.. literalinclude:: samples/actionplan-start-response.json
-   :language: javascript
-
-Delete Action Plan
-==================
-
-.. rest_method::  DELETE /v1/action_plans/{actionplan_ident}
-
-Deletes an Action Plan. Action Plan can be deleted only from SUCCEEDED, RECOMMENDED, FAILED, SUPERSEDED, CANCELLED states.
-
-Normal response codes: 204
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - actionplan_ident: actionplan_ident
--- a/api-ref/source/watcher-api-v1-actions.inc
+++ b/api-ref/source/watcher-api-v1-actions.inc
@@ -1,155 +0,0 @@
-.. -*- rst -*-
-
-=======
-Actions
-=======
-
-An ``Action`` is what enables Watcher to transform the current state of a
-``Cluster`` after an ``Audit``.
-
-An ``Action`` is an atomic task which changes the current state of a target
-Managed resource of the OpenStack ``Cluster`` such as:
-
-  Live migration of an instance from one compute node to another compute
-   node with Nova
-  Changing the power level of a compute node (ACPI level, ...)
-  Changing the current state of a compute node (enable or disable) with Nova
-
-In most cases, an ``Action`` triggers some concrete commands on an existing
-OpenStack module (Nova, Neutron, Cinder, Ironic, etc.).
-
-An ``Action`` has a life-cycle and its current state may be one of the
-following:
-
-  **PENDING** : the ``Action`` has not been executed yet by the
-   ``Watcher Applier``.
-  **ONGOING** : the ``Action`` is currently being processed by the
-   ``Watcher Applier``.
-  **SUCCEEDED** : the ``Action`` has been executed successfully
-  **FAILED** : an error occurred while trying to execute the ``Action``.
-  **DELETED** : the ``Action`` is still stored in the ``Watcher database``
-   but is not returned any more through the Watcher APIs.
-  **CANCELLED** : the ``Action`` was in **PENDING** or **ONGOING** state and
-   was cancelled by the ``Administrator``
-
-``Actions`` are created by ``Watcher Planner`` as result of Audit's execution.
-``Action`` can't be created, modified or deleted by user.
-
-List Action
-===========
-
-.. rest_method::  GET /v1/actions
-
-Returns a list of Action resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - action_plan_uuid: r_action_plan
-   - audit_uuid: r_audit
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - action_type: action_type
-    - state: action_state
-    - action_plan_uuid: action_action_plan_uuid
-    - parents: action_parents
-    - links: links
-
-**Example JSON representation of an Action:**
-
-.. literalinclude:: samples/actions-list-response.json
-   :language: javascript
-
-List Action Detailed
-====================
-
-.. rest_method::  GET /v1/actions/detail
-
-Returns a list of Action resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - action_plan_uuid: r_action_plan
-   - audit_uuid: r_audit
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - action_type: action_type
-    - state: action_state
-    - action_plan_uuid: action_action_plan_uuid
-    - parents: action_parents
-    - description: action_description
-    - input_parameters: action_input_parameters
-    - links: links
-
-**Example JSON representation of an Action:**
-
-.. literalinclude:: samples/actions-list-detailed-response.json
-   :language: javascript
-
-Show Action
-===========
-
-.. rest_method::  GET /v1/actions/{action_ident}
-
-Shows details for an Action.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - action_ident: action_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - action_type: action_type
-    - state: action_state
-    - action_plan_uuid: action_action_plan_uuid
-    - parents: action_parents
-    - description: action_description
-    - input_parameters: action_input_parameters
-    - links: links
-
-**Example JSON representation of an Action:**
-
-.. literalinclude:: samples/actions-show-response.json
-   :language: javascript
--- a/api-ref/source/watcher-api-v1-audits.inc
+++ b/api-ref/source/watcher-api-v1-audits.inc
@@ -1,361 +0,0 @@
-.. -*- rst -*-
-
-======
-Audits
-======
-
-There are creating, listing, updating and deleting methods of Watcher Audit
-resources which are implemented via the ``/v1/audits`` resource.
-
-In the Watcher system, an ``Audit`` is a request for optimizing a ``Cluster``.
-
-The optimization is done in order to satisfy one ``Goal`` on a given
-``Cluster``.
-
-For each ``Audit``, the Watcher system generates an ``Action Plan``.
-
-Create Audit
-============
-
-.. rest_method::  POST /v1/audits
-
-Creates a new Audit resource.
-
-Mandatory attribute to be supplied: ``audit_type``.
-
-``Audit`` can be created either based on existed ``Audit Template`` or by
-itself. In the first case, there also should be supplied
-``audit_template_uuid``. If ``Audit`` is created without ``Audit Template``,
-``goal`` should be provided.
-
-Normal response codes: 201
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_template_uuid: audittemplate_uuid
-   - audit_type: audit_type
-   - name: audit_name
-   - goal: audit_goal
-   - strategy: audit_strategy
-   - parameters: audit_parameters
-   - interval: audit_interval
-   - auto_trigger: audit_autotrigger
-   - start_time: audit_starttime_req
-   - end_time: audit_endtime_req
-
-**Example ONESHOT Audit creation request:**
-
-.. literalinclude:: samples/audit-create-request-oneshot.json
-   :language: javascript
-
-**Example CONTINUOUS Audit creation request with a specified strategy:**
-
-.. literalinclude:: samples/audit-create-request-continuous.json
-   :language: javascript
-
-Response
--------
-
-The list and example below are representative of the response as of API
-version 1:
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - parameters: audit_parameters
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-    - hostname: audit_hostname
-    - start_time: audit_starttime_resp
-    - end_time: audit_endtime_resp
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-create-response.json
-   :language: javascript
-
-List Audit
-==========
-
-.. rest_method::  GET /v1/audits
-
-Returns a list of Audit resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-list-response.json
-   :language: javascript
-
-List Audit Detailed
-===================
-
-.. rest_method::  GET /v1/audits/detail
-
-Returns a list of Audit resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - parameters: audit_parameters
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-    - hostname: audit_hostname
-    - start_time: audit_starttime_resp
-    - end_time: audit_endtime_resp
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-list-detailed-response.json
-   :language: javascript
-
-Show Audit
-==========
-
-.. rest_method::  GET /v1/audits/{audit_ident}
-
-Shows details for an Audit.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_ident: audit_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - parameters: audit_parameters
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-    - hostname: audit_hostname
-    - start_time: audit_starttime_resp
-    - end_time: audit_endtime_resp
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-show-response.json
-   :language: javascript
-
-Cancel Audit
-============
-
-.. rest_method::  PATCH /v1/audits/{audit_ident}
-
-Cancels an ONGOING Audit resource.
-
-Normal response codes: 200
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_ident: audit_ident
-
-**Example Audit cancelling request:**
-
-.. literalinclude:: samples/audit-cancel-request.json
-   :language: javascript
-
-Response
--------
-
-The list and example below are representative of the response as of API
-version 1:
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - parameters: audit_parameters
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-    - hostname: audit_hostname
-    - start_time: audit_starttime_resp
-    - end_time: audit_endtime_resp
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-cancel-response.json
-   :language: javascript
-
-Update Audit
-============
-
-.. rest_method::  PATCH /v1/audits/{audit_ident}
-
-Updates an Audit with the given information.
-
-.. note:
-    ``audit_type`` shouldn't be changed by PATCH method.
-
-Normal response codes: 200
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_ident: audit_ident
-
-**Example PATCH document updating Audit:**
-
-.. literalinclude:: samples/audit-update-request.json
-   :language: javascript
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audit_name
-    - audit_type: audit_type
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - interval: audit_interval
-    - next_run_time: audit_next_run_time
-    - parameters: audit_parameters
-    - auto_trigger: audit_autotrigger
-    - state: audit_state
-    - scope: audittemplate_scope
-    - links: links
-    - hostname: audit_hostname
-    - start_time: audit_starttime_resp
-    - end_time: audit_endtime_resp
-
-**Example JSON representation of an Audit:**
-
-.. literalinclude:: samples/audit-update-response.json
-   :language: javascript
-
-Delete Audit
-============
-
-.. rest_method::  DELETE /v1/audits/{audit_ident}
-
-Deletes an Audit. Audit can be deleted only from FAILED, SUCCEEDED, CANCELLED,
-SUSPENDED states.
-
-Normal response codes: 204
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audit_ident: audit_ident
--- a/api-ref/source/watcher-api-v1-audittemplates.inc
+++ b/api-ref/source/watcher-api-v1-audittemplates.inc
@@ -1,257 +0,0 @@
-.. -*- rst -*-
-
-===============
-Audit Templates
-===============
-
-There are creating, listing, updating and deleting methods of Watcher Audit
-Template resources which are implemented via the ``/v1/audit_templates``
-resource.
-
-An Audit may be launched several times with the same settings
-(Goal, thresholds, ...). Therefore it makes sense to save those settings in
-some sort of Audit preset object, which is known as an Audit Template.
-
-An Audit Template contains at least the Goal of the Audit.
-
-Create Audit Template
-=====================
-
-.. rest_method::  POST /v1/audit_templates
-
-Creates a new Audit Template resource.
-
-It requires ``name`` and ``goal`` attributes to be supplied in the request
-body.
-
-Normal response codes: 201
-
-Error codes: 400,404,409
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - name: audittemplate_name
-   - goal: audittemplate_goal
-   - strategy: audittemplate_strategy
-   - description: audittemplate_description
-   - scope: audittemplate_scope
-
-**Example Audit Template creation request without a specified strategy:**
-
-.. literalinclude:: samples/audittemplate-create-request-minimal.json
-   :language: javascript
-
-**Example Audit Template creation request with a specified strategy:**
-
-.. literalinclude:: samples/audittemplate-create-request-full.json
-   :language: javascript
-
-Response
--------
-
-The list and example below are representative of the response as of API
-version 1:
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audittemplate_name
-    - description: audittemplate_description
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - scope: audittemplate_scope
-    - links: links
-
-**Example JSON representation of an Audit Template:**
-
-.. literalinclude:: samples/audittemplate-create-response.json
-   :language: javascript
-
-List Audit Template
-===================
-
-.. rest_method::  GET /v1/audit_templates
-
-Returns a list of Audit Template resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audittemplate_name
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - scope: audittemplate_scope
-    - links: links
-
-**Example JSON representation of an Audit Template:**
-
-.. literalinclude:: samples/audittemplate-list-response.json
-   :language: javascript
-
-List Audit Template Detailed
-============================
-
-.. rest_method::  GET /v1/audit_templates/detail
-
-Returns a list of Audit Template resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - strategy: r_strategy
-   - limit: limit
-   - marker: marker
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audittemplate_name
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - scope: audittemplate_scope
-    - links: links
-    - description: audittemplate_description
-
-**Example JSON representation of an Audit Template:**
-
-.. literalinclude:: samples/audittemplate-list-detailed-response.json
-   :language: javascript
-
-Show Audit Template
-===================
-
-.. rest_method::  GET /v1/audit_templates/{audittemplate_ident}
-
-Shows details for an Audit Template.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audittemplate_ident: audittemplate_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audittemplate_name
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - scope: audittemplate_scope
-    - links: links
-    - description: audittemplate_description
-
-**Example JSON representation of an Audit Template:**
-
-.. literalinclude:: samples/audittemplate-show-response.json
-   :language: javascript
-
-Update Audit Template
-=====================
-
-.. rest_method::  PATCH /v1/audit_templates/{audittemplate_ident}
-
-Updates an Audit Template with the given information.
-
-Normal response codes: 200
-
-Error codes: 400,404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audittemplate_ident: audittemplate_ident
-
-**Example PATCH document updating Audit Template:**
-
-.. literalinclude:: samples/audittemplate-update-request.json
-   :language: javascript
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: audittemplate_name
-    - strategy_uuid: strategy_uuid
-    - strategy_name: strategy_name
-    - goal_uuid: goal_uuid
-    - goal_name: goal_name
-    - scope: audittemplate_scope
-    - links: links
-    - description: audittemplate_description
-
-**Example JSON representation of an Audit Template:**
-
-.. literalinclude:: samples/audittemplate-update-response.json
-   :language: javascript
-
-Delete Audit Template
-=====================
-
-.. rest_method::  DELETE /v1/audit_templates/{audittemplate_ident}
-
-Deletes an Audit Template.
-
-Normal response codes: 204
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - audittemplate_ident: audittemplate_ident
--- a/api-ref/source/watcher-api-v1-goals.inc
+++ b/api-ref/source/watcher-api-v1-goals.inc
@@ -1,126 +0,0 @@
-.. -*- rst -*-
-
-=====
-Goals
-=====
-
-A ``Goal`` is a human readable, observable and measurable end result having
-one objective to be achieved.
-
-Here are some examples of ``Goals``:
-
-  minimize the energy consumption
-  minimize the number of compute nodes (consolidation)
-  balance the workload among compute nodes
-  minimize the license cost (some softwares have a licensing model which is
-   based on the number of sockets or cores where the software is deployed)
-  find the most appropriate moment for a planned maintenance on a
-   given group of host (which may be an entire availability zone):
-   power supply replacement, cooling system replacement, hardware
-   modification, ...
-
-List Goal
-=========
-
-.. rest_method::  GET /v1/goals
-
-Returns a list of Goal resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - efficacy_specification: goal_efficacy_specification
-    - name: goal_name
-    - display_name: goal_display_name
-    - links: links
-
-**Example JSON representation of a Goal:**
-
-.. literalinclude:: samples/goal-list-response.json
-   :language: javascript
-
-List Goal Detailed
-==================
-
-.. rest_method::  GET /v1/goals/detail
-
-Returns a list of Goal resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - efficacy_specification: goal_efficacy_specification
-    - name: goal_name
-    - display_name: goal_display_name
-    - links: links
-
-**Example JSON representation of a Goal:**
-
-.. literalinclude:: samples/goal-list-response.json
-   :language: javascript
-
-Show Goal
-=========
-
-.. rest_method::  GET /v1/goals/{goal_ident}
-
-Shows details for an Goal.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal_ident: goal_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - efficacy_specification: goal_efficacy_specification
-    - name: goal_name
-    - display_name: goal_display_name
-    - links: links
-
-**Example JSON representation of a Goal:**
-
-.. literalinclude:: samples/goal-show-response.json
-   :language: javascript
--- a/api-ref/source/watcher-api-v1-scoring_engines.inc
+++ b/api-ref/source/watcher-api-v1-scoring_engines.inc
@@ -1,120 +0,0 @@
-.. -*- rst -*-
-
-===============
-Scoring Engines
-===============
-
-A ``Scoring Engine`` is an executable that has a well-defined input, a
-well-defined output, and performs a purely mathematical task. That is,
-the calculation does not depend on the environment in which it is running - it
-would produce the same result anywhere.
-
-Because there might be multiple algorithms used to build a particular data
-model (and therefore a scoring engine), the usage of scoring engine might
-vary. A metainfo field is supposed to contain any information which might
-be needed by the user of a given scoring engine.
-
-List Scoring Engine
-===================
-
-.. rest_method::  GET /v1/scoring_engines
-
-Returns a list of Scoring Engine resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: scoring_engine_name
-    - description: scoring_engine_description
-    - links: links
-
-**Example JSON representation of a Scoring Engine:**
-
-.. literalinclude:: samples/scoring_engine-list-response.json
-   :language: javascript
-
-List Scoring Engine Detailed
-============================
-
-.. rest_method::  GET /v1/scoring_engines/detail
-
-Returns a list of Scoring Engine resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: scoring_engine_name
-    - description: scoring_engine_description
-    - metainfo: scoring_engine_metainfo
-    - links: links
-
-**Example JSON representation of a Scoring Engine:**
-
-.. literalinclude:: samples/scoring_engine-list-detailed-response.json
-   :language: javascript
-
-Show Scoring Engine
-===================
-
-.. rest_method::  GET /v1/scoring_engines/{scoring_engine_ident}
-
-Shows details for a Scoring Engine resource.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - scoring_engine_ident: scoring_engine_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: scoring_engine_name
-    - description: scoring_engine_description
-    - metainfo: scoring_engine_metainfo
-    - links: links
-
-**Example JSON representation of a Scoring Engine:**
-
-.. literalinclude:: samples/scoring_engine-show-response.json
-   :language: javascript
--- a/api-ref/source/watcher-api-v1-services.inc
+++ b/api-ref/source/watcher-api-v1-services.inc
@@ -1,116 +0,0 @@
-.. -*- rst -*-
-
-========
-Services
-========
-
-This resource represents Watcher services, their states and hosts they are
-placed on.
-
-List Service
-============
-
-.. rest_method::  GET /v1/services
-
-Returns a list of Service resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - id: service_id
-    - name: service_name
-    - host: service_host
-    - status: service_status
-    - links: links
-
-**Example JSON representation of a Service:**
-
-.. literalinclude:: samples/service-list-response.json
-   :language: javascript
-
-List Service Detailed
-=====================
-
-.. rest_method::  GET /v1/services/detail
-
-Returns a list of Service resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - id: service_id
-    - name: service_name
-    - host: service_host
-    - status: service_status
-    - last_seen_up: service_last_seen_up
-    - links: links
-
-**Example JSON representation of a Service:**
-
-.. literalinclude:: samples/service-list-detailed-response.json
-   :language: javascript
-
-Show Service
-============
-
-.. rest_method::  GET /v1/services/{service_ident}
-
-Shows details for a Service resource.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - service_ident: service_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - id: service_id
-    - name: service_name
-    - host: service_host
-    - status: service_status
-    - last_seen_up: service_last_seen_up
-    - links: links
-
-**Example JSON representation of a Service:**
-
-.. literalinclude:: samples/service-show-response.json
-   :language: javascript
--- a/api-ref/source/watcher-api-v1-strategies.inc
+++ b/api-ref/source/watcher-api-v1-strategies.inc
@@ -1,164 +0,0 @@
-.. -*- rst -*-
-
-==========
-Strategies
-==========
-
-A ``Strategy`` is an algorithm implementation which is able to find a
-``Solution`` for a given ``Goal``. To get more information about strategies
-that are shipped along with Watcher, visit `strategies page`_.
-
-There may be several potential strategies which are able to achieve the same
-``Goal``. This is why it is possible to configure which specific ``Strategy``
-should be used for each goal.
-
-Some strategies may provide better optimization results but may take more time
-to find an optimal ``Solution``.
-
-.. _`strategies page`: https://docs.openstack.org/watcher/latest/strategies/index.html
-
-List Strategy
-=============
-
-.. rest_method::  GET /v1/strategies
-
-Returns a list of Strategy resources.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: strategy_name
-    - display_name: strategy_display_name
-    - goal_name: goal_name
-    - goal_uuid: goal_uuid
-    - links: links
-
-**Example JSON representation of a Strategy:**
-
-.. literalinclude:: samples/strategy-list-response.json
-   :language: javascript
-
-List Strategy Detailed
-======================
-
-.. rest_method::  GET /v1/strategies/detail
-
-Returns a list of Strategy resources with complete details.
-
-Normal response codes: 200
-
-Error codes: 400,401
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - goal: r_goal
-   - limit: limit
-   - sort_dir: sort_dir
-   - sort_key: sort_key
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: strategy_name
-    - display_name: strategy_display_name
-    - parameters_spec: strategy_parameters_spec
-    - goal_name: goal_name
-    - goal_uuid: goal_uuid
-    - links: links
-
-**Example JSON representation of a Strategy:**
-
-.. literalinclude:: samples/strategy-list-detailed-response.json
-   :language: javascript
-
-Show Strategy
-=============
-
-.. rest_method::  GET /v1/strategies/{strategy_ident}
-
-Shows details for a Strategy resource.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - strategy_ident: strategy_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - uuid: uuid
-    - name: strategy_name
-    - display_name: strategy_display_name
-    - parameters_spec: strategy_parameters_spec
-    - goal_name: goal_name
-    - goal_uuid: goal_uuid
-    - links: links
-
-**Example JSON representation of a Strategy:**
-
-.. literalinclude:: samples/strategy-show-response.json
-   :language: javascript
-
-Show Strategy State
-===================
-
-.. rest_method::  GET /v1/strategies/{strategy_ident}/state
-
-Retrieve an information about strategy requirements.
-
-Normal response codes: 200
-
-Error codes: 404
-
-Request
-------
-
-.. rest_parameters:: parameters.yaml
-
-   - strategy_ident: strategy_ident
-
-Response
--------
-
-.. rest_parameters:: parameters.yaml
-
-    - state: strategy_check_state
-    - comment: strategy_check_comment
-    - mandatory: strategy_check_mandatory
-    - type: strategy_check_type
-
-**Example JSON representation of a Strategy:**
-
-.. literalinclude:: samples/strategy-state-response.json
-   :language: javascript
--- a/api-ref/source/watcher-api-versions.inc
+++ b/api-ref/source/watcher-api-versions.inc
@@ -1,81 +0,0 @@
-.. -*- rst -*-
-
-============
-API versions
-============
-
-In order to bring new features to users over time, the Watcher API
-supports versioning. There are two kinds of versions in Watcher.
-
- ''major versions'', which have dedicated URLs.
- ''microversions'', which can be requested using the
-  ``OpenStack-API-Version`` header.
-
-.. note:: The maximum microversion depends on release.
-  Please reference:
-  `API Microversion History
-  <https://docs.openstack.org/watcher/latest/contributor/api_microversion_history.html>`__
-  for API microversion history details.
-
-The Version API resource works differently from other API resources as they *do not*
-require authentication.
-
-If Watcher receives a request with unsupported version, it responds with a 406 Not Acceptable,
-along with the -Min- and -Max- headers that it can support.
-
-List API versions
-=================
-
-.. rest_method::  GET /
-
-This fetches all the information about all known major API versions in the
-deployment. Links to more specific information will be provided for each major
-API version, as well as information about supported min and max microversions.
-
-Normal response codes: 200
-
-Request
-------
-
-Response Example
----------------
-
-.. rest_parameters::  parameters.yaml
-
-    - description: version_description
-    - versions: versions
-    - version: version
-    - id: version_id
-    - links: links
-    - min_version: openstack-api-min-version
-    - max_version: openstack-api-max-version
-
-.. literalinclude:: samples/api-root-response.json
-   :language: javascript
-
-
-Show v1 API
-===========
-
-.. rest_method::  GET /v1/
-
-Show all the resources within the Watcher v1 API.
-
-Normal response codes: 200
-
-Request
-------
-
-Response Example
----------------
-
-.. rest_parameters::  parameters.yaml
-
-    - id: version_id
-    - links: links
-    - OpenStack-API-Version: header_version
-    - OpenStack-API-Minimum-Version: openstack-api-min-version
-    - OpenStack-API-Maximum-Version: openstack-api-max-version
-
-.. literalinclude:: samples/api-v1-root-response.json
-   :language: javascript
--- a/devstack/lib/watcher
+++ b/devstack/lib/watcher
@@ -47,6 +47,9 @@ WATCHER_POLICY_YAML=$WATCHER_CONF_DIR/policy.yaml.sample
 WATCHER_DEVSTACK_DIR=$WATCHER_DIR/devstack
 WATCHER_DEVSTACK_FILES_DIR=$WATCHER_DEVSTACK_DIR/files

+NOVA_CONF_DIR=/etc/nova
+NOVA_CONF=$NOVA_CONF_DIR/nova.conf
+
 if is_ssl_enabled_service "watcher" || is_service_enabled tls-proxy; then
    WATCHER_SERVICE_PROTOCOL="https"
 fi
@@ -148,17 +151,12 @@ function create_watcher_accounts {
 function _config_watcher_apache_wsgi {
    local watcher_apache_conf
    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        local service_port=$WATCHER_SERVICE_PORT
-        if is_service_enabled tls-proxy; then
-            service_port=$WATCHER_SERVICE_PORT_INT
-            service_protocol="http"
-        fi
        sudo mkdir -p $WATCHER_WSGI_DIR
        sudo cp $WATCHER_DIR/watcher/api/app.wsgi $WATCHER_WSGI_DIR/app.wsgi
        watcher_apache_conf=$(apache_site_config_for watcher-api)
        sudo cp $WATCHER_DEVSTACK_FILES_DIR/apache-watcher-api.template $watcher_apache_conf
        sudo sed -e "
-            s|%WATCHER_SERVICE_PORT%|$service_port|g;
+            s|%WATCHER_SERVICE_PORT%|$WATCHER_SERVICE_PORT|g;
            s|%WATCHER_WSGI_DIR%|$WATCHER_WSGI_DIR|g;
            s|%USER%|$STACK_USER|g;
            s|%APIWORKERS%|$API_WORKERS|g;
@@ -179,22 +177,21 @@ function create_watcher_conf {
    iniset $WATCHER_CONF DEFAULT debug "$ENABLE_DEBUG_LOG_LEVEL"
    iniset $WATCHER_CONF DEFAULT control_exchange watcher

-    iniset_rpc_backend watcher $WATCHER_CONF
-
    iniset $WATCHER_CONF database connection $(database_connection_url watcher)
    iniset $WATCHER_CONF api host "$WATCHER_SERVICE_HOST"
-
-    if is_service_enabled tls-proxy; then
-        iniset $WATCHER_CONF api port "$WATCHER_SERVICE_PORT_INT"
-        # iniset $WATCHER_CONF api enable_ssl_api "True"
-    else
-        iniset $WATCHER_CONF api port "$WATCHER_SERVICE_PORT"
-    fi
+    iniset $WATCHER_CONF api port "$WATCHER_SERVICE_PORT"

    iniset $WATCHER_CONF oslo_policy policy_file $WATCHER_POLICY_YAML

+    iniset $WATCHER_CONF oslo_messaging_rabbit rabbit_userid $RABBIT_USERID
+    iniset $WATCHER_CONF oslo_messaging_rabbit rabbit_password $RABBIT_PASSWORD
+    iniset $WATCHER_CONF oslo_messaging_rabbit rabbit_host $RABBIT_HOST
+
    iniset $WATCHER_CONF oslo_messaging_notifications driver "messagingv2"

+    iniset $NOVA_CONF oslo_messaging_notifications topics "notifications,watcher_notifications"
+    iniset $NOVA_CONF notifications notify_on_state_change "vm_and_task_state"
+
    configure_auth_token_middleware $WATCHER_CONF watcher $WATCHER_AUTH_CACHE_DIR
    configure_auth_token_middleware $WATCHER_CONF watcher $WATCHER_AUTH_CACHE_DIR "watcher_clients_auth"

@@ -289,22 +286,20 @@ function start_watcher_api {
        service_protocol="http"
    fi
    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
-        enable_apache_site watcher-api
        restart_apache_server
    else
        run_process watcher-api "$WATCHER_BIN_DIR/watcher-api --config-file $WATCHER_CONF"
    fi
-
-    # Start proxies if enabled
-    if is_service_enabled tls-proxy; then
-        start_tls_proxy watcher '*' $WATCHER_SERVICE_PORT $WATCHER_SERVICE_HOST $WATCHER_SERVICE_PORT_INT
-    fi
-
    echo "Waiting for watcher-api to start..."
    if ! wait_for_service $SERVICE_TIMEOUT $service_protocol://$WATCHER_SERVICE_HOST:$service_port; then
        die $LINENO "watcher-api did not start"
    fi

+    # Start proxies if enabled
+    if is_service_enabled tls-proxy; then
+        start_tls_proxy '*' $WATCHER_SERVICE_PORT $WATCHER_SERVICE_HOST $WATCHER_SERVICE_PORT_INT &
+        start_tls_proxy '*' $EC2_SERVICE_PORT $WATCHER_SERVICE_HOST $WATCHER_SERVICE_PORT_INT &
+    fi
 }

 # start_watcher() - Start running processes, including screen
@@ -319,7 +314,7 @@ function start_watcher {
 function stop_watcher {
    if [[ "$WATCHER_USE_MOD_WSGI" == "True" ]]; then
        disable_apache_site watcher-api
-        restart_apache_server
+	restart_apache_server
    else
        stop_process watcher-api
    fi
--- a/devstack/local.conf.compute
+++ b/devstack/local.conf.compute
@@ -44,3 +44,6 @@ LOGDAYS=2
 [[post-config|$NOVA_CONF]]
 [DEFAULT]
 compute_monitors=cpu.virt_driver
+notify_on_state_change = vm_and_task_state
+[notifications]
+notify_on_state_change = vm_and_task_state
--- a/devstack/local.conf.controller
+++ b/devstack/local.conf.controller
@@ -48,3 +48,6 @@ LOGDAYS=2
 [[post-config|$NOVA_CONF]]
 [DEFAULT]
 compute_monitors=cpu.virt_driver
+notify_on_state_change = vm_and_task_state
+[notifications]
+notify_on_state_change = vm_and_task_state
--- a/devstack/upgrade/from_rocky/upgrade-watcher
+++ b/devstack/upgrade/from_rocky/upgrade-watcher
@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-
-# ``upgrade-watcher``
-
-function configure_watcher_upgrade {
-    XTRACE=$(set +o | grep xtrace)
-    set -o xtrace
-
-    # Copy release-specific files
-    sudo cp $TARGET_RELEASE_DIR/watcher/etc/watcher/watcher.conf $WATCHER_CONF_DIR/watcher.conf
-    sudo cp $TARGET_RELEASE_DIR/watcher/etc/watcher/policy.yaml.sample $WATCHER_CONF_DIR/policy.yaml.sample
-
-    # reset to previous state
-    $XTRACE
-}
--- a/devstack/upgrade/resources.sh
+++ b/devstack/upgrade/resources.sh
@@ -1,126 +0,0 @@
-#!/bin/bash
-
-set -o errexit
-
-source $GRENADE_DIR/grenaderc
-source $GRENADE_DIR/functions
-
-source $TOP_DIR/openrc admin demo
-
-set -o xtrace
-
-function _wait_for_status {
-     while :
-     do
-         state=$("${@:2}" -f value -c State)
-         [[ $state == "SUCCEEDED" ]] && break
-         if [ $state == "ERROR" ]; then
-             die $LINENO "ERROR creating audit"
-         fi
-         sleep 10
-     done
- }
-
-function create_audit_template {
-    at_id=$(openstack optimize audittemplate create d1 dummy -s dummy -f value -c UUID)
-    resource_save watcher at_id $at_id
- }
-
-function create_audit {
-    audit_id=$(openstack optimize audit create -s dummy -g dummy -f value -c UUID)
-    resource_save watcher audit_id $audit_id
-}
-
-function create_audit_with_autotrigger {
-    audit_at_id=$(openstack optimize audit create -s dummy -g dummy -f value -c UUID --auto-trigger)
-    resource_save watcher audit_at_id $audit_at_id
-}
-
-function verify_audit_template {
-    local at_id=$(resource_get watcher at_id)
-    openstack optimize audittemplate show $at_id
-}
-
-function verify_audit_with_autotrigger {
-    local audit_at_id=$(resource_get watcher audit_at_id)
-    _wait_for_status "SUCCEEDED" openstack optimize audit show $audit_at_id
-    local actionplan_at_id=$(openstack optimize actionplan list --audit $audit_at_id -c UUID -f value)
-    resource_save watcher actionplan_at $actionplan_at_id
-    actionplan_at_state=$(openstack optimize actionplan show $actionplan_at_id -c State -f value)
-    if [ $actionplan_at_state != "SUCCEEDED" ]; then
-        die $LINENO "ERROR executing actionplan"
-    fi
-}
-
-function verify_audit {
-    local audit_id=$(resource_get watcher audit_id)
-    _wait_for_status "SUCCEEDED" openstack optimize audit show $audit_id
-    local actionplan_id=$(openstack optimize actionplan list --audit $audit_id -c UUID -f value)
-    resource_save watcher actionplan $actionplan_id
-    actionplan_state=$(openstack optimize actionplan show $actionplan_id -c State -f value)
-    if [ $actionplan_state != "RECOMMENDED" ]; then
-        die $LINENO "ERROR creating actionplan"
-    fi
-}
-
-function verify_noapi {
-    # currently no good way
-    :
-}
-
-function delete_audit {
-  local audit_id=$(resource_get watcher audit_id)
-  local actionplan_id=$(resource_get watcher actionplan)
-  watcher actionplan delete $actionplan_id
-  openstack optimize audit delete $audit_id
-}
-
-function delete_audit_with_autotrigger {
-  local audit_at_id=$(resource_get watcher audit_at_id)
-  local actionplan_id=$(resource_get watcher actionplan_at)
-  watcher actionplan delete $actionplan_id
-  openstack optimize audit delete $audit_at_id
-}
-
-function delete_audit_template {
-  local at_id=$(resource_get watcher at_id)
-  openstack optimize audittemplate delete $at_id
-}
-
-function create {
-  create_audit_template
-  create_audit
-  create_audit_with_autotrigger
-}
-
-function verify {
-  verify_audit_template
-  verify_audit
-  verify_audit_with_autotrigger
-}
-
-function destroy {
-  delete_audit_template
-  delete_audit
-  delete_audit_with_autotrigger
-}
-
-# Dispatcher
-case $1 in
-    "create")
-        create
-        ;;
-    "verify_noapi")
-        verify_noapi
-        ;;
-    "verify")
-        verify
-        ;;
-    "destroy")
-        destroy
-        ;;
-    "force_destroy")
-        set +o errexit
-        destroy
-        ;;
-esac
--- a/devstack/upgrade/settings
+++ b/devstack/upgrade/settings
@@ -1,11 +0,0 @@
-register_project_for_upgrade watcher
-register_db_to_save watcher
-
-devstack_localrc base enable_plugin watcher https://git.openstack.org/openstack/watcher stable/rocky
-devstack_localrc target enable_plugin watcher https://git.openstack.org/openstack/watcher
-
-devstack_localrc base enable_service watcher-api watcher-decision-engine watcher-applier
-devstack_localrc target enable_service watcher-api watcher-decision-engine watcher-applier
-
-BASE_RUN_SMOKE=False
-TARGET_RUN_SMOKE=False
--- a/devstack/upgrade/shutdown.sh
+++ b/devstack/upgrade/shutdown.sh
@@ -1,24 +0,0 @@
-#!/bin/bash
-
-set -o errexit
-
-source $GRENADE_DIR/grenaderc
-source $GRENADE_DIR/functions
-
-# We need base DevStack functions for this
-source $BASE_DEVSTACK_DIR/functions
-source $BASE_DEVSTACK_DIR/stackrc # needed for status directory
-source $BASE_DEVSTACK_DIR/lib/tls
-source $BASE_DEVSTACK_DIR/lib/apache
-
-WATCHER_DEVSTACK_DIR=$(dirname $(dirname $0))
-source $WATCHER_DEVSTACK_DIR/settings
-source $WATCHER_DEVSTACK_DIR/plugin.sh
-source $WATCHER_DEVSTACK_DIR/lib/watcher
-
-set -o xtrace
-
-stop_watcher
-
-# sanity check that service is actually down
-ensure_services_stopped watcher-api watcher-decision-engine watcher-applier
--- a/devstack/upgrade/upgrade.sh
+++ b/devstack/upgrade/upgrade.sh
@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-
-# ``upgrade-watcher``
-
-echo "*********************************************************************"
-echo "Begin $0"
-echo "*********************************************************************"
-
-# Clean up any resources that may be in use
-cleanup() {
-    set +o errexit
-
-    echo "********************************************************************"
-    echo "ERROR: Abort $0"
-    echo "********************************************************************"
-
-    # Kill ourselves to signal any calling process
-    trap 2; kill -2 $$
-}
-
-trap cleanup SIGHUP SIGINT SIGTERM
-
-# Keep track of the grenade directory
-RUN_DIR=$(cd $(dirname "$0") && pwd)
-
-# Source params
-source $GRENADE_DIR/grenaderc
-
-# Import common functions
-source $GRENADE_DIR/functions
-
-# This script exits on an error so that errors don't compound and you see
-# only the first error that occurred.
-set -o errexit
-
-# Upgrade watcher
-# ============
-
-# Get functions from current DevStack
-source $TARGET_DEVSTACK_DIR/stackrc
-source $TARGET_DEVSTACK_DIR/lib/apache
-source $TARGET_DEVSTACK_DIR/lib/tls
-source $(dirname $(dirname $BASH_SOURCE))/settings
-source $(dirname $(dirname $BASH_SOURCE))/plugin.sh
-
-# Print the commands being run so that we can see the command that triggers
-# an error.  It is also useful for following allowing as the install occurs.
-set -o xtrace
-
-# Save current config files for posterity
-[[ -d $SAVE_DIR/etc.watcher ]] || cp -pr $WATCHER_CONF_DIR $SAVE_DIR/etc.watcher
-
-# Install the target watcher
-install_watcher
-
-# calls upgrade-watcher for specific release
-upgrade_project watcher $RUN_DIR $BASE_DEVSTACK_BRANCH $TARGET_DEVSTACK_BRANCH
-
-# Migrate the database
-watcher-db-manage upgrade || die $LINO "DB migration error"
-
-start_watcher
-
-# Don't succeed unless the services come up
-ensure_services_started watcher-api watcher-decision-engine watcher-applier
-
-set +o xtrace
-echo "*********************************************************************"
-echo "SUCCESS: End $0"
-echo "*********************************************************************"
--- a/doc/ext/versioned_notifications.py
+++ b/doc/ext/versioned_notifications.py
@@ -20,7 +20,7 @@ It is used via a single directive in the .rst file

 """

-from docutils.parsers.rst import Directive
+from sphinx.util.compat import Directive
 from docutils import nodes

 from watcher.notifications import base as notification
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -1,10 +0,0 @@
-# The order of packages is significant, because pip processes them in the order
-# of appearance. Changing the order has an impact on the overall integration
-# process, which may cause wedges in the gate later.
-openstackdocstheme>=1.20.0 # Apache-2.0
-sphinx>=1.6.5,!=1.6.6,!=1.6.7,<2.0.0;python_version=='2.7' # BSD
-sphinx>=1.6.5,!=1.6.6,!=1.6.7;python_version>='3.4' # BSD
-sphinxcontrib-pecanwsme>=0.8.0 # Apache-2.0
-reno>=2.7.0 # Apache-2.0
-sphinxcontrib-apidoc>=0.2.0  # BSD
-os-api-ref>=1.4.0 # Apache-2.0
--- a/doc/source/admin/apache-mod-wsgi.rst
+++ b/doc/source/admin/apache-mod-wsgi.rst
@@ -44,6 +44,6 @@ Installing API behind mod_wsgi
    Fedora/RHEL7/CentOS7:
      sudo systemctl reload httpd

-    Debian/Ubuntu:
-      sudo a2ensite watcher
-      sudo service apache2 reload
+   Debian/Ubuntu:
+    sudo a2ensite watcher
+    sudo service apache2 reload
--- a/doc/source/admin/policy.rst
+++ b/doc/source/admin/policy.rst
@@ -131,16 +131,6 @@ The actions that may have a rule enforced on them are:
  * ``GET /v1/actions/<ACTION_UUID>``


-* ``service:get_all``, ``service:detail`` - List available Watcher services
-
-  * ``GET /v1/services``
-  * ``GET /v1/services/detail``
-
-* ``service:get`` - Retrieve a specific Watcher service entity
-
-  * ``GET /v1/services/<SERVICE_ID>``
-
-

 To limit an action to a particular role or roles, you list the roles like so ::

--- a/doc/source/admin/ways-to-install.rst
+++ b/doc/source/admin/ways-to-install.rst
@@ -19,7 +19,7 @@ The source install instructions specifically avoid using platform specific
 packages, instead using the source for the code and the Python Package Index
 (PyPi_).

-.. _PyPi: https://pypi.org/
+.. _PyPi: https://pypi.python.org/pypi

 It's expected that your system already has python2.7_, latest version of pip_,
 and git_ available.
@@ -30,7 +30,7 @@ and git_ available.

 Your system shall also have some additional system libraries:

-  On Ubuntu (tested on 16.04LTS):
+  On Ubuntu (tested on 14.04LTS):

  .. code-block:: bash

--- a/doc/source/api/index.rst
+++ b/doc/source/api/index.rst
@@ -0,0 +1,8 @@
+==================================================
+OpenStack Infrastructure Optimization Service APIs
+==================================================
+
+.. toctree::
+   :maxdepth: 1
+
+   v1
--- a/doc/source/api/v1.rst
+++ b/doc/source/api/v1.rst
@@ -0,0 +1,100 @@
+..
+      Except where otherwise noted, this document is licensed under Creative
+      Commons Attribution 3.0 License.  You can view the license at:
+
+          https://creativecommons.org/licenses/by/3.0/
+
+====================
+RESTful Web API (v1)
+====================
+
+Goals
+=====
+
+.. rest-controller:: watcher.api.controllers.v1.goal:GoalsController
+   :webprefix: /v1/goal
+
+.. autotype:: watcher.api.controllers.v1.goal.GoalCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.goal.Goal
+   :members:
+
+Strategies
+==========
+
+.. rest-controller:: watcher.api.controllers.v1.strategy:StrategiesController
+   :webprefix: /v1/strategies
+
+.. autotype:: watcher.api.controllers.v1.strategy.StrategyCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.strategy.Strategy
+   :members:
+
+Audit Templates
+===============
+
+.. rest-controller:: watcher.api.controllers.v1.audit_template:AuditTemplatesController
+   :webprefix: /v1/audit_templates
+
+.. autotype:: watcher.api.controllers.v1.audit_template.AuditTemplateCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.audit_template.AuditTemplate
+   :members:
+
+Audits
+======
+
+.. rest-controller:: watcher.api.controllers.v1.audit:AuditsController
+   :webprefix: /v1/audits
+
+.. autotype:: watcher.api.controllers.v1.audit.AuditCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.audit.Audit
+   :members:
+
+Links
+=====
+
+.. autotype:: watcher.api.controllers.link.Link
+   :members:
+
+Action Plans
+============
+
+.. rest-controller:: watcher.api.controllers.v1.action_plan:ActionPlansController
+   :webprefix: /v1/action_plans
+
+.. autotype:: watcher.api.controllers.v1.action_plan.ActionPlanCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.action_plan.ActionPlan
+   :members:
+
+
+Actions
+=======
+
+.. rest-controller:: watcher.api.controllers.v1.action:ActionsController
+   :webprefix: /v1/actions
+
+.. autotype:: watcher.api.controllers.v1.action.ActionCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.action.Action
+   :members:
+
+Scoring Engine
+==============
+
+.. rest-controller:: watcher.api.controllers.v1.scoring_engine:ScoringEngineController
+   :webprefix: /v1/scoring_engine
+
+.. autotype:: watcher.api.controllers.v1.scoring_engine.ScoringEngineCollection
+   :members:
+
+.. autotype:: watcher.api.controllers.v1.scoring_engine.ScoringEngine
+   :members:
--- a/doc/source/architecture.rst
+++ b/doc/source/architecture.rst
@@ -76,7 +76,6 @@ Watcher Applier
 This component is in charge of executing the
 :ref:`Action Plan <action_plan_definition>` built by the
 :ref:`Watcher Decision Engine <watcher_decision_engine_definition>`.
-Taskflow is the default workflow engine for Watcher.

 It connects to the :ref:`message bus <amqp_bus_definition>` and launches the
 :ref:`Action Plan <action_plan_definition>` whenever a triggering message is
@@ -111,23 +110,6 @@ If the :ref:`Action <action_definition>` fails, the
 previous state of the :ref:`Managed resource <managed_resource_definition>`
 (i.e. before the command was sent to the underlying OpenStack service).

-In Stein, added a new config option 'action_execution_rule' which is a
-dict type. Its key field is strategy name and the value is 'ALWAYS' or 'ANY'.
-'ALWAYS' means the callback function returns True as usual.
-'ANY' means the return depends on the result of previous action execution.
-The callback returns True if previous action gets failed, and the engine
-continues to run the next action. If previous action executes success,
-the callback returns False then the next action will be ignored.
-For strategies that aren't in 'action_execution_rule', the callback always
-returns True.
-Please add the next section in the watcher.conf file
-if your strategy needs this feature.
-
-::
-
-    [watcher_workflow_engines.taskflow]
-    action_execution_rule = {'your strategy name': 'ANY'}
-
 .. _archi_watcher_cli_definition:

 Watcher CLI
@@ -479,4 +461,4 @@ change to a new value:



-.. _Watcher API: https://developer.openstack.org/api-ref/resource-optimization/
+.. _Watcher API: webapi/v1.html
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -32,7 +32,7 @@ sys.path.insert(0, os.path.abspath('./'))
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
    'oslo_config.sphinxext',
-    'sphinxcontrib.apidoc',
+    'sphinx.ext.autodoc',
    'sphinx.ext.viewcode',
    'sphinxcontrib.httpdomain',
    'sphinxcontrib.pecanwsme.rest',
@@ -42,7 +42,6 @@ extensions = [
    'ext.versioned_notifications',
    'oslo_config.sphinxconfiggen',
    'openstackdocstheme',
-    'sphinx.ext.napoleon',
 ]

 wsme_protocols = ['restjson']
@@ -55,18 +54,6 @@ sample_config_basename = 'watcher'
 # text edit cycles.
 # execute "export SPHINX_DEBUG=1" in your terminal to disable

-# sphinxcontrib.apidoc options
-apidoc_module_dir = '../../watcher'
-apidoc_output_dir = 'api'
-apidoc_excluded_paths = [
-    'tests/*',
-    'db',
-    'decision_engine',
-    'doc',
-    'objects',
-]
-apidoc_separate_modules = True
-
 # The suffix of source filenames.
 source_suffix = '.rst'

--- a/doc/source/configuration/configuring.rst
+++ b/doc/source/configuration/configuring.rst
@@ -19,17 +19,11 @@ optimize your IaaS platform. The Watcher service may, depending upon
 configuration, interact with several other OpenStack services. This includes:

 - the OpenStack Identity service (`keystone`_) for request authentication and
-  to locate other OpenStack services.
- the OpenStack Telemetry service (`ceilometer`_) for collecting the resources
-  metrics.
- the time series database (`gnocchi`_) for consuming the resources
-  metrics.
+  to locate other OpenStack services
+- the OpenStack Telemetry service (`ceilometer`_) for consuming the resources
+  metrics
 - the OpenStack Compute service (`nova`_) works with the Watcher service and
  acts as a user-facing API for instance migration.
- the OpenStack Bare Metal service (`ironic`_) works with the Watcher service
-  and allows to manage power state of nodes.
- the OpenStack Block Storage service (`cinder`_) works with the Watcher
-  service and as an API for volume node migration.

 The Watcher service includes the following components:

@@ -59,9 +53,6 @@ additional functionality:
 .. _`keystone`: https://github.com/openstack/keystone
 .. _`ceilometer`: https://github.com/openstack/ceilometer
 .. _`nova`: https://github.com/openstack/nova
-.. _`gnocchi`: https://github.com/gnocchixyz/gnocchi
-.. _`ironic`: https://github.com/openstack/ironic
-.. _`cinder`: https://github.com/openstack/cinder
 .. _`python-watcherclient`: https://github.com/openstack/python-watcherclient
 .. _`watcher-dashboard`: https://github.com/openstack/watcher-dashboard
 .. _`watcher metering`: https://github.com/b-com/watcher-metering
@@ -138,14 +129,10 @@ Configure the Identity service for the Watcher service

    .. code-block:: bash

-      $ openstack endpoint create --region YOUR_REGION
-        watcher public http://WATCHER_API_PUBLIC_IP:9322
-
-      $ openstack endpoint create --region YOUR_REGION
-        watcher internal http://WATCHER_API_INTERNAL_IP:9322
-
-      $ openstack endpoint create --region YOUR_REGION
-        watcher admin http://WATCHER_API_ADMIN_IP:9322
+      $ openstack endpoint create --region YOUR_REGION watcher \
+        --publicurl http://WATCHER_API_PUBLIC_IP:9322 \
+        --internalurl http://WATCHER_API_INTERNAL_IP:9322 \
+        --adminurl http://WATCHER_API_ADMIN_IP:9322

 .. _watcher-db_configuration:

@@ -159,7 +146,7 @@ MySQL database that is used by other OpenStack services.
   ``watcher`` user. Replace WATCHER_DBPASSWORD
   with the actual password::

-    # mysql
+    $ mysql -u root -p

    mysql> CREATE DATABASE watcher CHARACTER SET utf8;
    mysql> GRANT ALL PRIVILEGES ON watcher.* TO 'watcher'@'localhost' \
@@ -230,7 +217,7 @@ so that the watcher service is configured for your needs.
    # The SQLAlchemy connection string used to connect to the
    # database (string value)
    #connection=<None>
-    connection = mysql+pymysql://watcher:WATCHER_DBPASSWORD@DB_IP/watcher?charset=utf8
+    connection = mysql://watcher:WATCHER_DBPASSWORD@DB_IP/watcher?charset=utf8

 #. Configure the Watcher Service to use the RabbitMQ message broker by
   setting one or more of these options. Replace RABBIT_HOST with the
@@ -239,13 +226,30 @@ so that the watcher service is configured for your needs.

    [DEFAULT]

+    # The messaging driver to use, defaults to rabbit. Other drivers
+    # include qpid and zmq. (string value)
+    #rpc_backend = rabbit
+
    # The default exchange under which topics are scoped. May be
    # overridden by an exchange name specified in the transport_url
    # option. (string value)
    control_exchange = watcher

-    # ...
-    transport_url = rabbit://RABBITMQ_USER:RABBITMQ_PASSWORD@RABBIT_HOST
+    ...
+
+    [oslo_messaging_rabbit]
+
+    # The username used by the message broker (string value)
+    rabbit_userid = RABBITMQ_USER
+
+    # The password of user used by the message broker (string value)
+    rabbit_password = RABBITMQ_PASSWORD
+
+    # The host where the message brokeris installed (string value)
+    rabbit_host = RABBIT_HOST
+
+    # The port used bythe message broker (string value)
+    #rabbit_port = 5672


 #. Watcher API shall validate the token provided by every incoming request,
@@ -269,7 +273,7 @@ so that the watcher service is configured for your needs.

        # Authentication URL (unknown value)
        #auth_url = <None>
-        auth_url = http://IDENTITY_IP:5000
+        auth_url = http://IDENTITY_IP:35357

        # Username (unknown value)
        # Deprecated group/name - [DEFAULT]/username
@@ -315,7 +319,7 @@ so that the watcher service is configured for your needs.

        # Authentication URL (unknown value)
        #auth_url = <None>
-        auth_url = http://IDENTITY_IP:5000
+        auth_url = http://IDENTITY_IP:35357

        # Username (unknown value)
        # Deprecated group/name - [DEFAULT]/username
@@ -345,7 +349,7 @@ so that the watcher service is configured for your needs.
    [nova_client]

    # Version of Nova API to use in novaclient. (string value)
-    #api_version = 2.56
+    #api_version = 2.53
    api_version = 2.1

 #. Create the Watcher Service database tables::
@@ -403,22 +407,26 @@ Watcher can consume notifications generated by the Nova services, in order to
 build or update, in real time, its cluster data model related to computing
 resources.

-Nova emits unversioned(legacy) and versioned notifications on different
-topics. Because legacy notifications will be deprecated, Watcher consumes
-Nova versioned notifications.
+Nova publishes, by default, notifications on ``notifications`` AMQP queue
+(configurable) and ``versioned_notifications`` AMQP queue (not
+configurable). ``notifications`` queue is mainly used by ceilometer, so we can
+not use it. And some events, related to nova-compute service state, are only
+sent into the ``versioned_notifications`` queue.

-  * In the file ``/etc/nova/nova.conf``, the value of driver in the section
-    ``[oslo_messaging_notifications]`` can't be noop, and the value of
-    notification_format in the section ``[notifications]``
-    should be both or versioned ::
+By default, Watcher listens to AMQP queues named ``watcher_notifications``
+and ``versioned_notifications``. So you have to update the Nova
+configuration file on controller and compute nodes, in order
+to Watcher receives Nova notifications in ``watcher_notifications`` as well.
+
+  * In the file ``/etc/nova/nova.conf``, update the section
+    ``[oslo_messaging_notifications]``, by redefining the list of topics
+    into which Nova services will publish events ::

      [oslo_messaging_notifications]
      driver = messagingv2
+      topics = notifications,watcher_notifications

-      ...
-
-      [notifications]
-      notification_format = both
+  * Restart the Nova services.


 Configure Cinder Notifications
--- a/doc/source/configuration/index.rst
+++ b/doc/source/configuration/index.rst
@@ -1,9 +1,5 @@
-===================
-Configuration Guide
-===================
-
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1

   configuring
   watcher
--- a/doc/source/contributor/api_microversion_history.rst
+++ b/doc/source/contributor/api_microversion_history.rst
@@ -1 +0,0 @@
-.. include:: ../../../watcher/api/controllers/rest_api_version_history.rst
--- a/doc/source/contributor/contributing.rst
+++ b/doc/source/contributor/contributing.rst
@@ -39,7 +39,7 @@ notifications of important events.

   * https://launchpad.net
   * https://launchpad.net/watcher
-   * https://launchpad.net/openstack
+   * https://launchpad.net/~openstack


 Project Hosting Details
@@ -49,7 +49,7 @@ Bug tracker
    https://launchpad.net/watcher

 Mailing list (prefix subjects with ``[watcher]`` for faster responses)
-    http://lists.openstack.org/pipermail/openstack-discuss/
+    https://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

 Wiki
    https://wiki.openstack.org/Watcher
@@ -65,7 +65,7 @@ IRC Channel

 Weekly Meetings
    On Wednesdays at 14:00 UTC on even weeks in the ``#openstack-meeting-4``
-    IRC channel, 08:00 UTC on odd weeks in the ``#openstack-meeting-alt``
+    IRC channel, 13:00 UTC on odd weeks in the ``#openstack-meeting-alt``
    IRC channel (`meetings logs`_)

 .. _changelog: http://eavesdrop.openstack.org/irclogs/%23openstack-watcher/
--- a/doc/source/contributor/environment.rst
+++ b/doc/source/contributor/environment.rst
@@ -37,7 +37,7 @@ different version of the above, please document your configuration here!

 .. _Python: https://www.python.org/
 .. _git: https://git-scm.com/
-.. _setuptools: https://pypi.org/project/setuptools
+.. _setuptools: https://pypi.python.org/pypi/setuptools
 .. _virtualenvwrapper: https://virtualenvwrapper.readthedocs.io/en/latest/install.html

 Getting the latest code
@@ -69,8 +69,8 @@ itself.

 These dependencies can be installed from PyPi_ using the Python tool pip_.

-.. _PyPi: https://pypi.org/
-.. _pip: https://pypi.org/project/pip
+.. _PyPi: https://pypi.python.org/
+.. _pip: https://pypi.python.org/pypi/pip

 However, your system *may* need additional dependencies that `pip` (and by
 extension, PyPi) cannot satisfy. These dependencies should be installed
@@ -123,10 +123,9 @@ You can re-activate this virtualenv for your current shell using:

    $ workon watcher

-For more information on virtual environments, see virtualenv_ and
-virtualenvwrapper_.
+For more information on virtual environments, see virtualenv_.

-.. _virtualenv: https://pypi.org/project/virtualenv/
+.. _virtualenv: https://www.virtualenv.org/



@@ -193,8 +192,6 @@ still need to configure the following sections:
  :ref:`Identity service <identity-service_configuration>` i.e. Keystone
 - The ``[watcher_messaging]`` section to configure the OpenStack AMQP-based
  message bus
- The ``watcher_clients_auth`` section to configure Keystone client to access
-  related OpenStack projects

 So if you need some more details on how to configure one or more of these
 sections, please do have a look at :doc:`../configuration/configuring` before
--- a/doc/source/contributor/plugin/base-setup.rst
+++ b/doc/source/contributor/plugin/base-setup.rst
@@ -79,7 +79,7 @@ requirements.txt file::

 .. _cookiecutter: https://github.com/audreyr/cookiecutter
 .. _OpenStack cookiecutter: https://github.com/openstack-dev/cookiecutter
-.. _python-watcher: https://pypi.org/project/python-watcher
+.. _python-watcher: https://pypi.python.org/pypi/python-watcher

 Implementing a plugin for Watcher
 =================================
--- a/doc/source/contributor/plugin/cdmc-plugin.rst
+++ b/doc/source/contributor/plugin/cdmc-plugin.rst
@@ -208,7 +208,7 @@ Here below is how to register ``DummyClusterDataModelCollector`` using pbr_:
    watcher_cluster_data_model_collectors =
        dummy = thirdparty.dummy:DummyClusterDataModelCollector

-.. _pbr: https://docs.openstack.org/pbr/latest/
+.. _pbr: http://docs.openstack.org/pbr/latest


 Add new notification endpoints
--- a/doc/source/contributor/plugin/strategy-plugin.rst
+++ b/doc/source/contributor/plugin/strategy-plugin.rst
@@ -245,16 +245,15 @@ Querying metrics

 A large set of metrics, generated by OpenStack modules, can be used in your
 strategy implementation. To collect these metrics, Watcher provides a
-`DataSourceManager`_ for two data sources which are `Ceilometer`_
-(with `Gnocchi`_ as API) and `Monasca`_. If you wish to query metrics from a
-different data source, you can implement your own and use it via
-DataSourceManager from within your new strategy. Indeed, strategies in Watcher
-have the cluster data models decoupled from the data sources which means that
-you may keep the former while changing the latter. The recommended way for you
-to support a new data source is to implement a new helper that would
-encapsulate within separate methods the queries you need to perform. To then
-use it, you would just have to add it to appropriate watcher_strategies.*
-section in config file.
+`Helper`_ for two data sources which are `Ceilometer`_ and `Monasca`_. If you
+wish to query metrics from a different data source, you can implement your own
+and directly use it from within your new strategy. Indeed, strategies in
+Watcher have the cluster data models decoupled from the data sources which
+means that you may keep the former while changing the latter.
+The recommended way for you to support a new data source is to implement a new
+helper that would encapsulate within separate methods the queries you need to
+perform. To then use it, you would just have to instantiate it within your
+strategy.

 If you want to use Ceilometer but with your own metrics database backend,
 please refer to the `Ceilometer developer guide`_. The list of the available
@@ -264,38 +263,52 @@ requires new metrics not covered by Ceilometer, you can add them through a
 `Ceilometer plugin`_.


-.. _`DataSourceManager`: https://github.com/openstack/watcher/blob/master/watcher/datasource/manager.py
+.. _`Helper`: https://github.com/openstack/watcher/blob/master/watcher/datasource/ceilometer.py
 .. _`Ceilometer developer guide`: https://docs.openstack.org/ceilometer/latest/contributor/architecture.html#storing-accessing-the-data
 .. _`Ceilometer`: https://docs.openstack.org/ceilometer/latest
 .. _`Monasca`: https://github.com/openstack/monasca-api/blob/master/docs/monasca-api-spec.md
 .. _`here`: https://docs.openstack.org/ceilometer/latest/contributor/install/dbreco.html#choosing-a-database-backend
 .. _`Ceilometer plugin`: https://docs.openstack.org/ceilometer/latest/contributor/plugins.html
 .. _`Ceilosca`: https://github.com/openstack/monasca-ceilometer/blob/master/ceilosca/ceilometer/storage/impl_monasca.py
-.. _`Gnocchi`: https://gnocchi.xyz/

 Read usage metrics using the Watcher Datasource Helper
 ------------------------------------------------------

-The following code snippet shows how datasource_backend is defined:
+The following code snippet shows how to invoke a Datasource Helper class:

 .. code-block:: py

-    from watcher.datasource import manager as ds_manager
+    from watcher.datasource import ceilometer as ceil
+    from watcher.datasource import monasca as mon

    @property
-    def datasource_backend(self):
-        if not self._datasource_backend:
-            self._datasource_backend = ds_manager.DataSourceManager(
-                config=self.config,
-                osc=self.osc
-            ).get_backend(self.DATASOURCE_METRICS)
-        return self._datasource_backend
+    def ceilometer(self):
+        if self._ceilometer is None:
+            self._ceilometer = ceil.CeilometerHelper(osc=self.osc)
+        return self._ceilometer
+
+    @property
+    def monasca(self):
+        if self._monasca is None:
+            self._monasca = mon.MonascaHelper(osc=self.osc)
+        return self._monasca

 Using that you can now query the values for that specific metric:

 .. code-block:: py

-    avg_meter = self.datasource_backend.statistic_aggregation(
-        instance.uuid, 'cpu_util', self.periods['instance'],
-        self.granularity,
-        aggregation=self.aggregation_method['instance'])
+        if self.config.datasource == "ceilometer":
+            resource_id = "%s_%s" % (node.uuid, node.hostname)
+            return self.ceilometer.statistic_aggregation(
+                resource_id=resource_id,
+                meter_name='compute.node.cpu.percent',
+                period="7200",
+                aggregate='avg',
+            )
+        elif self.config.datasource == "monasca":
+            statistics = self.monasca.statistic_aggregation(
+                meter_name='compute.node.cpu.percent',
+                dimensions=dict(hostname=node.uuid),
+                period=7200,
+                aggregate='avg'
+            )
--- a/doc/source/contributor/testing.rst
+++ b/doc/source/contributor/testing.rst
@@ -13,32 +13,39 @@ Testing
 Unit tests
 ==========

-All unit tests should be run using `tox`_. Before running the unit tests, you
-should download the latest `watcher`_ from the github. To run the same unit
-tests that are executing onto `Gerrit`_ which includes ``py35``, ``py27`` and
-``pep8``, you can issue the following command::
+All unit tests should be run using `tox`_. To run the same unit tests that are
+executing onto `Gerrit`_ which includes ``py35``, ``py27`` and ``pep8``, you
+can issue the following command::

-    $ git clone https://git.openstack.org/openstack/watcher
-    $ cd watcher
-    $ pip install tox
-    $ tox
+    $ workon watcher
+    (watcher) $ pip install tox
+    (watcher) $ cd watcher
+    (watcher) $ tox

-If you only want to run one of the aforementioned, you can then issue one of
+If you want to only run one of the aforementioned, you can then issue one of
 the following::

-    $ tox -e py35
-    $ tox -e py27
-    $ tox -e pep8
+    $ workon watcher
+    (watcher) $ tox -e py35
+    (watcher) $ tox -e py27
+    (watcher) $ tox -e pep8

 .. _tox: https://tox.readthedocs.org/
-.. _watcher: https://git.openstack.org/cgit/openstack/watcher
-.. _Gerrit: https://review.openstack.org/
+.. _Gerrit: http://review.openstack.org/

-If you only want to run specific unit test code and don't like to waste time
-waiting for all unit tests to execute, you can add parameters ``--`` followed
-by a regex string::
+You may pass options to the test programs using positional arguments. To run a
+specific unit test, you can pass extra options to `os-testr`_ after putting
+the ``--`` separator. So using the ``-r`` option followed by a regex string,
+you can run the desired test::

-    $ tox -e py27 -- watcher.tests.api
+    $ workon watcher
+    (watcher) $ tox -e py27 -- -r watcher.tests.api
+
+.. _os-testr: https://docs.openstack.org/os-testr/latest
+
+When you're done, deactivate the virtualenv::
+
+    $ deactivate

 .. _tempest_tests:

@@ -48,4 +55,4 @@ Tempest tests
 Tempest tests for Watcher has been migrated to the external repo
 `watcher-tempest-plugin`_.

-.. _watcher-tempest-plugin: https://git.openstack.org/cgit/openstack/watcher-tempest-plugin
+.. _watcher-tempest-plugin: https://github.com/openstack/watcher-tempest-plugin
--- a/doc/source/glossary.rst
+++ b/doc/source/glossary.rst
@@ -274,7 +274,7 @@ In OpenStack Identity, a :ref:`project <project_definition>` must be owned by a
 specific domain.

 Please, read `the official OpenStack definition of a Project
-<https://docs.openstack.org/doc-contrib-guide/common/glossary.html>`_.
+<http://docs.openstack.org/glossary/content/glossary.html>`_.

 .. _scoring_engine_definition:

--- a/doc/source/image_src/plantuml/audit_state_machine.txt
+++ b/doc/source/image_src/plantuml/audit_state_machine.txt
@@ -2,7 +2,7 @@

 [*] --> PENDING: Audit requested by Administrator
 PENDING --> ONGOING: Audit request is received\nby the Watcher Decision Engine
-ONGOING --> FAILED: Audit fails\n(Exception occurred)
+ONGOING --> FAILED: Audit fails\n(no solution found, technical error, ...)
 ONGOING --> SUCCEEDED: The Watcher Decision Engine\ncould find at least one Solution
 ONGOING --> SUSPENDED: Administrator wants to\nsuspend the Audit
 SUSPENDED --> ONGOING: Administrator wants to\nresume the Audit
--- a/doc/source/images/audit_state_machine.png
+++ b/doc/source/images/audit_state_machine.png
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -15,7 +15,7 @@ metrics receiver, complex event processor and profiler, optimization processor
 and an action plan applier. This provides a robust framework to realize a wide
 range of cloud optimization goals, including the reduction of data center
 operating costs, increased system performance via intelligent virtual machine
-migration, increased energy efficiency and more!
+migration, increased energy efficiency—and more!

 Watcher project consists of several source code repositories:

@@ -54,6 +54,22 @@ Getting Started

  contributor/index

+API References
+--------------
+
+.. toctree::
+  :maxdepth: 1
+
+  api/index
+
+Plugins
+-------
+
+.. toctree::
+  :maxdepth: 1
+
+  contributor/plugin/index
+
 Installation
 ============
 .. toctree::
@@ -61,6 +77,14 @@ Installation

  install/index

+Watcher Configuration Options
+=============================
+
+.. toctree::
+  :maxdepth: 2
+
+  configuration/index
+
 Admin Guide
 ===========

@@ -77,31 +101,6 @@ User Guide

  user/index

-API References
-==============
-
-.. toctree::
-  :maxdepth: 1
-
-  API Reference <https://developer.openstack.org/api-ref/resource-optimization/>
-  Watcher API Microversion History </contributor/api_microversion_history>
-
-Plugins
-------
-
-.. toctree::
-  :maxdepth: 1
-
-  contributor/plugin/index
-
-Watcher Configuration Options
-=============================
-
-.. toctree::
-  :maxdepth: 2
-
-  configuration/index
-
 Watcher Manual Pages
 ====================

@@ -118,7 +117,7 @@ Watcher Manual Pages
 .. toctree::
   :hidden:

-   api/modules
+   api/autoindex


 Indices and tables
--- a/doc/source/install/common_configure.rst
+++ b/doc/source/install/common_configure.rst
@@ -27,7 +27,7 @@
        [keystone_authtoken]
        ...
        www_authenticate_uri = http://controller:5000
-        auth_url = http://controller:5000
+        auth_url = http://controller:35357
        memcached_servers = controller:11211
        auth_type = password
        project_domain_name = default
@@ -47,7 +47,7 @@
        [watcher_clients_auth]
        ...
        auth_type = password
-        auth_url = http://controller:5000
+        auth_url = http://controller:35357
        username = watcher
        password = WATCHER_PASS
        project_domain_name = default
--- a/doc/source/install/common_prerequisites.rst
+++ b/doc/source/install/common_prerequisites.rst
@@ -11,7 +11,7 @@ you must create a database, service credentials, and API endpoints.

     .. code-block:: console

-        # mysql
+        $ mysql -u root -p

   * Create the ``watcher`` database:

--- a/doc/source/install/index.rst
+++ b/doc/source/install/index.rst
@@ -28,10 +28,10 @@ optimization algorithms, data metrics and data profilers can be
 developed and inserted into the Watcher framework.

 Check the documentation for watcher optimization strategies at
-`Strategies <https://docs.openstack.org/watcher/latest/strategies/index.html>`_.
+https://docs.openstack.org/watcher/latest/strategies/index.html

-Check watcher glossary at `Glossary
-<https://docs.openstack.org/watcher/latest/glossary.html>`_.
+Check watcher glossary at
+https://docs.openstack.org/watcher/latest/glossary.html


 This chapter assumes a working setup of OpenStack following the
--- a/doc/source/install/install-ubuntu.rst
+++ b/doc/source/install/install-ubuntu.rst
@@ -4,7 +4,7 @@ Install and configure for Ubuntu
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 This section describes how to install and configure the Infrastructure
-Optimization service for Ubuntu 16.04 (LTS).
+Optimization service for Ubuntu 14.04 (LTS).

 .. include:: common_prerequisites.rst

@@ -25,15 +25,10 @@ Install and configure components
 Finalize installation
 ---------------------

-Start the Infrastructure Optimization services and configure them to start when
-the system boots:
+Restart the Infrastructure Optimization services:

 .. code-block:: console

-   # systemctl enable watcher-api.service \
-     watcher-decision-engine.service \
-     watcher-applier.service
-
-   # systemctl start watcher-api.service \
-     watcher-decision-engine.service \
-     watcher-applier.service
+   # service watcher-api restart
+   # service watcher-decision-engine restart
+   # service watcher-applier restart
--- a/doc/source/man/index.rst
+++ b/doc/source/man/index.rst
@@ -5,5 +5,4 @@
   watcher-api
   watcher-applier
   watcher-db-manage
-   watcher-decision-engine
-   watcher-status
+   watcher-decision-engine
--- a/doc/source/man/watcher-api.rst
+++ b/doc/source/man/watcher-api.rst
@@ -7,7 +7,9 @@ Service for the Watcher API
 ---------------------------

 :Author: openstack@lists.launchpad.net
+:Date:
 :Copyright: OpenStack Foundation
+:Version:
 :Manual section: 1
 :Manual group: cloud computing

--- a/doc/source/man/watcher-applier.rst
+++ b/doc/source/man/watcher-applier.rst
@@ -7,7 +7,9 @@ Service for the Watcher Applier
 -------------------------------

 :Author: openstack@lists.launchpad.net
+:Date:
 :Copyright: OpenStack Foundation
+:Version:
 :Manual section: 1
 :Manual group: cloud computing

--- a/doc/source/man/watcher-db-manage.rst
+++ b/doc/source/man/watcher-db-manage.rst
@@ -241,9 +241,10 @@ purge
  The maximum number of database objects we expect to be deleted. If exceeded,
  this will prevent any deletion.

-.. option:: -t, --goal
+.. option:: -t, --audit-template

-  Either the UUID or name of the goal to purge.
+  Either the UUID or name of the soft deleted audit template to purge. This
+  will also include any related objects with it.

 .. option:: -e, --exclude-orphans

--- a/doc/source/man/watcher-decision-engine.rst
+++ b/doc/source/man/watcher-decision-engine.rst
@@ -7,7 +7,9 @@ Service for the Watcher Decision Engine
 ---------------------------------------

 :Author: openstack@lists.launchpad.net
+:Date:
 :Copyright: OpenStack Foundation
+:Version:
 :Manual section: 1
 :Manual group: cloud computing

--- a/doc/source/man/watcher-status.rst
+++ b/doc/source/man/watcher-status.rst
@@ -1,83 +0,0 @@
-==============
-watcher-status
-==============
-
-----------------------------------------
-CLI interface for Watcher status commands
-----------------------------------------
-
-Synopsis
-========
-
-::
-
-  watcher-status <category> <command> [<args>]
-
-Description
-===========
-
-:program:`watcher-status` is a tool that provides routines for checking the
-status of a Watcher deployment.
-
-Options
-=======
-
-The standard pattern for executing a :program:`watcher-status` command is::
-
-    watcher-status <category> <command> [<args>]
-
-Run without arguments to see a list of available command categories::
-
-    watcher-status
-
-Categories are:
-
-* ``upgrade``
-
-Detailed descriptions are below:
-
-You can also run with a category argument such as ``upgrade`` to see a list of
-all commands in that category::
-
-    watcher-status upgrade
-
-These sections describe the available categories and arguments for
-:program:`Watcher-status`.
-
-Upgrade
-~~~~~~~
-
-.. _watcher-status-checks:
-
-``watcher-status upgrade check``
-  Performs a release-specific readiness check before restarting services with
-  new code. For example, missing or changed configuration options,
-  incompatible object states, or other conditions that could lead to
-  failures while upgrading.
-
-  **Return Codes**
-
-  .. list-table::
-     :widths: 20 80
-     :header-rows: 1
-
-     * - Return code
-       - Description
-     * - 0
-       - All upgrade readiness checks passed successfully and there is nothing
-         to do.
-     * - 1
-       - At least one check encountered an issue and requires further
-         investigation. This is considered a warning but the upgrade may be OK.
-     * - 2
-       - There was an upgrade status check failure that needs to be
-         investigated. This should be considered something that stops an
-         upgrade.
-     * - 255
-       - An unexpected error occurred.
-
-  **History of Checks**
-
-  **1.12.0 (Stein)**
-
-  * Sample check to be filled in with checks as they are added in Stein.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
OpenDev Sysadmins	5307f5a80e	OpenDev Migration Patch This commit was bulk generated and pushed by the OpenDev sysadmins as a part of the Git hosting and code review systems migration detailed in these mailing list posts: http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html Attempts have been made to correct repository namespaces and hostnames based on simple pattern matching, but it's possible some were updated incorrectly or missed entirely. Please reach out to us via the contact information listed at https://opendev.org/ with any questions you may have.	2019-04-19 19:40:46 +00:00
Ian Wienand	b5467a2a1f	Replace openstack.org git:// URLs with https:// This is a mechanically generated change to replace openstack.org git:// URLs with https:// equivalents. This is in aid of a planned future move of the git hosting infrastructure to a self-hosted instance of gitea (https://gitea.io), which does not support the git wire protocol at this stage. This update should result in no functional change. For more information see the thread at http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003825.html Change-Id: I886b29ba8a1814cf876e70b5b20504a221d32fa1	2019-03-24 20:36:26 +00:00
Alexander Chadin	83411ec89f	Fix stop_watcher function Apache should be reloaded after watcher-api is disabled. Change-Id: Ifee0e7701849348630568aa36b3f3c4c62d3382e	2018-12-10 13:55:44 +00:00
licanwei	08750536e7	optimize get_instances_by_node We can set host filed in search_opts. refer to: https://developer.openstack.org/api-ref/compute/?expanded=list-servers-detail#list-servers Change-Id: I36b27167d7223f3bf6bb05995210af41ad01fc6d	2018-11-06 13:39:14 +00:00
Tatiana Kholkina	9f7ccfe408	Use limit -1 for nova servers list By default nova has a limit for returned items in a single response [1]. We should pass limit=-1 to get all items. [1] https://docs.openstack.org/nova/rocky/configuration/config.html Change-Id: I1fabd909c4c0356ef5fcb7c51718fb4513e6befa	2018-10-16 08:37:45 +00:00
Tatiana Kholkina	fb2619e538	Provide region name while initialize clients Add new option 'region_name' to config for each client section. Change-Id: Ifad8908852f4be69dd294a4c4ab28d2e1df265e8 Closes-Bug: #1787937 (cherry picked from commit `925b971377`)	2018-09-21 12:31:04 +00:00
Nguyen Hai	6bd857fa0e	import zuul job settings from project-config This is a mechanically generated patch to complete step 1 of moving the zuul job settings out of project-config and into each project repository. Because there will be a separate patch on each branch, the branch specifiers for branch-specific jobs have been removed. Because this patch is generated by a script, there may be some cosmetic changes to the layout of the YAML file(s) as the contents are normalized. See the python3-first goal document for details: https://governance.openstack.org/tc/goals/stein/python3-first.html Change-Id: I35a8ce3dc54cb662ee9154e343cf50fe96f64807 Story: #2002586 Task: #24344	2018-08-19 00:59:08 +09:00
Clark Boylan	e0faeea608	Remove undefined job The legacy-rally-dsvm-watcher-rally job does not exist but it is listed in the .zuul.yaml config. This is a zuul configuration error. Remove this job which does not exist to fix zuul. Change-Id: I1bbfd373ad12b98696ab2ddb78e56e6503cc4c4d	2018-07-03 13:27:12 -07:00
Zuul	61aca40e6e	Merge "Update auth_uri option to www_authenticate_uri" into stable/queens	2018-06-05 07:49:22 +00:00
caoyuan	b293389734	Delete the unnecessary '-' fix a typo Change-Id: I4ecdb827d94ef0ae88e2f37db9d1a53525140947 (cherry picked from commit `4844baa816`)	2018-05-16 05:03:45 +00:00
caoyuan	050e6d58f1	Update auth_uri option to www_authenticate_uri Option auth_uri from group keystone_authtoken is deprecated in Queens [1]. Use option www_authenticate_uri from group keystone_authtoken. [1]https://review.openstack.org/#/c/508522/ Change-Id: I2ef330d7f9b632e9a81d22a8edec3c88eb532ff5 (cherry picked from commit `8c916930c8`)	2018-05-15 07:57:53 +00:00
Zuul	7223d35c47	Merge "Imported Translations from Zanata" into stable/queens	2018-03-06 05:30:53 +00:00
Zuul	57f1971982	Merge "Add a hacking rule for string interpolation at logging" into stable/queens	2018-03-06 02:42:13 +00:00
OpenStack Proposal Bot	c9b2b2aa39	Imported Translations from Zanata For more information about this automatic import see: https://docs.openstack.org/i18n/latest/reviewing-translation-import.html Change-Id: Ia00d11dd76a27a5c052c7a512cadaefa168d0340	2018-03-03 07:22:16 +00:00
Andreas Jaeger	a42c31c221	Fix exception string format The string %(action) is not valid, it misses the conversion specified, add s for string. Note that this leads to an untranslatable string, since our translation tools check for valid formats and fail. In this case the failure comes from a source code fail. Change-Id: I2e630928dc32542a8a7c02657a9f0ab1eaab62ff	2018-03-02 20:57:41 +00:00
ForestLee	403ec94bc1	Add a hacking rule for string interpolation at logging String interpolation should be delayed to be handled by the logging code, rather than being done at the point of the logging call. See the oslo i18n guideline * https://docs.openstack.org/oslo.i18n/latest/user/guidelines.html#adding-variables-to-log-messages and * https://github.com/openstack-dev/hacking/blob/master/hacking/checks/other.py#L39 Closes-Bug: #1596829 Change-Id: Ibba5791669c137be1483805db657beb907030227	2018-02-28 12:13:10 +00:00
OpenStack Release Bot	3431b77388	Update UPPER_CONSTRAINTS_FILE for stable/queens The new stable upper-constraints file is only available after the openstack/requirements repository is branched. This will happen around the RC1 timeframe. Recheck and merge this change once the requirements repository has been branched. The CI system will work with this patch before the requirements repository is branched because zuul configues the job to run with a local copy of the file and defaults to the master branch. However, accepting the patch will break the test configuration on developers' local systems, so please wait until after the requirements repository is branched to merge the patch. Change-Id: I8ec196a62e7c0146f25045e643073f414ae69249	2018-02-08 16:34:03 +00:00
OpenStack Release Bot	eb4cacc00e	Update .gitreview for stable/queens Change-Id: I4ac0da37285c34471654bb5125c034b415c6031d	2018-02-08 16:33:58 +00:00
				`@@ -1 +0,0 @@`
				`.. include:: ../../../watcher/api/controllers/rest_api_version_history.rst`