Merge "Deprecate the nova-console service"

2018-12-05 13:05:06 +00:00
parent 3a8dd02c81 f18ae13e36
commit e26ac8f24a
5 changed files with 20 additions and 3 deletions
@@ -46,7 +46,6 @@ daemonize correctly after starting up.
   nova-api
   nova-compute
   nova-conductor
-   nova-console
   nova-novncproxy
   nova-scheduler
   nova-serialproxy
@@ -91,3 +90,4 @@ deployments, but are documented for existing ones.
   nova-dhcpbridge
   nova-network
   nova-consoleauth
+   nova-console
@@ -25,6 +25,11 @@ Description
 service, which is a console proxy to set up multi-tenant VM console access,
 e.g. with *XVP*.

+.. deprecated:: 19.0.0
+
+   :program:`nova-console` is deprecated since 19.0.0 (Stein) and will be
+   removed in an upcoming release.
+
 Options
 =======

@@ -276,8 +276,8 @@ Install and configure components
   .. code-block:: console

      # yum install openstack-nova-api openstack-nova-conductor \
-        openstack-nova-console openstack-nova-novncproxy \
-        openstack-nova-scheduler openstack-nova-placement-api
+        openstack-nova-novncproxy openstack-nova-scheduler \
+        openstack-nova-placement-api

 #. Edit the ``/etc/nova/nova.conf`` file and complete the following actions:

@@ -29,6 +29,7 @@ from nova import service
 from nova import version

 CONF = cfg.CONF
+LOG = logging.getLogger('nova.console')


 def main():
@@ -39,6 +40,11 @@ def main():

    gmr.TextGuruMeditation.setup_autorun(version, conf=CONF)

+    LOG.warning('The nova-console service is deprecated as it is Xen '
+                'specific, does not function properly in a multi-cell '
+                'environment, and has effectively been replaced by noVNC '
+                'and the nova-novncproxy service.')
+
    server = service.Service.create(binary='nova-console',
                                    topic=console_rpcapi.RPC_TOPIC)
    service.serve(server)
@@ -0,0 +1,6 @@
+---
+deprecations:
+  - |
+    The ``nova-console`` service is deprecated as it is Xen specific, does not
+    function properly in a multi-cell environment, and has effectively been
+    replaced by noVNC and the ``nova-novncproxy`` service.