Merge "Spec for Hyper-V serial console log"

specs/juno/hyper-v-console-log.rst

@@ -0,0 +1,127 @@
+..
+ This work is licensed under a Creative Commons Attribution 3.0 Unported
+ License.
+
+ http://creativecommons.org/licenses/by/3.0/legalcode
+
+==========================================
+Hyper-V serial console log
+==========================================
+
+https://blueprints.launchpad.net/nova/+spec/hyper-v-console-log
+
+This blueprint introduces serial console log in the Nova Hyper-V driver.
+
+Problem description
+===================
+
+The Hyper-V driver is currently not providing a serial console log unlike
+other compute drivers (e.g. libvirt). This feature is particularly useful
+for the troubleshooting of both Linux and Windows instances.
+
+Proposed change
+===============
+
+Console log support in the Hyper-V nova driver will be obtained by implementing
+the "get_console_output" method inherited from nova.virt.driver.ComputeDriver.
+
+Hyper-V supports virtual serial ports in the guests, which can be redirected
+to a dedicated named pipe on the host.
+
+The driver will setup and connect the pipe upon starting or resuming a VM and
+closing it when stopping, suspending or live migrating.
+
+Data read from the pipe will be written in a file placed in the instance
+directory, capped to a maximum size.
+
+In case of live migration the console file must be moved to the destination
+server.
+
+A call to "get_console_output" for a given instance will return the content of
+the file.
+
+Alternatives
+------------
+
+None
+
+Data model impact
+-----------------
+
+None
+
+REST API impact
+---------------
+
+None
+
+Security impact
+---------------
+
+None
+
+Notifications impact
+--------------------
+
+None
+
+Other end user impact
+---------------------
+
+None
+
+Performance Impact
+------------------
+
+None
+
+Other deployer impact
+---------------------
+
+None
+
+Developer impact
+----------------
+
+None
+
+
+Implementation
+==============
+
+Assignee(s)
+-----------
+
+Primary assignee:
+  petrutlucian94
+
+Other contributors:
+  alexpilotti
+
+Work Items
+----------
+
+* Hyper-V Nova driver feature implementation
+* Unit tests
+
+Dependencies
+============
+
+None
+
+Testing
+=======
+
+* Unit tests
+* Additional Tempest tests can be evaluated
+
+Documentation Impact
+====================
+
+None
+
+References
+==========
+
+* Initial discussion (Juno design summit):
+  https://etherpad.openstack.org/p/nova-hyperv-juno