An instance of OSCARS, the IDC on Internet2's DCN, exists that allows you to preview the OSCARS web user interface, test new DCN applications, and test peering your IDC with Internet2. It maintains a view of Internet2's DCN but does not provision real circuits. The goal is to provide a sandbox for developers and new users to experiment with the dynamic circuit creation process.

Testing the Web User Interface

Anyone is free to test the WBUI. You may do so by visiting http://test-idc.internet2.edu/ and logging-in with the username and password pair guest/guest.

You may simulate the circuit creation process by clicking on the Create Reservation tab and entering the following parameters:
Source: test-newy.dcn.internet2.edu
Destination: test-chic.dcn.internet2.edu
Bandwidth: 100
Purpose of Reservation: [your name] testing

After successfully placing the reservation a page will load with the simulated circuit details. Within approximately 30 seconds hit the Refresh button and you should see the reservation labeled as ACTIVE. You may cancel the reservation or wait until the end-time to see the reservation labeled as CANCELLED or FINISHED respectively.

Testing a DCN Application

Applications contact the IDC using a web service API. Requests are authenticated by an X.509 certificate contained within every message. If you have your own application you would like to test or you are running the example command-line clients you may authenticate to test-idc.internet2.edu using the guest certificate. The guest certificate is contained within the keystore you can download here.

If you are running your own application you will need to use this keystore to send requests. If you are using the example command-line clients you may do the following:

  1. Download the keystore containing the guest certificate here
  2. Copy the downloaded sec-client.jks file to OSCARS-client-api/examples/repo
  3. Open OSCARS-client-api/examples/repo/axis2.xml and change <user>...</user> to <user>guest</user> (NOTE: Instead of '...' the value between the user tag will be the name of the last user used to send a request. If you have never run the clients before it will read <user>alice</user>)
  4. Use the following parameters to create a circuit:

An example properties file named guest-resv.properties that can be used with the command ./run.sh createReservation -pf guest-resv.properties may be downloaded here. See the page OSCARS Client Java API for more information on how to run the command-line clients and acceptable parameters.

  • No labels