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