diff --git a/doc/source/admin/configuration/hypervisor-xen-api.rst b/doc/source/admin/configuration/hypervisor-xen-api.rst index 082a37bcbcbe..d18a7b705d64 100644 --- a/doc/source/admin/configuration/hypervisor-xen-api.rst +++ b/doc/source/admin/configuration/hypervisor-xen-api.rst @@ -4,6 +4,14 @@ XenServer (and other XAPI based Xen variants) ============================================= +.. deprecated:: 20.0.0 + + The xenapi driver is deprecated and may be removed in a future release. + The driver is not tested by the OpenStack project nor does it have clear + maintainer(s) and thus its quality can not be ensured. If you are using + the driver in production please let us know in freenode IRC and/or the + openstack-discuss mailing list. + .. todo:: os-xenapi version is 0.3.1 currently. diff --git a/nova/conf/xenserver.py b/nova/conf/xenserver.py index 00dc6eca411d..56e7e93b9cef 100644 --- a/nova/conf/xenserver.py +++ b/nova/conf/xenserver.py @@ -21,6 +21,12 @@ from oslo_utils import units xenserver_group = cfg.OptGroup('xenserver', title='Xenserver Options', help=""" +.. warning:: The xenapi driver is deprecated and may be removed in a future + release. The driver is not tested by the OpenStack project nor + does it have clear maintainer(s) and thus its quality can not be + ensured. If you are using the driver in production please let us + know in freenode IRC and/or the openstack-discuss mailing list. + XenServer options are used when the compute_driver is set to use XenServer (compute_driver=xenapi.XenAPIDriver). diff --git a/nova/virt/xenapi/driver.py b/nova/virt/xenapi/driver.py index 6be6671a7dc1..ef3eb810f535 100644 --- a/nova/virt/xenapi/driver.py +++ b/nova/virt/xenapi/driver.py @@ -112,11 +112,12 @@ class XenAPIDriver(driver.ComputeDriver): return self._host_state def init_host(self, host): - # TODO(mriedem): Consider deprecating the driver if there is still no - # working 3rd party CI by the end of the Train release. - LOG.warning('The xenapi driver is not tested by the OpenStack ' - 'project and thus its quality can not be ensured. The ' - 'driver may be deprecated in the future.') + LOG.warning('The xenapi driver is deprecated and may be removed in a ' + 'future release. The driver is not tested by the ' + 'OpenStack project nor does it have clear maintainer(s) ' + 'and thus its quality can not be ensured. If you are ' + 'using the driver in production please let us know in ' + 'freenode IRC and/or the openstack-discuss mailing list.') if CONF.xenserver.independent_compute: # Check various options are in the correct state: diff --git a/releasenotes/notes/deprecate-xen-driver-train-bd57a16fa51ab679.yaml b/releasenotes/notes/deprecate-xen-driver-train-bd57a16fa51ab679.yaml new file mode 100644 index 000000000000..b5a5681e4c73 --- /dev/null +++ b/releasenotes/notes/deprecate-xen-driver-train-bd57a16fa51ab679.yaml @@ -0,0 +1,8 @@ +--- +deprecations: + - | + The xenapi driver is deprecated and may be removed in a future release. + The driver is not tested by the OpenStack project nor does it have clear + maintainer(s) and thus its quality can not be ensured. If you are using + the driver in production please let us know in freenode IRC and/or the + openstack-discuss mailing list.