[openstack-dev] [nova] How to connect to a serial port of an instance via websocket?

Sahid Orentino Ferdjaoui sahid.ferdjaoui at redhat.com
Wed Oct 29 09:42:52 UTC 2014


On Tue, Oct 28, 2014 at 03:09:44PM +0100, Markus Zoeller wrote:
> The API provides an endpoint for querying the serial console of an 
> instance ('os-getSerialConsole'). The nova-client interacts with this
> API endpoint via the command `get-serial-console`.
> 
>     nova get-serial-console myInstance
>  
> It returns a string like:
> 
>     ws://127.0.0.1:6083/?token=e2b42240-375d-41fe-a166-367e4bbdce35
>  
> Q: How is one supposed to connect to such a websocket?

The aim of the feature is exposing an interactive web-based serial
consoles through a websocket proxy. The API returns an URL with a
valid token that should be used with a websocket client to read/write
on the stream.

Considering the service nova-serialproxy is running and well
configured you can use this simple test purpose client to connect
yourself on the URL returned by the API:

  https://gist.github.com/sahid/894c31f306bebacb2207

The general idea behind this service is for example to help debugging
VMs when something was wrong with the network configuration.

s.

> [1] 
> https://github.com/openstack/nova/blob/master/nova/api/openstack/compute/contrib/consoles.py#L111
> [2] 
> https://ask.openstack.org/en/question/50671/how-to-connect-to-a-serial-port-of-an-instance-via-websocket/
> 
> Regards,
> Markus Zoeller
> IRC: markus_z
> 
> 
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



More information about the OpenStack-dev mailing list