ESnetESnetNetworking for Science

User Manual

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.

 

Web Browser Interface (WBUI)

1. Login Before you can access the server you must login using the user name that you were given by the domain administrator and your password. OSCARS will then issue a cookie to your browser that will keep you authenticated for 8 hours. Once you are logged in, you will see a row of tabs from which you can select the desired action. The parts of the WBUI that you will see depends on what authorizations you have. A normal OSCARS-user will only be able to create a reservation, list and see the… Read More »

Web Service Interface (API)

See this page for more about the Web Service Interface. OSCARS provides a Java client-side interface class, net.es.oscars.client/Client.java, to setup, marshal parameters, send, receive and unmarshal the parameters. Read More »