Indigo 2012.09.07 Release Notes
Table of Contents
Introduction
Please see the documentation on the Indigo pages at http://www.openflowhub.org/display/Indigo for the latest documentation and information.
These are the release notes for Indigo software releases. It was originally generated for the 2011.08.06 release and last updated for the 2012.09.07 release. Below are updates in chronological order, most recent first.
Update for 2012.09.07
This is a partial release focused on the Pronto 3290 (LB9A) and Pronto 3780 (LB8). Other platforms may build and work but have not been validated for this release. It includes a push to git hub https://github.com/bigswitch/iods and new binary images for the target platforms on the Indigo site: http://www.openflowhub.org/display/Indigo.
- Preliminary support for controller contact information via DHCP
- Update to Busybox 1.20.2 for most platforms
- Various initialization sequence fixes (Indigo-134)
- Updates for stats reply bugs (Indigo-132)
- Support various port characteristic fields in physical port descriptions
- Fix various VLAN tag related matching and manipulation issues including setting VLAN priority field
Update for 2012.03.19
This is a full release including a push to git hub, https://github.com/bigswitch/iods, and new binary images placed on the Indigo site: http://www.openflowhub.org/display/Indigo.
Updates for this release include:
- Use standard busybox initialization management. See March 2012 Indigo Initialization
- Continued improvement of management interface specification and configuration. See March 2012 Indigo Initialization
- Fixed issues related to HW and datapath description
- Addressed queuing bug (Indigo-125)
- Addressed VLAN processing bug (Indigo-91)
- Cleaned up and limited logging messages from various sources
- Enabled source and dest MAC rewrite for the Pronto 3780 platform
Update for 2011.12.05
This is a full release including a push to git hub, https://github.com/bigswitch/iods, and new binary images placed on the Indigo site: http://www.openflowhub.org/display/Indigo.
Updates for this release include:
- Support for ToS matching
- Preliminary support (unvalidated) for ToS/DSCP rewriting on the Pronto 3290
- Fixed issues related to restarting OpenFlow daemons
- Support for restarting OpenFlow daemons from web pages to pick up OpenFlow related configuration changes
- Better treatment of defaults for some configuration parameters such as the DPID
Special thanks to Ken Chiang for his work on this release.
Update for 2011.11.08
This is a full release including a push to git hub, https://github.com/bigswitch/iods, and new binary images placed on the Indigo site: http://www.openflowhub.org/display/Indigo.
Updates for this release include:
- Fixed a NULL pointer dereference in flow modify; Indigo-115
- Fixed SSH reference in initialization
Update for 2011.10.03
This is a full release including a push to git hub, https://github.com/bigswitch/iods, and new binary images placed on the Indigo site: http://www.openflowhub.org/display/Indigo.
Updates for this release include:
- Support for a max-rate queuing property
Support has been added to allow the specification of the maximum rate for a queue. Like min-rate, this is specified in tenths of a percent (1-1000). This feature may be controlled using dpctl; the appropriate queue commands now take an additional optional parameter.
Update for 2011.09.08
This is a full release including a push to git hub, https://github.com/bigswitch/iods, and new binary images placed on the Indigo site: http://www.openflowhub.org/display/Indigo.
Updates for this release include:
- Support for destination and source MAC address rewrite on the Pronto 3290
- Timestamps on some debug messages
- Re-instatement of the fan daemon, fand, on the 3290
- Support of the Triumph 2 Broadcom Reference Design
- Report the output port in flowtable display in the CLI
This release passes the OFTest suite on the Pronto 3290 and the GSM7328OS platforms. but has received limited validation on other platforms.
Update for 2011.08.15
A source code update was pushed to git hub to address Indigo-98. This affected primarily the binary images.
Supported Platforms
This release targets all current Indigo platforms. However it has received more validation on some platforms. Apologies in advance if your platforms have not received validation. Please report issues to the Indigo forums at http://www.openflowhub.org/display/Indigo.
Platform |
Validation Status |
---|---|
Netgear GSM7328OS |
Passes OFTest Suite |
Netgear GSM7352OS |
Passes OFTest Suite |
Pronto 3290 |
Limited Validation |
Pronto 3780 |
No validation |
Pronto 3240 |
No validation |
Original Notes for 2011.08.06
These are the release notes for the 2011.08.06 release of the Indigo software package. This is a comprehensive release that includes source and binary components. The release includes the usual binary flash images to be loaded on to Indigo target platforms.
With this release comes the introduction of IODS, the Indigo Open Development System. This is a source based release with prebuilt binaries for the portions of the code that are covered by NDAs. With this release, the binaries include all of the functionality of the OpenFlow datapath. This may be further refined in the future.
The download pages are pointed to from the Indigo OpenFlow Hub page: http://www.openflowhub.org/display/Indigo
See the release notes for previous releases for features that were add there.
Other Documents
The following documents are included in the release. They should additionally be available on the Indigo support pages on http://www.openflowhub.org/display/Indigo.
Document |
Description |
---|---|
Indigo 2011.08.06 Release Notes |
These release notes |
Indigo Initialization and Configuration |
Description of configuration variables with "how to" guide |
Building IODS |
How to document for building from source using the Indigo Open Development System |
Indigo 1.0 Overview |
High level overview of Indigo architecture |
Indigo CLI Reference |
Description of CLI commands |
In-Band Management for Indigo |
Details of working with and configuring dataplane management |
IODS VM Bringup |
Details on configuring an IODS build server |
Indigo CLI Internals |
Software architecture document detailing CLI implementation |
Major Updates
There are only two major externally visible updates for this release.
- The CLI has been significantly simplified and made more consistent.
- The IODS build environment is being released.
There has been a significant amount of documentation added for this release.
Licenses
License information for the OpenFlow binaries and for Dropbear are available at: http://www.openflowhub.org/display/Indigo/License+Information.
The Linux kernel code for recent releases is based on versions 2.6.25 - 2.6.27 and is released under GPLv2.
Busybox is version 1.13.3 or 1.14.2 and is released under the GPLv2. It is available at http://busybox.net/downloads/.
Limitations
The following are known limitations for the current platforms. Note that these are generally not expected to be fixed for these platforms.
Counters are byte or packet, not both
For flows, only packet counters or byte counters are supported, not both simultaneously. In the configuration of this release, only packet counters are supported. Applies to all platforms.
Actions sequencing is not supported.
For example, the action list with 4 actions: "(1) set VID to X, (2) output to port A, (3) set VID to Y, (4) output to port B" has the intention of sending the packet out on different ports with different VLANs. This is not supported. However, sending to multiple ports by specifying each port in a different output action is supported. Applies to all platforms.
Not all OpenFlow actions are supported.
The following are not currently supported on any Indigo platform:
OFPAT_SET_NW_SRC (Set L3 IP source address) OFPAT_SET_NW_DST (Set L3 IP destination address) OFPAT_SET_TP_SRC (Set L4 source port) OFPAT_SET_TP_DST (Set L4 destination port)
The following are only supported on the Pronto 3290 and the Triumph 2 reference:
OFPAT_SET_DL_SRC (Set L2 MAC source address) OFPAT_SET_DL_DST (Set L2 MAC destination address)
OFPAT_STRIP_VLAN (Strip VLAN tag) is supported (but with only limited validation) on the 3290 and 3240 platforms. On other platforms, the function can be implemented by setting to the system's untagged VLAN (untested).
Cannot multicast and wildcard source port.
Actions with a wildcard source port may not specify "flood" nor multicast (multiple output ports) with the expectation of source port blocking.
Known Issues
For a complete list, see the Jira pages at the Indigo website: http://www.openflowhub.org/display/Indigo.
Issue number |
Title |
Fixed In |
---|---|---|
Indigo-129 |
Counters for hit flow entries are not shown as increasing |
 |
Indigo-128 |
Web interface setting of the switch IP address are not configured correctly |
2012.03.19 |
Indigo-127 |
Need log rotation |
2012.03.19 |
Indigo-126 |
48 port GSM7352 has "split brain" problem |
 |
Indigo-125 |
Deleting queues is broken |
 |
Indigo-123 |
After of-restart, the CLI command 'config running' may not show accurate information about the running configuration |
 |
Indigo-122 |
3780 needs restart if too many flows are added |
 |
Indigo-120 |
dpctl mod-flow seems broken |
 |
Indigo-118 |
Cannot configure multiple queues in one message |
 |
Indigo-117 |
OUI for tap0 address wrong |
 |
Indigo-115 |
Segfault on 3290 when connected to Nox Zaku running simplerouting |
2011.11.08 |
Indigo-112 |
Counters for VLAN qualified flows are incorrect |
 |
Indigo-103 |
Barrier reply returns before commands fully committed to ASIC |
 |
Indigo-102 |
Active flows are being expired via idle timeout prematurely |
 |
Indigo-101 |
MPLS ethertype on 3780 ignored |
 |