Cisco Catalyst SD-WAN Upgrade Guide

PDF

Cisco Catalyst SD-WAN Upgrade Guide

Upgrade considerations

Want to summarize with AI?

Log in

Issues to consider when planning to upgrade the software of a device operating in a Cisco Catalyst SD-WAN network.


Describes the issues to consider when planning to upgrade the software of a device operating in a Cisco Catalyst SD-WAN network.

Software image to use from Cisco IOS XE Catalyst SD-WAN Release 17.2.1r

From Cisco IOS XE Catalyst SD-WAN Release 17.2.1r, use the universalk9 image to deploy both Cisco IOS XE Catalyst SD-WAN and Cisco IOS XE on Cisco IOS XE Catalyst SD-WAN devices.

From Cisco IOS XE Catalyst SD-WAN Release 17.2.1r, UCMK9 image is not available.


Upgrade considerations: Multirate interfaces

Describes the multirate interface issues to consider when planning to upgrade the software of a device operating in a Cisco Catalyst SD-WAN network.

The following Cisco IOS XE Catalyst SD-WAN devices support multirate interfaces and support the 1GE small form-factor pluggable (SFP) (optical and CU) and 10GE SFP+ (optical and CU) modules on their 10G interfaces ports:

  • Cisco ASR 1001-HX Router

  • Cisco Catalyst 8500-12X4QC

  • Cisco Catalyst 8500-12X


Upgrade considerations: Autonegotiation

Describes autonegatiation issues to consider when planning to upgrade the software of a device operating in a Cisco Catalyst SD-WAN network.

These considerations apply to auto-negotiation in both Catalyst SD-WAN and non-SD-WAN modes of the router models that support multirate interfaces:

Before upgrading

Before upgrading to Cisco Catalyst SD-WAN Manager Release 20.12.1 or Cisco IOS XE Catalyst SD-WAN Release 17.12.1a or later releases, contact Cisco TAC to check and drop any non-compatible indexes. Non-compatible old index can impact successful upgrade to newer version.

CLI configuration

For releases before Cisco IOS XE 17.6.1a, auto-negotiation can be configured using the CLI.

10G interface with a 10GE SFP+ module

For releases before Cisco IOS XE 17.6.1a, if you use the CLI or Cisco Catalyst SD-WAN to reboot a device with a 10G interface that includes a 10GE SFP+ module, that interface will not come up. In this situation, use Cisco Catalyst SD-WAN or the CLI to configure no negotiation auto for the interface, then reboot the device.

Feature templates

From Cisco IOS XE Release 17.6.3a, auto neg values for auto-negotiation are pushed to 10G interfaces on supported devices through feature templates. Ensure that you know which SFP module is on which 10G interface on a device so that you can properly configure the feature template.

Restriction for the negotiation auto CLI command

On software releases up to Cisco IOS XE Release 17.6.3a, the negotiation auto command is not supported on a 10G interface that includes a 10GE SFP+ module.

Restriction for the no negotiation auto CLI command

On software releases up to Cisco IOS XE Release 17.6.3a, the no negotiation auto command with the default OFF option must be sent through a feature template to all 10G interfaces that include a 10GE SFP+ module. Otherwise, the template push fails.

Support for 10G interface with 10 GE SFP+ module

If you upgrade to Cisco IOS XE Release 17.6.3a from a release in which auto-negotiation was enabled on a 10G interface that includes a 10GE SFP+ module, that interface will not come up. In this situation, use the CLI to configure no negotiation auto for the interface after the upgrade completes.

From Cisco IOS XE Release 17.6.4 onwards, the negotiation auto command is supported on a 10G interface with 10 GE SFP+ module. In this scenario, in the output of show interface Tengig x/y/z , the link type is force-up regardless of negotiation auto/no negotiation auto configuration. The same is applicable when the configurations are pushed through Cisco SD-WAN Manager template.

Preparation for 10G interfaces with 10GE SFP+ module

Before upgrading to Cisco IOS XE Release 17.6.3a, use a feature template, a CLI add-on feature templates, or the CLI to apply the no negotiation auto command to all 10G interfaces that include a 10GE SFP+ module.

Support for 10G interface with 1GE Fiber and Copper SFP

From Cisco IOS XE Release 17.6.4 onwards, the negotiation auto command is supported on a 10G interface that includes a 1GE Fiber and Copper SFP.

ASR 1001-HX multirate support

For an ASR 1001-HX platform, multirate is supported only on the last four ports of bay1 8X10G/1G.

Redeploy configuration after upgrade

After upgrading a device, configurations for new features in the updated version are not applied automatically. To enable these new features, you must manually redeploy the configuration group or device template.


Upgrade considerations: Cisco 8000 Series Routers

Describes the issues to consider when planning to upgrade the software of C8300 and C8500L-8S4X routers operating in a Cisco Catalyst SD-WAN network.

10G interface with 10GE SFP+ module

  • From Cisco IOS XE Release 17.15.1 and later, the negotiation auto command is supported on a 10G interface that includes a 10GE SFP+ module.

  • From Cisco IOS XE Release 17.15.1 and later, on a 10G interface that includes a 10GE SFP+ module, the output of show interface Tengig x/y/z always shows the link type as force-up, regardless of negotiation auto/no negotiation auto configuration. The same is applicable when the configurations are pushed through Cisco SD-WAN Manager template.

Dual rate ports

The command show running config does not display no neg auto for dual rate ports in Controller mode. Where as show sdwan running-config shows no neg auto . In case of neg auto configuration, the command show interfaces interface-num always displays for dual rate ports with 10G optics.

Autonegotiation

Ensure that the negotiation configuration matches with the peer device interface settings. If there is a mismatch in the interface settings, the interface may go down.

Table 1. Cisco 8300 Series platforms: Autonegotiation defaults by platform and small form-factor pluggable (SFP) module type

SFP module type

Default autonegotiation

Default speed

Default duplex

1G Copper

On

1000 M

Full

1G Optical

On

1000 M

Full

10G Optical

On

10,000 M

Full

Table 2. Cisco 8500 Series platforms: Autonegotiation defaults by platform and small form-factor pluggable (SFP) module type

SFP module type

Default autonegotiation

Default speed

Default duplex

1G Copper

Off

1000 M

Full

1G Optical

Off

1000 M

Full

10G Optical

Off

10,000 M

Full