configure openflow controller

configure openflow controller [primary | secondary] out-of-band [active ipaddress ipaddress {tcp_port} | passive { tcp_port}] {tls} {{vr} vr_name} {rate-limit rate_limit {burst-size burst_size}}


Configures the OpenFlow controller(s) that the switch will communicate with.

Syntax Description

primary Specifies the primary openflow controller.
secondary Specifies the secondary openflow controller.
port Specifies the port number for in-band mode .
port-number Specifies the physical port number.
out-of-band Specifies the out-of-band connection to the controller.
active Specifies that you actively connect to the controller .
ipaddress Specifies that you use an IP address for active out-of-band mode; it might be followed by tcp port.
ipaddress Configures an IP address, for example:
port Specifies the TCP port. for example: 6643.
passive Configures the passive mode for out-of-band; you must specify a tcp port.
tls Specifies that you use the Transport Layer Security (TLS) option.
vr Specifies that you use the virtual router option.
vr_name Specifies the name of the virtual router.
rate-limit Specifies the rate-limit Packet-In packets sent to the controller.
rate_limit Specifies packets per second. Default is 1000, the range is 100-2147483647.
burst-size Specifies that you use the burst-size with rate-limit.
burst-size Specifies the burst size in bytes; the range is 1500-65536.


If burst-size is not specified, the default is 1500 bytes. If rate_limit is not specified, the default value is 1000.

Usage Guidelines

Use this command to configure the OpenFlow controller(s) that the switch will communicate with.   

If only a secondary controller is configured, it will be treated as a primary controller until a primary controller is configured.  

OpenFlow attempts to communicate with the primary controller until connectivity fails, in which case it automatically fails over to the secondary controller, if configured.   'out-of-band' control enables controller(s)  to connect to the switch using a non-OpenFlow vlan.   ‘vr‘ specifies the virtual router used by the switch to communicate with the controller(s).

The rate-limit rate and burst-size burstSize options limit the rate and burst-size of messages sent from the switch to the controller. 


The following example illustrates how to use the configure openflow controller command:

configure openflow controller primary out-of-band active ipaddress 6633 vr vr-mgmt     


This command was first available in ExtremeXOS 15.3.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the OpenFlow feature, see the ExtremeXOS 22.2 Feature License Requirements document.