Changes between Version 12 and Version 13 of orca-oscars

Show
Ignore:
Timestamp:
07/11/13 17:56:16 (6 years ago)
Author:
ibaldin (IP: 152.54.9.21)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • orca-oscars

    v12 v13  
     1[[TOC]] 
    12= Configuring ORCA OSCARS/ION handler = 
    23 
    34== Overview == 
    45 
    5 ORCA OSCARS/ION handler provides Orca with the interface to control Internet2 ION and ESnet OSCARS dynamic circuit services which provide VLAN-like MPLS service between connected sites. 
     6ORCA OSCARS/ION handler provides Orca with the interface to control Internet2 ION and ESnet OSCARS dynamic circuit services which provide VLAN-like MPLS service between connected sites. The ORCA handler deals with both v05 and v06 OSCARS versions (but not at the same time).  
    67 
    7 == Configuration == 
     8== OSCARS v05 == 
     9 
     10=== Configuration === 
    811 
    912Orca invoked OSCARS/ION client API via shell scripts. The client API first must be installed under $ORCA_HOME and a properties file needs to be created to communicate the configuration to ORCA. The client API must be configured with user certificate issued by Internet2 or ESnet to the user that has rights to create circuit reservations. 
     
    2629}}} 
    2730 
     31== OSCARS v06 ==  
     32 
     33=== Configuration === 
     34 
     35Orca invoked OSCARS/ION client API via shell scripts. The client API program first must be installed using RPM or directly and a properties file needs to be created to communicate the configuration to ORCA. The properties include pointer to a Java keystore that includes 
     36 
     37 * Private key and certificate of the user authorized to speak to OSCARS (typically issued by Internet2 or ESnet) 
     38 * Trusted certificate of the IDC server to which the handler will be speaking. This can be retrieved by using openssl command and installed into a JKS. 
     39 
     40Typically all certs and keys can be stored in the same JKS file protected by a single password. 
     41 
     42=== Installing OSCARS/ION client software === 
     43 
     44Use the code from [source:orca-external/oscars-0.6/trunk here] and install either as RPM or directly from source 
     45 
     46{{{ 
     47$ mvn clean package 
     48$ tar -zcf oscars-0.6-client.tgz target/appassembler  
     49$ scp oscars-0.6-client.tgz some.host.running.orca:/opt/oscars-0.6 
     50$ ssh some.host.running.orca tar -zxf /opt/oscars-0.6/oscars-0.6-client.tgz -C /opt/oscars-0.6/ 
     51}}} 
     52 
     53It can be tested by issuing 'oscars' command 
     54 
     55{{{ 
     56some.host.running.orca$ /opt/oscars-0.6/bin/oscars --command list --truststore /path/to/truststore.jks --keystore /path/to/keystore.jks --alias key-alias --keystorepass password  
     57}}} 
     58 
    2859== Configure ORCA handler == 
    2960 
    3061Modify the [source:orca/trunk/handlers/oscars/oscars.site.sample.properties following property file] and install it under $ORCA_HOME/oscars/oscars.site.properties. Specify 'oscars.site.properties' property to point to this file in the actor configuration. [source:config-files/trunk/geni-ben.renci.org.config.xml Example] actor configuration file. 
     62 
    3163 
    3264== Handler details ==