Changes between Version 6 and Version 7 of UsingBenito

Timestamp:

Jul 29, 2011 2:55:52 PM (13 years ago)

Author:

mikeryan

Comment:

node status

UsingBenito

@@ -137 +137 @@
  * {{{start_command.err}}}: stderr
 
+== Node Status ==
+
+There is a line-based RPC mechanism for query node status. A web interface for this is in active development.
+
+Commands are in the format: {{{command arg1 [arg2 ...]}}}
+
+Replies are in the format: {{{reply_type python-eval'able-string}}}
+
+As an example, here is a status request and reply (reply line-wrapped for readability):
+
+{{{
+status_request DeterTest/ratsnest-medium    
+status_reply {'hv:qemu:pnode-0000': {'cnode17': [None, None], 'cnode20': [None,
+None], 'cnode8': [None, None]}, 'hv:qemu:pnode-0010': {'lnode6': [None, None],
+'lnode7': [None, None]}, 'hv:qemu:pnode-0005': {'lnode11': [None, None],
+'lnode12': [None, None], 'lnode13': [None, None]}, 'hv:qemu:pnode-0004':
+{'lnode4': [None, None], 'lnode1': [None, None]}, 'hv:qemu:pnode-0007':
+{'cnode16': [None, None], 'cnode15': [None, None], 'cnode19': [None, None]},
+'hv:qemu:pnode-0008': {'cnode14': [None, None], 'cnode9': [None, None],
+'cnode18': [None, None]}}
+}}}
+
+Example Python code for parsing the reply:
+
+{{{
+from ast import literal_eval
+type, body = line.split(' ', 1)
+message = literal_eval(body)
+}}}
+
+=== Reply format ===
+
+Reply bodies take the form of a dict of dicts. The key of the first level of dicts is the hypervisor name. The key of the second level is node name. Each node name is a two-item array. The first element is boot status and the second element is start command exit code or qemu process exit code (if dead). Both of these will be None if the hv is unreachable.
+
+Possible boot status:
+
+ * {{{running}}} - qemu has been started but the OS has not booted
+ * {{{booted}}} - the inner OS has fully booted
+ * {{{dead}}} - qemu process has died
+
+=== Caveat ===
+
+'''Note:''' Node status is only available for qemu virtual nodes. If your experiment is mixed mode, there is no status available for pnodes. The only way to query their status is from DETER. If they've booted and their exit code is 0, then they are running.
+
 == What's Missing ==
 
 The following is a list of missing features that will probably cause you some pain and suffering. Actually implementing these features is my highest priority task at the moment, so please bear with me for the time being.
 
- * Node status, beyond existence
  * Ability to choose a different OS than Ubuntu 10.10 (Maverick)
  * Ability to install software using apt on Ubuntu (and any other OS)