Changes between Version 125 and Version 126 of GAPI_AM_API_DRAFT


Ignore:
Timestamp:
04/08/14 12:57:11 (10 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_DRAFT

    v125 v126  
    8080`GetVersion` should return an additional field indicate the URN of the Aggregate Manager at this endpoint. This corresponds to the URN in the `SubjectAltName` of the certificate of the aggregate, or the URN that the aggregate uses if reporting slivers to the Federation SA API (and this URN also determines the authority portion of the URN for any slivers issued by this aggregate). For aggregates that have a single component manager, then this is likely the `component_manager` or `component_manager_id` from the advertisement RSpec produced by this aggregate (which in turn determines the authority portion of related `component_id` URNs). Aggregates which have multiple component managers must select a single AM URN, which may be the same as one of the component manager URNs.
    8181
    82 '''Proposal''': `GetVersion` adds the field `geni_am_urn` whose value is an XMLRPC string containing the URN of the aggregate manager running at this XMLRPC endpoint. This field is requires as of AM API version 4, optional earlier.
     82'''Proposal''': `GetVersion` adds the field `geni_am_urn` whose value is an XMLRPC string containing the URN of the aggregate manager running at this XMLRPC endpoint. This field is required as of AM API version 4, optional earlier.
    8383
    8484== Change Set T: Long Lived Slices ==
     
    391391At GEC19, the GENI GPO and ProtoGENI clearinghouses agreed to follow the above proposal.
    392392
     393== Change Set AC: Aggregate Description in `GetVersion` ==
     394
     395At Fed4Fire, aggregates provide some additional information in `GetVersion`, useful for tools. This includes a pretty name, description, logo, URL, and tools that are known to work well or be specially supported by the aggregate. Provide this in `GetVersion` so it is available without the privileged `ListResources` call. This information would be used by tools to provide more and prettier information to experimenters about aggregates.
     396
     397Fed4Fire uses:
     398{{{
     399"f4f_testbed_homepage" -> "http://www.wilab2.ilabt.iminds.be",
     400"f4f_testbed_picture" -> "https://fed4fire-testbeds.ilabt.iminds.be/wilab2_overview.jpg",
     401"f4f_describe_testbed" -> "The Wilab2 testbed is a heterogeneous wireless testbed that consists of 60 wireless nodes, equipped with IEEE 802.11a/b/g/n, IEEE802.15.4 and IEEE802.15.1 (Bluetooth) interfaces. Every node is also equipped with a custom environment emulator board, enabling unique features of the testbed including the triggering of repeatable digital or analog I/O events at the sensor nodes, real-time monitoring of the power consumption, and battery capacity emulation. The nodes are installed in an unmanned utility room (size: 66m x 22.5m) which is characterised by a minimum of external radio interference. Next to these 60 fixed nodes, the Wilab2 testbed also offers an additional 20 similar setups which are deployed on mobile robots. And finally, the testbed also hosts software defined radio platforms (USRP, WARP) and spectrum scanning engines developed by imec.",
     402"f4f_endorsed_tools" -> [
     403       {
     404          "tool_homepage" -> "http://mytestbed.net",
     405          "tool_logo" -> "http://mytestbed.net/omf-images/omf-logo.png",
     406          "tool_version" -> "5.4 - 6.0",
     407          "tool_name" -> "OMF"
     408          },
     409       {
     410          "tool_homepage" -> "http://oml.mytestbed.net",
     411          "tool_logo" -> "http://oml.mytestbed.net/attachments/download/797/oml.png",
     412          "tool_version" -> 2.1,
     413          "tool_name" -> "OML"
     414          }
     415       ],
     416}}}
     417
     418'''Proposal''':
     419`GetVersion` adds the following optional but recommended fields:
     420 - `geni_am_homepage`: A URL providing human readable content describing the aggregate and its resources.
     421 - `geni_am_logo`: An image usable by tools to represent the aggregate.
     422 - `geni_am_pretty_name`: A pretty name for the aggregate (better than something extracted from a URN or URL hopefully)
     423 - `geni_am_description`: A plain text description of the aggregate, its resources, and any usage restrictions.
     424
     425
    393426== Older Proposals ==
    394427Older proposals, withdrawn, superseded, or postponed: