Changes between Version 8 and Version 9 of GeniGet
- Timestamp:
- 11/13/13 16:01:20 (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GeniGet
v8 v9 2 2 3 3 A 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 5 Within 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. 4 6 5 7 = PG implementation = … … 15 17 16 18 The client script shall support the options as described below. 19 20 Required options that all scripts must actively support: 21 - `--all` 22 - `--help` 23 - `--client-version` 24 - `--version` 25 26 Options that may be no-ops for some client implementations but must be valid options: 27 - `--no-cache` 28 - `--port` 29 17 30 Notes 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 36 Sample help output, showing options that must be allowed by the client-side script: 22 37 {{{ 23 38 $ geni-get --help … … 40 55 41 56 == 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.57 Return 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. 43 58 44 59 Example: … … 208 223 209 224 == --version == 210 Return the server side of this software's code version.225 Return the version of the server side of this implementation. If there is no server side, return an empty string. 211 226 212 227 '''FIXME: A string? An int? Float?''' … … 252 267 - non zero exit code on unknown command 253 268 - document --status command for APIv3 status (similar to but not identical to sliverstatus) 254 - document --commands for JSON list of commands th e serverunderstands269 - document --commands for JSON list of commands this implementation understands 255 270 - update example of sliverstatus output 256 271 - note known issue that slice email for GPO SA slices is incorrect at PG