set openflow controller

Use this command to configure a new controller, or modify an existing controller (if the IP address is the same for the existing controller).

set openflow controller {{active IPv4 address } | passive} {tcp | tls} [port-string] [rate-limit rate-limit] { [burst-size burst-size] }}

Parameters

IPv4 address IPv4 address for the controller.
active Designates that the switch initiates connection with the controller at the specified IPv4 address.
passive Designates that the controller initiates connection with the switch by listening on the specified port for controller(s) to connect.
tcp Sets Transmission Control Protocol (unsecure) as the protocol for in-band control communications between the switch and controller.
tls Sets Transport Layer Security (secure) as the protocol for in-band control communications between the switch and controller. To set up TLS switch private key, switch certificate, and controller Certificate Authority (CA) certificate, see set tls.
port-string Sets TCP port. Range is 1 to 65535. Default is 6633.
rate-limit rate-limit Sets a rate-limit for packet-in packets sent to controller. Range is 100 to 2,147,483,647. Default is 1,000.
burst-size burst-size Limits the number of accumulated packet-in packets. Defaults to 25% of rate-limit.

Defaults

If no value is specified:
  • TCP port defaults to 6633.
  • Rate-limit defaults 1,000.
  • Burst-size defaults to 25%.

Mode

All command modes.

Example

The following example points the switch to a controller located at 10.1.10.1, and sets up an active connection where the switch initiates connection with the controller using TCP:

set openflow controller active 10.1.10.1 tcp

The following example creates a passive TLS connection to the controller, where the switch listens on port 6655, with a rate-limit of 50,000 packets per second:

set openflow controller passive tls 6655 rate-limit 50000