Changes between Version 8 and Version 9 of GeniGet


Ignore:
Timestamp:
11/13/13 16:01:20 (6 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GeniGet

    v8 v9  
    22
    33A command that runs on (from inside) a GENI node and tells you GENI meta-information about the slivers and slices and experimenter associated with the node. This is a separate tool that must be installed in your disk image. All GENI compute resource providers should make available a version of this client script that can be installed on their compute resources such that the below functionality works.
     4
     5Within this specification, `client` refers to any software or configuration installed on the compute resource (node). `server` refers to any software or configuration required to support these functions that is not installed within each compute resource, if any.
    46
    57= PG implementation =
     
    1517
    1618The client script shall support the options as described below.
     19
     20Required options that all scripts must actively support:
     21 - `--all`
     22 - `--help`
     23 - `--client-version`
     24 - `--version`
     25
     26Options that may be no-ops for some client implementations but must be valid options:
     27 - `--no-cache`
     28 - `--port`
     29
    1730Notes
    18  - 'client version' refers to the version of the geni-get script.
    19  - 'no-cache' means the script should re-query the server for the latest information
    20  - 'version' refers to the version of the server side of this system
    21 
     31 - `client version` refers to the version of the geni-get script.
     32 - `no-cache` means the script should re-query the server for the latest information. Note that this option may have no effect for some implementations.
     33 - `version` refers to the version of the server side of this `geni-get` implementation (if any)
     34 - `port` may not be relevant for all implementations, but should always be allowed (for consistency)
     35
     36Sample help output, showing options that must be allowed by the client-side script:
    2237{{{
    2338$ geni-get --help
     
    4055
    4156== commands ==
    42 Return a list of all commands that you can issue at this server - kinds of information you can get. The return is a JSON list. Each of the commands listed below should be supported, but additional commands are allowed.
     57Return a list of all commands that you can issue in this implementation - kinds of information you can get. The return is a JSON list. Each of the commands listed below should be supported, but additional commands are allowed.
    4358
    4459Example:
     
    208223
    209224== --version ==
    210 Return the server side of this software's code version.
     225Return the version of the server side of this implementation. If there is no server side, return an empty string.
    211226
    212227'''FIXME: A string? An int? Float?'''
     
    252267 - non zero exit code on unknown command
    253268 - document --status command for APIv3 status (similar to but not identical to sliverstatus)
    254  - document --commands for JSON list of commands the server understands
     269 - document --commands for JSON list of commands this implementation understands
    255270 - update example of sliverstatus output
    256271 - note known issue that slice email for GPO SA slices is incorrect at PG