nova/nova/api/openstack
root 76fdd667f2 This branch adds web based serial console access. Here is an overview of how it works (for libvirt):
1. User requests an ajax console for an instance_id (either through OS api, or tools/euca-get-ajax-console)
  a. api server calls compute worker to complete request
  b. compute worker parses an instance's xml to locate its pseudo terminal (/dev/pts/x)
  c. compute worker spawns an ajaxterm daemon, bound to a random port in a specified range.  socat is used to connect to /dev/pts/x.  Note that ajaxterm was modified in the following ways:
    i. dies after 5 minutes of inactivity
    ii. now requires token authentication.  Previously it was trivial to hijack an ajaxterm
  d. compute worker returns ajaxterm connect information to the api server: port, host, token
  e. api server casts connect information to the nova-ajax-console-proxy (a new service)
  f. api server returns a url for the ajaxterm (eg. http://nova-ajax-console-proxy/?token=123)
2. User now has a url, and can paste it in a browser
  a. Browser sends request to https://nova-ajax-console-proxy/?token=123
  b. nova-ajax-console-proxy maps token to connect information
  c. nova-ajax-console-proxy constructs a proxy to the ajaxterm that is running on the host machine.  This is now done with eventlet, though previously it was done using twisted
3. User interacts with console through web browser


NOTE: For this to work as expected, serial console login must be enabled in the instance.  Instructions for how to do this on ubuntu can be found here: https://help.ubuntu.com/community/SerialConsoleHowto.  Note that you must actively log out of the serial console when you are finished, otherwise the console will remain open even after the ajaxterm term session has ended.

Also note that nova.sh has been modified in this branch to launch nova-ajax-console-proxy.
2011-01-12 09:24:57 +00:00
..
ratelimiting Merge trunk. 2010-12-29 15:20:44 -05:00
__init__.py Changed shared_ip_group detail routing 2011-01-11 02:47:35 -04:00
_id_translator.py merge lp:nova 2010-10-24 17:41:53 -07:00
auth.py Uses paste.deploy to make application running configurable. This includes the ability to swap out middlewares, define new endpoints, and generally move away from having code to build wsgi routers and middleware chains into a configurable, extensible method for running wsgi servers. 2011-01-03 19:54:39 +00:00
backup_schedules.py First pass at feature parity. Includes Image ID hash 2011-01-03 15:46:55 -08:00
common.py pep8 2011-01-05 03:51:21 -04:00
consoles.py change API classname to match the way other API's are done. 2011-01-07 19:04:22 -06:00
faults.py Rename cloudServersFault (rackspace branding) to computeFault. Fixes bug lp680285. 2010-11-22 17:59:49 -05:00
flavors.py Moved implementation specific stuff from the middleware into their respective modules 2010-12-16 12:09:38 -06:00
images.py Fixed trunk merge conflicts as spotted by dubs. 2011-01-05 22:23:23 -04:00
notes.txt Mass renaming 2010-10-08 20:39:00 +00:00
servers.py merge trunk, fix conflict 2011-01-11 17:32:12 -08:00
shared_ip_groups.py Changed shared_ip_group detail routing 2011-01-11 03:38:40 -04:00