Changes between Version 52 and Version 53 of GENIExperimenter/RSpecs
- Timestamp:
- 05/15/12 13:09:14 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GENIExperimenter/RSpecs
v52 v53 17 17 This is the document returned by an AM that describes the resources that a user has reserved at an AM. 18 18 19 = RSpec Versions=19 == RSpec Versions == 20 20 In addition to the three types of RSpecs, there are also different versions of RSpecs. The current version is [wiki:RSpecSchema3 GENI v3]. Depending on which tool you use to reserve resources you should be able to get a list of supported RSpecs from each AM through the [wiki:GAPI_AM_API_V2#GetVersion GetVersion] API call. 21 == GENI v3==21 ==== GENI v3 ==== 22 22 The current GENI v3 RSpec schemas are based on the ProtoGENI v2 RSpecs. You can find some documentation and RSpec examples [http://www.protogeni.net/trac/protogeni/wiki/RSpec on the ProtoGENI website]. There you will also find a [http://www.protogeni.net/trac/protogeni/wiki/RSpecTutorial tutorial on RSpecs]. Although the examples are for ProtoGENI v2 RSpecs, it is easy to [wiki:HowTo/Convertv2tov3RSpecs convert them] to GENI v3. 23 23 24 === OpenFlow v3 Extension===24 ===== OpenFlow v3 Extension ===== 25 25 For OpenFlow resources there is an extension to the GENI v3 schema. More details about the schema can be found [wiki:HowTo/WriteOFv3Rspecs/Spec here], and 26 26 [wiki:HowTo/WriteOFv3Rspecs these are instructions about how to write] one from scratch. 27 27 28 == SFA RSpec==28 ==== SFA RSpec ==== 29 29 The SFA RSpec is the native RSpec format the PlanetLab AMs use. As of January 2012 PlanetLab supports GENI v3 RSpecs that is the recommended RSpec for use in GENI. 30 30 31 == ProtoGENI v2 (deprecated)==31 ==== ProtoGENI v2 (deprecated) ==== 32 32 ProtoGENI v2 RSpec is the version that ProtoGENI AMs used to describe resources. The GENI community decided to adopt this version, and created the GENI v3 RSpecs based on this. It is easy to [wiki:HowTo/Convertv2tov3RSpecs convert RSpecs] from ProtoGENI v2 to GENI v3. 33 33 34 = Writing RSpecs=34 == Writing RSpecs == 35 35 You will only probably ever need to write Request RSpecs. The best way to write RSpecs is either to '''use a tool''' like [http://protogeni.net/flack Flack], or to '''modify an existing example''', or to '''modify an advertisement RSpec'''. 36 36 … … 39 39 There are also instructions about [wiki:HowTo/Convertv2tov3RSpecs converting] ProtoGENI v2 to GENI v3 RSpecs. 40 40 41 == Debugging RSpecs==41 === Debugging RSpecs === 42 42 If you write your own RSpecs, it is recommended that you use [https://www.protogeni.net/trac/protogeni/wiki/RSpecDebugging rspeclint] to verify the validity of the document. `rspeclint.py` is a script written in python 43 43 that will check the validity of an xml document against its schema.