Uninstalling Cisco Plug-in for OpenFlow

Uninstalling Cisco Plug-in for OpenFlow

The Cisco OpenFlow Agent was introduced in Cisco NX-OS Release 7.0(3)I5(1), replacing the Cisco Plug-in for OpenFlow used in previous releases. The Cisco Plug-in for OpenFlow, which runs as an application in a virtual services container, is no longer supported as of this release. When upgrading from a release earlier than Cisco NX-OS Release 7.0(3)I5(1) to Cisco NX-OS Release 7.0(3)I5(1) or a later release, you must deactivate and uninstall the Cisco Plug-in for OpenFlow application from the virtual services container using the procedure described in this section.

Cisco OpenFlow Agent support for the Cisco Nexus 3548 was introduced in Cisco NX-OS Release 7.0(3)I7(2) replacing the Cisco Plug-in for OpenFlow used from Cisco NX-OS Release 6.0(2)A8(1). When upgrading form a release earlier than Cisco NX-OS Release 7.0(3)I7(2) to Cisco NX-OS Release 7.0(3)I7(2) or a later release, you must deactivate and uninstall the Cisco Plug-in for OpenFlow application from the virtual services container using the procedure described in this section.

Converting a Previous OpenFlow Configuration

When you upgrade to a release that requires you to uninstall the Cisco Plug-in for OpenFlow, you can save your existing OpenFlow configuration and modify it for use with the Cisco OpenFlow Agent. Perform the following procedure before uninstalling the Cisco Plug-in for OpenFlow.

Procedure

Step 1

Capture the current OpenFlow configuration.

Enter the CLI command show run | section openflow to display the current OpenFlow configuration, as shown in this example.

Example:


Switch# show run | section openflow
hardware access-list tcam region openflow 512 double-wide
  mode openflow
  mode openflow
  mode openflow
  mode openflow
  mode openflow
openflow            <-----------  Copy this section to your text editor.
  switch 1
    pipeline 201
    controller ipv4 5.1.1.237 port 6653 vrf management security none
    of-port interface Ethernet1/11-15

Step 2

Copy the configuration and paste it into your text editor.

Step 3

Make the changes described below.

  • Add the feature openflow command to enable the Cisco OpenFlow Agent.

  • Combine the switch and pipeline commands into one command.

  • Expand any interface ranges.

Example:


feature openflow  <------------------------- Add this comment to enable openflow agent

openflow
  switch 1 pipeline 201  <------------------ Create switch command is in this format
    controller ipv4 192.168.1.36 port 6653
    of-port interface Ethernet1/11  <------- Change Ethernet1/11-15 to this format
    of-port interface Ethernet1/12
    of-port interface Ethernet1/13
    of-port interface Ethernet1/14
    of-port interface Ethernet1/15

Step 4

Make the changes described below.

When upgrading from a release earlier than Cisco NX-OS Release 7.0(3)I7(2) to Cisco NX-OS Release 7.0(3)I7(2) or a later release, obtain the Node-ID of the switch from the OpenFlow controller to which the switch is registered. Copy the Node-ID in your text editor. After upgrading, configure the Node-ID under OpenFlow.

Example:

openflow
switch 1 pipeline 201
controller ipv4 192.168.1.36 port 6653 vfr management security none
datapath-id 0x174a02fc67f00

Note

 

0x174a02fc67f00 is the Node-ID of the switch which had been registered with the OpenFlow controller before upgrading.

Step 5

Make the changes described below.

If the 'onep_apps_openflow_GLOBAL_VER.cli' file exists under bootflash:onep/apps-cli, it must be removed if you are upgrading from a release earlier than Cisco NX-OS Release 7.0(3)I7(2) to Cisco NX-OS Release 7.0(3)I7(2) or a later release.

Example:

switch# delete bootflash:onep/apps-cli/onep_apps_openflow_GLOBAL_VER.cli

What to do next

After uninstalling the Cisco Plug-in for OpenFlow, uninstalling the virtual service container (if necessary), and upgrading the switch, follow the instructions in this guide to enable the Cisco OpenFlow Agent. Then load the modified configuration into the switch.

Deactivating and Uninstalling an Application from a Virtual Services Container

(Optional) Perform this task to uninstall and deactivate an application from within a virtual services container.

Procedure

  Command or Action Purpose

Step 1

enable

Example:

Device> enable

Enables privileged EXEC mode.

  • Enter your password if prompted.

Step 2

configure terminal

Example:

Device# configure terminal

Enters global configuration mode.

Step 3

virtual-service virtual-services-name

Example:

Device(config)# virtual-service openflow_agent

Enters virtual services configuration mode to configure a specified application.

  • Use the virtual-services-name defined during installation of the application.

Step 4

no activate

Example:

Device(config-virt-serv)# no activate

Disables the application.

Step 5

no virtual-service virtual-services-name

Example:

Device(config)# no virtual-service openflow_agent

Unprovisions the application.

  • Use the virtual-services-name defined during installation of the application.

  • This command is optional for all devices running Cisco IOS-XE.

Step 6

end

Example:

Device(config-virt-serv)# end

Exits virtual services configuration mode and enters privileged EXEC mode.

Step 7

virtual-service uninstall name virtual-services-name

Example:

Device# virtual-service uninstall name openflow_agent

Uninstalls the application.

  • Use the virtual-services-name defined during installation of the application.

  • Run this command only after receiving a successful deactivation response from the device.

Step 8

copy running-config startup-config

Example:

Device# copy running-config startup-config

Saves the change persistently through reboots and restarts by copying the running configuration to the startup configuration.