| 393 | == Change Set AC: Aggregate Description in `GetVersion` == |
| 394 | |
| 395 | At 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 | |
| 397 | Fed4Fire 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 | |