Changes between Version 13 and Version 14 of orca-xmlrpc-controller

Show
Ignore:
Timestamp:
12/03/11 17:36:29 (8 years ago)
Author:
ibaldin (IP: 108.65.61.102)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • orca-xmlrpc-controller

    v13 v14  
    1313The same controller also presents the ProtoGENI AM XMLRPC API. Those can be exercised using the [http://trac.gpolab.bbn.com/gcf/wiki/OmniProtoGeni Omni tool]. Using Omni requires [wiki:orca-tomcat enabling SSL support in Tomcat] prior to starting the container with the SM and starting the controller.  
    1414 
    15 Visit [wiki:orca-with-omni this page] for more documentation on using Omni to create slice requests.  
     15Visit [wiki:orca-with-omni this page] for more documentation on using Omni to create slice requests. Note that you must acquire a private key and a certificate signed either by ProtoGENI/Emulab or GPO in order to be able to create slices. 
    1616 
    1717== Using native ORCA interface == 
     
    1919The native ORCA XMLRPC interface can be exercised using Python scripts shipped with ORCA source distribution (primarily as a testing tool) as well as using [wiki:flukes Flukes GUI] targeted at experimenters. The Python scripts are described below.  
    2020 
     21Prior to using the scripts you must obtain a private key and a certificate signed either by ProtoGENI/Emulab, GPO or BEN ('''note that BEN certificate will not work for using omni'''). From Emulab and GPO you will get a single file with .pem extension that contains your private key and a public key certificate signed by Emulab or GPO. This file should be passed both as a '-c' and a '-p' option to the python scripts below. From BEN you will get two files - username.crt (your certificate) and username.key (your private key). The .crt file should be passed in with the '-c' option and the private key with the '-p' option. 
     22 
    2123 1. Open a terminal and navigate to the directory, [source:orca/trunk/controllers/xmlrpc/resources/scripts $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.  
    2224 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. 
    2325{{{ 
    24 $ python listResources.py -s http://hostname:11443/orca/xmlrpc  
     26$ python listResources.py -s https://hostname:11443/orca/xmlrpc -c /path/to/your/certificate -p /path/to/your/privateKey 
    2527}}} 
    2628 1. To create a clice, run the 'createSlice' script. The script needs the name of the file containing resource request in NDL. A number of examples are available in the regression test suite under [source:orca/trunk/network/src/test/resources/orca/network]. The response to the script will look approximately as shown (UUIDs and Reservation IDs will be different. 
    2729{{{ 
    28 $ python createSlice.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 
     30$ python createSlice.py -s https://hostname:11443/orca/xmlrpc -k ~/.ssh/id_dsa.pub -i some-slice-name-no-spaces -r /path/to/request/file/in/NDL  -c /path/to/your/certificate -p /path/to/your/privateKey 
    2931... 
    3032[   Slice UID: 05d30971-2b1c-4a52-817c-bc192a878a8b | Reservation UID: 5063cd58-75cf-4c58-8824-cf86d329b9d9 | Resource Type: unc.vm | Resource Units: 1 ]  
     
    3840 1. To check the status of the slice, run the 'sliceStatus' script (use the same slice name as used in the createSlice step) 
    3941{{{ 
    40 $ python sliceStatus.py -s http://hostname:11080/orca/xmlrpc -i some-slice-name-no-spaces 
     42$ python sliceStatus.py -s https://hostname:11443/orca/xmlrpc -i some-slice-name-no-spaces  -c /path/to/your/certificate -p /path/to/your/privateKey 
    4143}}} 
    4244 1. To delete the slice, run the 'deleteSlice' script.  
    4345{{{ 
    44 $ python deleteSlice.py -s http://hostname:11080/orca/xmlrpc -u some-slice-name-no-spaces 
     46$ python deleteSlice.py -s https://hostname:11443/orca/xmlrpc -i some-slice-name-no-spaces  -c /path/to/your/certificate -p /path/to/your/privateKey 
    4547}}} 
    4648