home > User Manual

User Manual

OSCARS version 0.3 Apr 2008

  1. Introduction
  2. Web Browser Interface (WBUI)
    1. 1. Login
    2. 2. Create Reservation
      1. Common Parameters
      2. Layer 3 Parameters (only supported by ESnet)
      3. Layer 2 Parameters
    3. 3. List Reservations
    4. 4. Reservation Details
    5. 5. Cancel Reservation
    6. 6. User Profile
    7. 7. User List
    8. 8. Add User
  3. Web Service Interface (API)
    1. 1. Create Reservation
    2. 2. Query Reservation
    3. 3. List Reservations
    4. 4. Modify Reservation
    5. 5. Cancel Reservation
    6. 6. Forward
    7. 7. Get Network Topology
    8. 8. Initiate Topology Pull
    9. 9. Refresh Path
    10. 10. Teardown Path

Introduction

The OSCARS Interdomain Controller (IDC) allows end users to reserve high priority bandwidth between two hosts. The hosts may be in the same ISP domain, or may be in different domains if each of ISPs between the two hosts are running co-operating IDCs.

There are two interfaces provided by the IDC: a forms based web browser interface (WBUI) and a web services SOAP message interface (API). Both are secure interfaces and require the user to be registered and authorized by the ISP at which the reservation starts. Individual authorization at subsequent ISPs is not required. Both interfaces allow the user to make, query, list, modify and delete reservations. In addition, the WBUI allows an administrator to add, authorize, and manage users, and the user to modify his user profile, and the API provides interfaces to signal the instantiation of a path or to tear it down. The API also provides interfaces intended for the use of OSCARS services running in other domains to forward a request and to request network topology.

The ESnet WBUI is accessible at https://oscars.es.net/OSCARS/. The I2 WBUI is accessible at https://ndb3-blmt.abilene.ucaid.edu:8443/OSCARS. If you are connecting to I2 through an RON, you will need to contact them for the WBUI URL to use.

The WSDL and type files that define the Web Service Interface can be found  here.