devstack/doc/source/guides/nova.rst
Tony Breeds a339efcd67 Create service definition for nova-serialproxy
Nova has the ability to do remote interactive consoles but there is no
easy way to enable this in devstack.  This change defines a service
called n-serial to enable the service.  Documentation is added to a
new guide on nova, describing how to set further options in local.conf

Change-Id: I401d94b2413c62bfae9b90d2214d77bd4cfc15d5
2015-02-24 18:36:36 +11:00

2.1 KiB

Nova and devstack

This is a rough guide to various configuration parameters for nova running with devstack.

nova-serialproxy

In Juno nova implemented a spec to allow read/write access to the serial console of an instance via nova-serialproxy.

The service can be enabled by adding n-sproxy to ENABLED_SERVICES. Further options can be enabled via local.conf, e.g.

[[post-config|$NOVA_CONF]]
[serial_console]
#
# Options defined in nova.cmd.serialproxy
#

# Host on which to listen for incoming requests (string value)
#serialproxy_host=0.0.0.0

# Port on which to listen for incoming requests (integer
# value)
#serialproxy_port=6083


#
# Options defined in nova.console.serial
#

# Enable serial console related features (boolean value)
#enabled=false
# Do not set this manually.  Instead enable the service as
# outlined above.

# Range of TCP ports to use for serial ports on compute hosts
# (string value)
#port_range=10000:20000

# Location of serial console proxy. (string value)
#base_url=ws://127.0.0.1:6083/

# IP address on which instance serial console should listen
# (string value)
#listen=127.0.0.1

# The address to which proxy clients (like nova-serialproxy)
# should connect (string value)
#proxyclient_address=127.0.0.1

Enabling the service is enough to be functional for a single machine devstack.

These config options are defined in nova.console.serial and nova.cmd.serialproxy.

For more information on OpenStack configuration see the OpenStack Configuration Reference