= Switch Control Service =

ORBIT provides OMF based "Aggregate Manager" for configuration of networking devices in the testbed (Network AM). The HTTP based service can be accessed by an experimenter from within the SB9, including from the console and all of the nodes, at the following address:

{{{
http://nox.orbit-lab.rutgers.edu:5052/network
Or simply as:
http://nox:5052/network
}}}

That base URL renders an XML response detailing all requests implemented by the service. Parameter values, such as to address a particular port (port #) on a particular switch (switch IP address), can be passed as URL arguments in the HTTP request. For example, to retrieve the details of particular port (say 5) on the SB9 switch ('''IP=10.19.0.253'''), the requested URL is:

{{{
http://nox:5052/network/portStat?switch=10.19.0.253&port=5
}}}

The service supports the following main features for the native mode (refer to XML response from the base URL for complete list and API specification):

 1. Getting/setting the VLAN ID on any port(s)
 1. Assigning two or more VLAN IDs on a port, making it a trunk 
 1. Getting per port statistics (in, out packet counts) and configuration (VLAN) information
 1. Enabling/disabling a port
 1. Turning on/off default switch topology protocols - Spanning Tree Protocol (STP)
 1. Saving the per-port configuration of the entire switch
 1. Restoring switch configuration to prior saved version

In addition, it supports the following requests to support the !OpenFlow mode:

 1. Change the mode of the switch from native to !OpenFlow mode (and vice versa)
 1. Set the !OpenFlow mode parameters including: control port, controller IP, switch ID (dpid), and the transport mode for secure channel

== Pronto 3240 Management ==
Pronto switches can be configured for of following modes:

 * !XorPlus
 * Production Indigo !OpenFlow image (i.e. internal flash image)
 * User define !OpenFlow image (i.e. NFS booted image)

To be able to switch between these modes you have to be logged in conosole.sb9.

=== Examples ===

Force switch into !XorPlus mode (i.e. out of !OpenFlow mode)
{{{
wget http://nox.orbit-lab.org:5052/network/deleteOpenFlow?switch=10.19.0.253
}}}

Force switch into !OpenFlow mode with controller at node1-1.sb9.orbit-lab.org
{{{
wget http://nox.orbit-lab.org:5052/network/addOpenFlow?switch=10.19.0.253\&ofip=10.19.1.1\&ofp=6633
\&dpid=0x001010162001
}}}
ofp and dpid are optional (if omitted will be configured with the default set).

Force switch into !OpenFlow NFS mode
To configure switch in !OpenFlow NFS mode, bootmode parameter has to be specified. Additional 3 parameters can be specified, nfsip, roottpath and bootfile. These parameters are optional, if omitted will be configured whit initially set parameters (for sb9 operation NSF server is provided on the console so the experimenter should place the image file names uInitrd2m into /tftpboot directory before issiong this command)

{{{
wget http://nox.orbit-lab.org:5022/network/addOpenFlow?switch=10.19.0.253\&ofip=10.19.1.1\&ofp=6633
\&dpid=0x001010162001\&bootmode=nfs\&nfsip=10.19.0.10\&roothpath='\/config'\&bootfile=uInitrd2m
}}}