Files
nova-specs/specs/juno/hyper-v-console-log.rst
Alessandro Pilotti 048ee2db33 Spec for Hyper-V serial console log
This blueprint proposes the introduction of Hyper-V serial console log
support in the Nova Hyper-V compute driver

bp hyper-v-console-log

Change-Id: I20bff09f6d833d0d16dbfd4ccba30922525c9075
2014-07-02 21:43:42 +03:00

2.2 KiB

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