Changes between Initial Version and Version 1 of orca-xmlrpc-controller

Show
Ignore:
Timestamp:
05/10/11 11:37:15 (8 years ago)
Author:
ibaldin (IP: 152.54.9.21)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • orca-xmlrpc-controller

    v1 v1  
     1= ORCA XMLRPC Controller with GENI and ProtoGENI AM API = 
     2 
     3== Overview == 
     4 
     5ORCA standard binary package [wiki:deploy-sm configured and deployed] with a Service Manager actor presents GENI AM API and ProtoGENI AM API. Once the ORCA container is up and Service Manager Actor is operational, you can start the XMLRPC controller plugin and then manipulate ORCA using those two interfaces. 
     6 
     7== Running controller plugins == 
     8 
     9Login to ORCA portal of the container you just deployed (typically http://hostname:11080/orca), go to the 'User' tab, then click on 'Start Controller'. Select 'XMLRPC Controller' from the menu and click 'Create'. 
     10 
     11== Using GENI AM API controller plugin == 
     12 
     13This plugin exports a GENI AM API-compliant XMLRPC API that can be exercised using Python scripts shipped with ORCA source distribution.  
     14 
     15 1. Open a terminal and navigate to the directory, $ORCA_HOME/controllers/xmlrpc/resources/scripts, which has simple python client scripts that invoke methods to list resources, create slivers, check sliver status, delete slivers etc.  
     16 1. To list the available resources, run the following command. This should output the available resources in the form of abstract NDL description of the Eucalyptus substrate. 
     17{{{ 
     18$ python ListResources.py -s http://hostname:11080/orca/xmlrpc  
     19}}} 
     20 1. To create a sliver, run the 'createSliver' script. The script needs the name of the file containing resource request in NDL. A number of examples are available under [source:orca/network/trunk/src/main/resources/orca/network]. The response to the script will look approximately as shown (UUIDs and Reservation IDs will be different. 
     21{{{ 
     22$ python createSliver.py -s http://hostname:11080/orca/xmlrpc -k ~/.ssh/id_dsa.pub -i some-slice-name-no-spaces -r /path/to/request/file/in/NDL 
     23... 
     24[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: 5063cd58-75cf-4c58-8824-cf86d329b9d9 | Resource Type: unc.vm | Resource Units: 1 ]  
     25[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: 7c1185e0-337b-490d-92f2-119d7f96a367 | Resource Type: unc.vm | Resource Units: 1 ]  
     26[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: b9550c8e-de60-4504-8eb2-563d96f18c35 | Resource Type: uncEuca.vlan | Resource Units: 1 ]  
     27[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: 4f0ddc63-6e1a-4b55-8547-c2522abd7be1 | Resource Type: uncEuca.vlan | Resource Units: 1 ]  
     28[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: c7816bf2-0555-4e59-8502-6ed203dede9d | Resource Type: unc.vm | Resource Units: 1 ]  
     29[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: 33f84b75-0874-444c-9809-a017b799a868 | Resource Type: uncEuca.vlan | Resource Units: 1 ] 
     30... 
     31}}} 
     32 1. To check the status of the sliver, run the 'sliverStatus' script (use the same slice name as used in the createSliver step) 
     33{{{ 
     34$ python sliverStatus.py -s http://hostname:11080/orca/xmlrpc -i some-slice-name-no-spaces 
     35}}} 
     36 1. To delete the sliver, run the 'deleteSliver' script.  
     37{{{ 
     38$ python deleteSliver.py -s http://hostname:11080/orca/xmlrpc -u some-slice-name-no-spaces 
     39}}} 
     40 
     41== Using ProtoGENI AM API == 
     42 
     43The same controller also presents the ProtoGENI AM XMLRPC API. Those can be exercised using the Omni tool. Using Omni requires [wiki:orca-tomcat enabling SSL support in Tomcat].  
     44 
     45You must first create a ProtoGENI slice using omni tool, and then use the omni tool to create a sliver in ORCA (really, a slice at this point) in native mode with -a option pointing to (note the  URL difference) https://hostname:11443/orca/xmlrpc.  
     46 
     47Use ProtoGENI RSpec v2 with omni. ORCA XMLRPC controller relies on [http://geni-test.renci.org:11080/ndl-conversion/convert.jsp NDL-OWL format converter] to convert requests from RSpec v2 to NDL-OWL.