Changes between Version 1 and Version 2 of Layer1Transport/Usage
- Timestamp:
- 07/31/13 16:09:50 (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Layer1Transport/Usage
v1 v2 1 1 [[PageOutline]] 2 2 3 = Introduction = 3 = GENI layer1transport service usage = 4 5 == Introduction == 4 6 This page describes how to use the layer1transport service. 5 7 6 = Variables=8 == Variables == 7 9 || '''Name''' || '''Description''' || '''Default Values''' || 8 10 || <rest_port> || REST API port for FL || 18080 || 9 11 || <flow_name> || Name of flow according to SFP || || 10 12 11 = Using the Service=13 == Using the Service == 12 14 The following is a brief description of how the service can be used. 13 15 14 == Common Work flows==16 === Common Work flows === 15 17 There are limitations to what this service can do at the moment, so below I will list some steps to take for various work flows. 16 18 17 === Adding a new flow===19 ==== Adding a new flow ==== 18 20 When adding a new connection in that needs a new flow defined in the switch: 19 21 1. Define the flows and put them into a new file under `/home/openflow/floodlight/flows.d/` … … 25 27 This should push the new flows without disrupting connectivity for other existing connections. 26 28 27 === Removing a flow===29 ==== Removing a flow ==== 28 30 When removing a connection that relies on a specific flow: 29 31 1. Determine which flows should be removed and collect the names of the flows … … 35 37 This should remove flows by name without disrupting connectivity for other existing connections. 36 38 37 === Updating an existing flow===39 ==== Updating an existing flow ==== 38 40 If you need to update a flow that has already been defined and pushed: 39 41 1. Update the flows file to use the new flow information … … 47 49 }}} 48 50 49 === Restoring Static Flow Pusher (SFP) to a known state===51 ==== Restoring Static Flow Pusher (SFP) to a known state ==== 50 52 If you believe that SFP may be out of sync with the desired state, but your are unsure what the specific problem is, then the best option may be to restart the service with: 51 53 {{{ … … 55 57 This will briefly remove and reinstall all static flows, so this is disruptive to connectivity managed by this service. 56 58 57 === Listing the flows that SFP knows about===59 ==== Listing the flows that SFP knows about ==== 58 60 To list which flows SFP knows about, the most up-to-date information can be found in [http://docs.projectfloodlight.org/display/floodlightcontroller/Static+Flow+Pusher+API+%28New%29 the SFP documentation]. 59 61 60 === Listing the flows that a switch knows about===62 ==== Listing the flows that a switch knows about ==== 61 63 To list which flows that a given switch knows about, the most up-to-date information can be found in [http://docs.projectfloodlight.org/display/floodlightcontroller/Floodlight+REST+API the REST API documentation] under the command for querying for flow statistics. 62 64 63 65 64 == Defined Service Commands==65 === start===66 === Defined Service Commands === 67 ==== start ==== 66 68 The following command will cause the floodlight controller to start and it will push the flows that exist in the flows files. 67 69 {{{ … … 69 71 }}} 70 72 71 === stop===73 ==== stop ==== 72 74 The following command will cause the flows that are defined in the flows files to be explicitly removed, and it will cause the floodlight controller to stop. Floodlight's SFP module will not preserve flows when floodlight is shut down, so any remaining flows (whether they are inserted through other means, or if they are stale for some reason) will be removed. 73 75 {{{ … … 75 77 }}} 76 78 77 === reload===79 ==== reload ==== 78 80 The following command will cause the floodlight module to read in the flows files, and add any flows which have names that are unknown to the floodlight SFP service. Note that this '''will not''' remove flows that are removed from files, it '''will not''' remove flows if a file has been removed, and it '''will not''' update flows with a name that SFP already knows about. 79 81 {{{ … … 81 83 }}} 82 84 83 === restart===85 ==== restart ==== 84 86 The following command will stop, pause, and then start the layer1transport service. 85 87 {{{ … … 87 89 }}} 88 90 89 === status===91 ==== status ==== 90 92 The following command will return a non-zero value if floodlight is not running, or if there are some flows defined in `/home/openflow/floodlight/flows.d/` which the floodlight controller's SFP module doesn't know about. It will return zero otherwise. 91 93 {{{
