Release Notes for Cisco Catalyst 9500 Series Switches, Cisco IOS XE Gibraltar 16.10.x
Introduction
Cisco Catalyst 9500 Series Switches and Cisco Catalyst 9500 Series Switches - High Performance are Cisco's lead, fixed core and aggregation enterprise switching platforms. They have been purpose-built to address emerging trends of Security, IoT, Mobility, and Cloud.
They deliver complete convergence in terms of ASIC architecture with Unified Access Data Plane (UADP) 2.0 on Cisco Catalyst 9500 Series Switches and UADP 3.0 on Cisco Catalyst 9500 Series Switches - High Performance. The platform runs an Open Cisco IOS XE that supports model driven programmability. This series forms the foundational building block for SD-Access, which is Cisco’s lead enterprise architecture.
Note |
With the introduction of the High Performance models in the series, there may be differences in the supported and unsupported features, limitations, and caveats that apply to the Cisco Catalyst 9500 Series Switches and Cisco Catalyst 9500 Series Switches - High Performance models. Throughout this release note document, any such differences are expressly called out. If they are not, the information applies to all models in the series. |
Whats New in Cisco IOS XE Gibraltar 16.10.1
Hardware Features in Cisco IOS XE Gibraltar 16.10.1
-
Hardware Features Introduced on Cisco Catalyst 9500 Series Switches
-
Hardware Features Introduced on Cisco Catalyst 9500 Series Switches-High Performance
Hardware Features Introduced on Cisco Catalyst 9500 Series Switches
(C9500-12Q, C9500-16X, C9500-24Q, C9500-40X)
Feature Name |
Description and Documentation Link |
---|---|
Cisco 10GBASE SFP+ Modules
|
For information about the module, see the Cisco 10GBASE SFP+ Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix. |
Cisco 40GBASE QSFP Modules |
Supported transceiver module product number—QSFP-40G-CSR-S For information about the cable, see the Cisco 40GBASE QSFP Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix. |
Support for Breakout Cables
|
For information about these breakout cables, see Cisco 40GBASE QSFP Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix.
For related software configuration information, see Interface and Hardware Components → Configuring Interface Characteristics. |
All interfaces on C9500-24Q are capable of breakout and support dual mode QSFP breakout configuration. |
Starting with this release, all twenty-four ports of the C9500-24Q switch model support breakout cables. (Only the first twelve ports were supported in an earlier release).
For related software configuration information, see Interface and Hardware Components → Configuring Interface Characteristics. |
Hardware Features Introduced on Cisco Catalyst 9500 Series Switches-High Performance
(C9500-24Y4C, C9500-32C, C9500-32QC, and C9500-48Y4C)
Feature Name |
Description and Documentation Link |
||
---|---|---|---|
Cisco 40GBASE QSFP Modules |
Supported transceiver module product number—QSFP-40G-CSR-S For information about the cable, see the Cisco 40GBASE QSFP Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix. |
||
Cisco QSFP 40-Gigabit Ethernet to SFP+ 10G Adapter Module (Cisco QSA Module)—CVR-QSFP-SFP10G |
This module offers 10-GigabitEthernet and 1-GigabitEthernet connectivity for Quad Small Form-Factor Pluggable (QSFP)-only platforms by converting a QSFP port into an SFP or SFP+ port.
For information about the adapter, see the Cisco QSFP to SFP or SFP+ Adapter Module Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix |
||
Cisco DWDM-SFP10G-XX.XX modules on CVR-QSFP-SFP10G |
For information about the transceiver module, see Cisco 10GBASE Dense Wavelength-Division Multiplexing SFP+ Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix. |
||
Support for Breakout Cables
|
For information about these breakout cables, see Cisco 40GBASE QSFP Modules Data Sheet and Cisco 100GBASE QSFP-100G Modules Data Sheet. For information about device compatibility, see the Transceiver Module Group (TMG) Compatibility Matrix.
For related software configuration information, see Interface and Hardware Components → Configuring Interface Characteristics. |
Software Features in Cisco IOS XE Gibraltar 16.10.1
-
Software Features Introduced on Cisco Catalyst 9500 Series Switches
-
Software Features Introduced on Cisco Catalyst 9500 Series Switches-High Performance
Software Features Introduced on All Models
Feature Name |
Description, Documentation Link and License Level Information |
---|---|
Border Gateway Protocol (BGP):
|
These BGP features were introduced in this release:
(Network Advantage) |
Intermediate System to Intermediate System (IS-IS) Generic Cryptographic Authentication |
IS-IS now supports Secure Hash Algorithm (SHA) authentication (SHA-1, SHA-256, SHA-384, and SHA-512), which is more secure than MD5 authentication or clear text authentication.
See Routing → Configuring IS-IS Routing.
(Network Advantage) |
Media Access Control Security (MACsec): MACsec connection across intermediate switches |
MACsec connections between end devices in a WAN MACsec deployment with intermediate switches as Catalyst 9000 Series Switches is supported.
See Security → MACsec Encryption.
128-bit—(Network Essentials and Network Advantage) 256-bit—(Network Advantage) |
Secure Shell File Transfer Protocol (SFTP) |
Secure Shell (SSH) now includes support for SSH File Transfer Protocol (SFTP), a new standard file transfer protocol introduced in SSHv2. This feature provides a secure and authenticated method for copying device configuration or device image files.
See Security → Configuring SSH File Transfer Protocol.
(Network Essentials and Network Advantage) |
Programmability
|
These programmability features were introduced in the release:
See → Programmability Configuration Guide, Cisco IOS XE Gibraltar 16.10.x. |
New on the Web UI |
|
Serviceability |
|
See → Command Reference, Cisco IOS XE Fuji 16.10.x (Catalyst 9500 Switches). |
|
debug commands |
The debug platform software fed switch active punt packet-capture command was introduced. It enables debugging of packets during high CPU utilization. |
show logging commands |
|
show processes commands |
The show processes platform , show processes cpu platform , and show processes cpu platform history commands outputs were modified. The |
show processes memory platform command |
|
show tech-support |
|
Software Features Introduced on Cisco Catalyst 9500 Series Switches
(C9500-12Q, C9500-16X, C9500-24Q, C9500-40X)
Feature Name |
Description, Documentation Link and License Level Information |
---|---|
Graceful Insertion and Removal (GIR) Support for BGP |
GIR is now supported for the BGP protocol.
See High Availability → Configuring Graceful Insertion and Removal.
(Network Advantage) |
Password Authentication on USB 3.0 SSD |
Enables you to configure security on a USB 3.0 SSD in order to protect the drive from unauthorized access and associated risks.
See Interface and Hardware Components → Configuring USB 3.0 SSD.
(Network Essentials and Network Advantage) |
Security Enhanced (SE) Linux Permissive Mode |
Makes it possible for the practical implementation of “principle of least privilege” by enforcing Mandatory Access Control (MAC) on the IOS-XE platform. SELinux provides the capability to define policies to control the access from an application process to any resource object, thereby allowing for the clear definition and confinement of process behavior. In this introductory release for the feature, operation in a permissive mode is available - with the intent of confining specific components (process or application) of the IOS-XE platform. In the permissive mode, access violation events are detected and system logs are generated, but the event or operation itself is not blocked. The solution operates mainly in an access violation detection mode. No user configuration is required for the feature.
See Interface and Hardware Commands → show platform software audit.
(Network Essentials and Network Advantage) |
Serviceability |
|
See → Command Reference, Cisco IOS XE Fuji 16.10.x (Catalyst 9500 Switches). |
|
debug commands |
|
set platform commands |
|
show ip bgp and show ip bgp neighbor commands |
|
show platform commands |
|
show romvar command |
The show romvar command was introduced. It displays all the ROMMON environment variables. |
show tech-support |
|
Software Features Introduced on Cisco Catalyst 9500 Series Switches-High Performance
(C9500-24Y4C, C9500-32C, C9500-32QC, and C9500-48Y4C)
Feature Name |
Description, Documentation Link and License Level Information |
---|---|
Breakout Support |
Breakout cables enable a single 40G QSFP+ interface to be split into four 10G SFP+ interfaces and a single 100G QSFP28 interface into four 25G SFP28 interfaces. This feature is supported only on the C9500-32C model of the High Performance series . For information about the required software configuration and limitations, see the software configuration guide.
See Interface and Hardware → Configuring Interface Characteristics.
(Network Essentials and Network Advantage) |
Cisco StackWise Virtual |
Cisco StackWise Virtual is a network system virtualization technology that pairs two switches into one virtual switch to simplify operational efficiency with a single control and management plane. Starting with this release, the feature is supported on Cisco Catalyst 9500 Series Switches-High Performance.
See High Availability → Configuring Cisco StackWise Virtual.
(Network Advantage) |
Encapsulated Remote Switched Port Analyzer (ERSPAN)
|
ERSPAN enables you to monitor traffic on ports or VLANs and to send monitored traffic to destination ports. Starting with this release, ERSPAN timestamp and truncation support, and the mtu ERSPAN monitor source session configuration mode command are introduced.
See Network Management → Configuring ERSPAN.
(DNA Advantage) |
Layer 3 Subinterface |
Layer 3 interfaces forward IPv4 and IPv6 packets to another device using static or dynamic routing protocols. You can use Layer 3 interfaces for IP routing and inter-VLAN routing of Layer 2 traffic.
See VLAN → Configuring Layer 3 Subinterfaces.
(Network Essentials and Network Advantage) |
Virtual Extensible LAN (VXLAN) Border Gateway Protocol (BGP) Ethernet VPN (EVPN) (BGP EVPN with VxLAN) |
VXLAN is a network overlay that allows layer 2 segments to be stretched across an IP core. All the benefits of layer 3 topologies are thereby available with VXLAN. The overlay protocol is VXLAN and BGP uses EVPN as the address family for communicating end host MAC and IP addresses.
See Layer 2 → Configuring VXLAN BGP EVPN.
(Network Advantage) |
Important Notes
-
Cisco StackWise Virtual - Supported and Unsupported Features
-
Unsupported Features—Cisco Catalyst 9500 Series Switches - High Performance
Cisco StackWise Virtual - Supported and Unsupported Features
(applies only to C9500-12Q, C9500-16X, C9500-24Q, C9500-40X models)When you enable Cisco StackWise Virtual on the device
-
Layer 2, Layer 3, Security, Quality of Service, Multicast, Application, Monitoring and Management, Multiprotocol Label Switching, and High Availability are supported.
Contact the Cisco Technical Support Centre for the specific list of features that are supported under each one of these technologies.
-
Resilient Ethernet Protocol, Remote Switched Port Analyzer, and Sofware-Defined Access are NOT supported
Unsupported Features—All Models
-
Bluetooth
-
Bidirectional Protocol Independent Multicast (Bidir-PIM)
-
IPsec VPN
-
Performance Monitoring (PerfMon)
-
Virtual Routing and Forwarding (VRF)-Aware web authentication
Unsupported Features—Cisco Catalyst 9500 Series Switches
-
Border Gateway Protocol (BGP) Additional Paths
-
Cisco TrustSec Network Device Admission Control (NDAC) on Uplinks
-
Flexible NetFlow—NetFlow v5 Export Protocol, 4-byte (32-bit) AS Number Support, TrustSec NetFlow IPv4 Security Group Access Control List (SGACL) Deny and Drop Export
-
Gateway Load Balancing Protocol (GLBP)
-
Lawful Intercept (LI)
-
Network-Powered Lighting (including COAP Proxy Server, 2-event Classification, Perpetual POE, Fast PoE)
-
PIM Bidirectional Forwarding Detection (PIM BFD), PIM Snooping.
-
Quality of Service—Classification (Layer 3 Packet Length, Time-to-Live (TTL)), per queue policer support, sharped profile enablement for egress per port queues, L2 Miss, Ingress Packet FIFO (IPF)
-
Unicast over Point to Multipoint (P2MP) Generic Routing Encapsulation (GRE), Multicast over P2MP GRE.
-
VLAN Translation—One-to-One Mapping
Unsupported Features—Cisco Catalyst 9500 Series Switches - High Performance
-
Cisco Application Visibility and Control (AVC)
-
Graceful Insertion and Removal (GIR)
-
High Availability—In Service Software Upgrade (ISSU)
-
MPLS Label Distribution Protocol (MPLS LDP) VRF-Aware Static Labels
-
Next Generation Network-Based Application Recognition (NBAR) and Next Generation NBAR (NBAR2)
-
QoS Options on GRE Tunnel Interfaces
Complete List of Supported Features
For the complete list of features supported on a platform, see the Cisco Feature Navigator at https://www.cisco.com/go/cfn.
When you search for the list of features by platform select
-
CAT9500—to see all the features supported on the C9500-12Q, C9500-16X, C9500-24Q, C9500-40X models
-
CAT9500 HIGH PERFORMANCE (32C; 32QC; 48Y4C; 24Y4C)—to see all the features supported on the C9500-24Y4C, C9500-32C, C9500-32QC, and C9500-48Y4C models
Supported Hardware
Cisco Catalyst 9500 Series Switches—Model Numbers
The following table lists the supported hardware models and the default license levels they are delivered with. For more information about the available license levels, see section License Levels.
Base PIDs are the model numbers of the switch.
Bundled PIDs indicate the orderable part numbers for base PIDs that are bundled with a particular network module. Entering the show version , show module , or show inventory commands on such a switch (bundled PID), displays its base PID.
Switch Model |
Default License Level1 |
Description |
---|---|---|
Base PIDs |
||
C9500-12Q-E |
Network Essentials |
12 40-Gigabit Ethernet QSFP+ ports and two power supply slots |
C9500-12Q-A |
Network Advantage |
|
C9500-16X-E |
Network Essentials |
16 1/10-Gigabit Ethernet SFP/SFP+ ports and two power supply slots |
C9500-16X-A |
Network Advantage |
|
C9500-24Q-E |
Network Essentials |
24-Port 40-Gigabit Ethernet QSFP+ ports and two power supply slots |
C9500-24Q-A |
Network Advantage |
|
C9500-40X-E |
Network Essentials |
40 1/10-Gigabit Ethernet SFP/SFP+ ports and two power supply slots |
C9500-40X-A |
Network Advantage |
|
Bundled PIDs |
||
C9500-16X-2Q-E |
Network Essentials |
16 10-Gigabit Ethernet SFP+ port switch and a 2-Port 40-Gigabit Ethernet (QSFP) network module on uplink ports |
C9500-16X-2Q-A |
Network Advantage |
|
C9500-24X-E |
Network Essentials |
16 10-Gigabit Ethernet SFP+ port switch and an 8-Port 10-Gigabit Ethernet (SFP) network module on uplink ports |
C9500-24X-A |
Network Advantage |
|
C9500-40X-2Q-E |
Network Essentials |
40 10-Gigabit Ethernet SFP+ port switch and a 2-Port 40-Gigabit Ethernet (QSFP) network module on uplink ports |
C9500-40X-2Q-A |
Network Advantage |
|
C9500-48X-E |
Network Essentials |
40 10-Gigabit Ethernet SFP+ port switch and an 8-Port 10-Gigabit Ethernet (SFP) network module on uplink ports |
C9500-48X-A |
Network Advantage |
Switch Model |
Default License Level2 |
Description |
---|---|---|
C9500-24Y4C-E |
Network Essentials |
24 SFP28 ports that support 1/10/25-GigabitEthernet connectivity, four QSFP uplink ports that support 100/40-GigabitEthernet connectivity; two power supply slots. |
C9500-24Y4C-A |
Network Advantage |
|
C9500-32C-E |
Network Essentials |
32 QSFP28 ports that support 40/100 GigabitEthernet connectivity; two power supply slots. |
C9500-32C-A |
Network Advantage |
|
C9500-32QC-E |
Network Essentials |
32 QSFP28 ports, where you can have 24 ports that support 40-GigabitEthernet connectivity and 4 ports that support 100-GigabitEthernet connectivity, OR 32 ports that support 40-GigabitEthernet connectivity, OR 16 ports that support 100-GigabitEthernet connectivity; two power supply slots. |
C9500-32QC-A |
Network Advantage |
|
C9500-48Y4C-E |
Network Essentials |
48 SFP28 ports that support 1/10/25-GigabitEthernet connectivity; four QSFP uplink ports that supports up to 100/40-GigabitEthernet connectivity; two power supply slots. |
C9500-48Y4C-A |
Network Advantage |
Network Modules
The following table lists optional network modules for uplink ports available with some configurations .
Network Module |
Description |
---|---|
C9500-NM-8X |
Cisco Catalyst 9500 Series Network Module 8-port 1/10 Gigabit Ethernet with SFP/SFP+ Note the supported switch models (Base PIDs):
|
C9500-NM-2Q |
Cisco Catalyst 9500 Series Network Module 2-port 40 Gigabit Ethernet with QSFP+ Note the supported switch models (Base PIDs):
|
Optics Modules
Cisco Catalyst Series Switches support a wide range of optics and the list of supported optics is updated on a regular basis. Use the Transceiver Module Group (TMG) Compatibility Matrix tool, or consult the tables at this URL for the latest transceiver module compatibility information: https://www.cisco.com/en/US/products/hw/modules/ps5455/products_device_support_tables_list.html
Compatibility Matrix
The following table provides software compatibility information between Cisco Catalyst 9500 Series Switches, Cisco Identity Services Engine, Cisco Access Control Server, and Cisco Prime Infrastructure.
Catalyst 9500, 9500-High Performance and 9500X |
Cisco Identity Services Engine |
Cisco Access Control Server |
Cisco Prime Infrastructure |
---|---|---|---|
Gibraltar 16.10.1 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.8 |
2.5 2.1 |
5.4 5.5 |
PI 3.9 + PI 3.9 latest maintenance release + PI 3.9 latest device pack See Cisco Prime Infrastructure 3.9 → Downloads. |
Fuji 16.9.7 |
2.5 2.1 |
5.4 5.5 |
PI 3.9 + PI 3.9 latest maintenance release + PI 3.9 latest device pack See Cisco Prime Infrastructure 3.9 → Downloads. |
Fuji 16.9.6 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.5 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.4 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.3 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.2 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest maintenance release + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.9.1 |
2.3 Patch 1 2.4 Patch 1 |
5.4 5.5 |
PI 3.4 + PI 3.4 latest device pack See Cisco Prime Infrastructure 3.4→ Downloads. |
Fuji 16.8.1a |
2.3 Patch 1 2.4 |
5.4 5.5 |
PI 3.3 + PI 3.3 latest maintenance release + PI 3.3 latest device pack See Cisco Prime Infrastructure 3.3→ Downloads. |
Everest 16.6.4a |
2.2 2.3 |
5.4 5.5 |
PI 3.1.6 + Device Pack 13 See Cisco Prime Infrastructure 3.1 → Downloads. |
Everest 16.6.4 |
2.2 2.3 |
5.4 5.5 |
PI 3.1.6 + Device Pack 13 See Cisco Prime Infrastructure 3.1 → Downloads. |
Everest 16.6.3 |
2.2 2.3 |
5.4 5.5 |
PI 3.1.6 + Device Pack 13 See Cisco Prime Infrastructure 3.1 → Downloads |
Everest 16.6.2 |
2.2 2.3 |
5.4 5.5 |
PI 3.1.6 + Device Pack 13 See Cisco Prime Infrastructure 3.1 → Downloads |
Everest 16.6.1 |
2.2 |
5.4 5.5 |
PI 3.1.6 + Device Pack 13 See Cisco Prime Infrastructure 3.1 → Downloads |
Everest 16.5.1a |
2.1 Patch 3 |
5.4 5.5 |
- |
Web UI System Requirements
The following subsections list the hardware and software required to access the Web UI:
Minimum Hardware Requirements
Processor Speed |
DRAM |
Number of Colors |
Resolution |
Font Size |
---|---|---|---|---|
233 MHz minimum3 |
512 MB4 |
256 |
1280 x 800 or higher |
Small |
Software Requirements
Operating Systems
-
Windows 10 or later
-
Mac OS X 10.9.5 or later
Browsers
-
Google Chrome—Version 59 or later (On Windows and Mac)
-
Microsoft Edge
-
Mozilla Firefox—Version 54 or later (On Windows and Mac)
-
Safari—Version 10 or later (On Mac)
Upgrading the Switch Software
This section covers the various aspects of upgrading or downgrading the device software.
Note |
You cannot use the Web UI to install, upgrade, or downgrade device software. |
Finding the Software Version
The package files for the Cisco IOS XE software are stored on the system board flash device (flash:).
You can use the show version privileged EXEC command to see the software version that is running on your switch.
Note |
Although the show version output always shows the software image running on the switch, the model name shown at the end of this display is the factory configuration and does not change if you upgrade the software license. |
You can also use the dir filesystem: privileged EXEC command to see the directory names of other software images that you might have stored in flash memory.
Software Images
Release |
Image Type |
File Name |
---|---|---|
Cisco IOS XE Gibraltar 16.10.1 |
CAT9K_IOSXE |
cat9k_iosxe.16.10.01.SPA.bin |
Licensed Data Payload Encryption (LDPE) |
cat9k_iosxeldpe.16.10.01.SPA.bin |
Automatic Boot Loader Upgrade
When you upgrade from the existing release on your switch to a later or newer release for the first time, the boot loader may be automatically upgraded, based on the hardware version of the switch. If the boot loader is automatically upgraded, it will take effect on the next reload. If you go back to the older release after this, the boot loader is not downgraded. The updated boot loader supports all previous releases.
For subsequent Cisco IOS XE Everest 16.x.x, or Cisco IOS XE Fuji 16.x.x releases, if there is a new bootloader in that release, it may be automatically upgraded based on the hardware version of the switch when you boot up your switch with the new image for the first time.
Caution |
Do not power cycle your switch during the upgrade. |
Scenario |
Automatic Boot Loader Response |
---|---|
If you boot Cisco IOS XE Gibraltar 16.10.1 first time |
On Cisco Catalyst 9500 Series Switches, the boot loader may be upgraded to version 16.10.1r [FC1]. For example:
On Cisco Catalyst 9500 Series Switches - High Performance, the boot loader may be upgraded to version 16.10.1r [FC2]. For example:
If the automatic boot loader upgrade occurs, while booting, you will see the following on the console:
|
Software Installation Commands
Summary of Software Installation Commands Supported starting from Cisco IOS XE Everest 16.6.2 and later releases |
|
---|---|
To install and activate the specified file, and to commit changes to be persistent across reloads:
To separately install, activate, commit, cancel, or remove the installation file: |
|
add file tftp: filename |
Copies the install file package from a remote location to the device and performs a compatibility check for the platform and image versions. |
activate [ auto-abort-timer] |
Activates the file, and reloads the device. The auto-abort-timer keyword automatically rolls back image activation. |
commit |
Makes changes persistent over reloads. |
rollback to committed |
Rolls back the update to the last committed version. |
abort |
Cancels file activation, and rolls back to the version that was running before the current installation procedure started. |
remove |
Deletes all unused and inactive software installation files. |
Note |
The request platform software commands are deprecated starting from Cisco IOS XE Gibraltar 16.10.1. The commands are visible on the CLI in this release and you can configure them, but we recommend that you use the install commands to upgrade or downgrade. |
Summary of request platform software Commands
|
|||
---|---|---|---|
|
|||
clean |
Cleans unnecessary package files from media |
||
copy |
Copies package to media |
||
describe |
Describes package content |
||
expand |
Expands all-in-one package to media |
||
install |
Installs the package |
||
uninstall |
Uninstalls the package |
||
verify |
Verifies In Service Software Upgrade (ISSU) software package compatibility |
Upgrading in Install Mode
Follow these instructions to upgrade from one release to another, in install mode.
Before you begin
Note that you can use this procedure for the following upgrade scenarios:
When upgrading from ... |
Use these commands... |
To upgrade to... |
---|---|---|
Cisco IOS XE Everest 16.5.1a or Cisco IOS XE Everest 16.6.1 |
Only request platform software commands |
Cisco IOS XE Gibraltar 16.10.1 |
Cisco IOS XE Everest 16.6.2 and later |
On Cisco Catalyst 9500 Series Switches either install commands or request platform software commands On Cisco Catalyst 9500 Series Switches - High Performance5, only install commands |
The sample output in this section displays upgrade from
-
Cisco IOS XE Everest 16.5.1a to Cisco IOS XE Gibraltar 16.10.1 using request platform software commands.
-
Cisco IOS XE Everest 16.6.3 to Cisco IOS XE Gibraltar 16.10.1 using install commands.
Procedure
Step 1 |
Clean Up Ensure that you have at least 1GB of space in flash to expand a new image. Clean up old installation files in case of insufficient space.
The following sample output displays the cleaning up of unused files, by using the request platform software package clean command for upgrade scenario Cisco IOS XE Everest 16.5.1a to Cisco IOS XE Gibraltar 16.10.1.
The following sample output displays the cleaning up of unused files, by using the install remove inactive command, for upgrade scenario Cisco IOS XE Everest 16.6.3 to Cisco IOS XE Gibraltar 16.10.1:
|
||||
Step 2 |
Copy new image to flash |
||||
Step 3 |
Set boot variable |
||||
Step 4 |
Software install image to flash
The following sample output displays installation of the Cisco IOS XE Gibraltar 16.10.1 software image to flash, by using the request platform software package install command, for upgrade scenario Cisco IOS XE Everest 16.5.1a to Cisco IOS XE Gibraltar 16.10.1.
The following sample output displays installation of the Cisco IOS XE Gibraltar 16.10.1 software image to flash, by using the install add file activate commit command, for upgrade scenario Cisco IOS XE Everest 16.6.3 to Cisco IOS XE Gibraltar 16.10.1:
|
||||
Step 5 |
dir flash: After the software has been successfully installed, use this command to verify that the flash partition has ten new The following is sample output of the dir flash: command for upgrade scenario Cisco IOS XE Everest 16.5.1a to Cisco IOS XE Gibraltar 16.10.1:
The following is sample output of the dir flash: command for the Cisco IOS XE Everest 16.6.3 to Cisco IOS XE Fuji 16.9.1 upgrade scenario:
The following sample output displays the .conf files in the flash partition; note the three .conf files:
|
||||
Step 6 |
Reload |
Downgrading in Install Mode
Follow these instructions to downgrade from one release to another, in install mode. To perform a software image downgrade, you must be booted into IOS via “ boot flash:packages.conf .”
Before you begin
Note that you can use this procedure for the following downgrade scenarios:
When downgrading from ... |
Use these commands... |
To downgrade to... |
---|---|---|
Cisco IOS XE Gibraltar 16.10.1 |
On Cisco Catalyst 9500 Series Switches, either install commands or request platform software commands On Cisco Catalyst 9500 Series Switches - High Performance6, only install commands |
Cisco IOS XE Fuji 16.9.x or an earlier release. |
The sample output in this section shows downgrade from Cisco IOS XE Gibraltar 16.10.1 to Cisco IOS XE Everest 16.6.1, by using the install commands.
Important |
New switch models that are introduced in a release cannot be downgraded. The release in which a switch model is introduced is the minimum software version for that model.
|
Procedure
Step 1 |
Clean Up Ensure that you have at least 1GB of space in flash to expand a new image. Clean up old installation files in case of insufficient space.
The following sample output displays the cleaning up of Cisco IOS XE Gibraltar 16.10.1 files using the install remove inactive command:
|
||
Step 2 |
Copy new image to flash |
||
Step 3 |
Downgrade software image
The following example displays the installation of the Cisco IOS XE Everest 16.6.1 software image to flash, by using the install add file activate commit command.
|
||
Step 4 |
Reload |
Licensing
This section provides information about the licensing packages for features available on Cisco Catalyst 9000 Series Switches.
License Levels
The software features available on Cisco Catalyst 9500 Series Switches and Cisco Catalyst 9500 Series Switches - High Performance fall under these base or add-on license levels.
Base Licenses
-
Network Essentials
-
Network Advantage—Includes features available with the Network Essentials license and more.
Add-On Licenses
Add-On Licenses require a Network Essentials or Network Advantage as a pre-requisite. The features available with add-on license levels provide Cisco innovations on the switch, as well as on the Cisco Digital Network Architecture Center (Cisco DNA Center).
-
DNA Essentials
-
DNA Advantage— Includes features available with the DNA Essentials license and more.
To find information about platform support and to know which license levels a feature is available with, use Cisco Feature Navigator. To access Cisco Feature Navigator, go to https://cfnng.cisco.com. An account on cisco.com is not required.
License Types
The following license types are available:
-
Permanent—for a license level, and without an expiration date.
-
Term—for a license level, and for a three, five, or seven year period.
-
Evaluation—a license that is not registered.
License Levels - Usage Guidelines
-
Base licenses (Network Essentials and Network-Advantage) are ordered and fulfilled only with a permanent license type.
-
Add-on licenses (DNA Essentials and DNA Advantage) are ordered and fulfilled only with a term license type.
-
An add-on license level is included when you choose a network license level. If you use DNA features, renew the license before term expiry, to continue using it, or deactivate the add-on license and then reload the switch to continue operating with the base license capabilities.
-
When ordering an add-on license with a base license, note the combinations that are permitted and those that are not permitted:
Table 3. Permitted Combinations DNA Essentials
DNA Advantage
Network Essentials
Yes
No
Network Advantage
Yes7
Yes
7 You will be able to purchase this combination only at the time of the DNA license renewal and not when you purchase DNA-Essentials the first time. -
Evaluation licenses cannot be ordered. They are not tracked via Cisco Smart Software Manager and expire after a 90-day period. Evaluation licenses can be used only once on the switch and cannot be regenerated. Warning system messages about an evaluation license expiry are generated only 275 days after expiration and every week thereafter. An expired evaluation license cannot be reactivated after reload. This applies only to Smart Licensing. The notion of evaluation licenses does not apply to Smart Licensing Using Policy.
Cisco Smart Licensing
Cisco Smart Licensing is a flexible licensing model that provides you with an easier, faster, and more consistent way to purchase and manage software across the Cisco portfolio and across your organization. And it’s secure – you control what users can access. With Smart Licensing you get:
-
Easy Activation: Smart Licensing establishes a pool of software licenses that can be used across the entire organization—no more PAKs (Product Activation Keys).
-
Unified Management: My Cisco Entitlements (MCE) provides a complete view into all of your Cisco products and services in an easy-to-use portal, so you always know what you have and what you are using.
-
License Flexibility: Your software is not node-locked to your hardware, so you can easily use and transfer licenses as needed.
To use Smart Licensing, you must first set up a Smart Account on Cisco Software Central (http://software.cisco.com).
Important |
Cisco Smart Licensing is the default and the only available method to manage licenses. |
For a more detailed overview on Cisco Licensing, go to cisco.com/go/licensingguide.
Deploying Smart Licensing
The following provides a process overview of a day 0 to day N deployment directly initiated from a device that is running Cisco IOS XE Fuji 16.9.1 or later releases. Links to the configuration guide provide detailed information to help you complete each one of the smaller tasks.
Procedure
Step 1 |
Begin by establishing a connection from your network to Cisco Smart Software Manager on cisco.com. See: Connecting to CSSM |
Step 2 |
Create and activate your Smart Account, or login if you already have one. To create and activate Smart Account, go to Cisco Software Central → Create Smart Accounts. Only authorized users can activate the Smart Account. |
Step 3 |
Complete Cisco Smart Software Manager set up. |
With this,
-
The device is now in an authorized state and ready to use.
-
The licenses that you have purchased are displayed in your Smart Account.
How Upgrading or Downgrading Software Affects Smart Licensing
Starting from Cisco IOS XE Fuji 16.9.1, Smart Licensing is the default and only license management solution; all licenses are managed as Smart Licenses.
Important |
Starting from Cisco IOS XE Fuji 16.9.1, the Right-To-Use (RTU) licensing mode is deprecated, and the associated license right-to-use command is no longer available on the CLI. |
Note how upgrading to a release that supports Smart Licensing or moving to a release that does not support Smart Licensing affects licenses on a device:
-
When you upgrade from an earlier release to one that supports Smart Licensing—all existing licenses remain in evaluation mode until registered in Cisco Smart Software Manager. After registration, they are made available in your Smart Account.
-
When you downgrade to a release where Smart Licensing is not supported—all smart licenses on the device are converted to traditional licenses and all smart licensing information on the device is removed.
Using Smart Licensing on an Out-of-the-Box Device
Starting from Cisco IOS XE Fuji 16.9.1, if an out-of-the-box device has the software version factory-provisioned, all licenses on such a device remain in evaluation mode until registered in Cisco Smart Software Manager.
Scaling Guidelines
For information about feature scaling guidelines, see the Cisco Catalyst 9500 Series Switches datasheet at:
Limitations and Restrictions
With Cisco Catalyst 9500 Series Switches and Cisco Catalyst 9500 Series Switches - High Performance—If a feature is not supported on a switch model, you do not have to factor in any limitations or restrictons that may be listed here. If limitations or restrictions are listed for a feature that is supported, check if model numbers are specified, to know if they apply. If model numbers are not specified, the limitations or restrictons apply to all models in the series.
-
Auto negotiation
We recommend not changing Forward Error Correction (FEC) when auto negotiation is ON. This is applicable to 100G/40G/25G CU cables on the C9500-32C, C9500-32QC, C9500-24Y4C and C9500-48Y4C models of the series.
Auto negotiation is always ON for GLC-T and GLC-TE and cannot be disabled. This is applicable to GLC-T and GLC-TE on C9500-48Y4C and C9500-24Y4C models of the series.
-
Cisco StackWise Virtual
-
You cannot configure Cisco StackWise Virtual links on modular uplinks (C9500-NM-8X and C9500-NM-2Q).
-
On Cisco Catalyst 9500 Series Switches, you cannot use 4X10G breakout cables or the Cisco QSFP to SFP or SFP+ Adapter (QSA) module when Cisco StackWise Virtual is configured on the switch.
-
On Cisco Catalyst 9500 Series Switches - High Performance, you cannot use 4X25G and 4X10G breakout cables or the Cisco QSA module when Cisco StackWise Virtual is configured on the switch.
-
-
Cisco TrustSec restrictions—Cisco TrustSec can be configured only on physical interfaces, not on logical interfaces.
-
Control Plane Policing (CoPP)—The show run command does not display information about classes configured under
system-cpp policy
, when they are left at default values. Use the show policy-map system-cpp-policy or the show policy-map control-plane commands in privileged EXEC mode instead. -
Flexible NetFlow limitations
-
You cannot configure NetFlow export using the Ethernet Management port (GigabitEthernet0/0).
-
You can not configure a flow monitor on logical interfaces, such as switched virtual interfaces (SVIs), port-channel, loopback, tunnels.
-
You can not configure multiple flow monitors of same type (ipv4, ipv6 or datalink) on the same interface for same direction.
-
-
Hardware limitations:
-
Use the MODE button to switch-off the beacon LED.
-
All port LED behavior is undefined until interfaces are fully initialized.
-
1G with Cisco QSA Module (CVR-QSFP-SFP10G) is not supported on the uplink ports of the C9500-24Y4C and C9500-48Y4C models.
-
The following limitations apply to Cisco QSA Module (CVR-QSFP-SFP10G) when Cisco 1000Base-T Copper SFP (GLC-T) or Cisco 1G Fiber SFP Module for Multimode Fiber are plugged into the QSA module:
-
1G Fiber modules over QSA do not support autonegotiation. Auto-negotiation should be disabled on the far-end devices.
-
Although visible in the CLI, the command [no] speed nonegotiate is not supported with 1G Fiber modules over QSA.
-
Only GLC-T over QSA supports auto-negotiation.
-
GLC-T supports only port speed of 1000 Mb/s over QSA. Port speeds of 10/100-Mb/s are not supported due to hardware limitation.
-
-
When you use Cisco QSFP-4SFP10G-CUxM Direct-Attach Copper Cables, autonegotiation is enabled by default. If the other end of the line does not support autonegotation, the link does not come up.
-
Autonegotiation is not supported on HundredGigabitEthernet1/0/49 to HundredGigabitEthernet1/0/52 uplink ports of the C9500-48Y4C models, and HundredGigabitEthernet1/0/25 to HundredGigabitEthernet1/0/28 uplink ports of the C9500-24Y4C models. Disable autonegotiation on the peer device if you are using QSFP-H40G-CUxx and QSFP-H40G-ACUxx cables.
-
For QSFP-H100G-CUxx cables, the C9500-48Y4C and C9500-24Y4C models support the cables only if both sides of the connection are either C9500-48Y4C or C9500-24Y4C.
-
-
Interoperability limitations—When you use Cisco QSFP-4SFP10G-CUxM Direct-Attach Copper Cables, if one end of the 40G link is a Catalyst 9400 Series Switch and the other end is a Catalyst 9500 Series Switch, the link does not come up, or comes up on one side and stays down on the other. To avoid this interoperability issue between devices, apply the the speed nonegotiate command on the Catalyst 9500 Series Switch interface. This command disables autonegotiation and brings the link up. To restore autonegotiation, use the no speed nonegotiation command.
-
In-Service Software Upgrade (ISSU)—On Cisco Catalyst 9500 Series Switches (C9500-12Q, C9500-16X, C9500-24Q, C9500-40X), ISSU from Cisco IOS XE Fuji 16.9.x to Cisco IOS XE Gibraltar 16.10.x is not supported.
-
QoS restrictions
-
When configuring QoS queuing policy, the sum of the queuing buffer should not exceed 100%.
-
For QoS policies, only switched virtual interfaces (SVI) are supported for logical interfaces.
-
QoS policies are not supported for port-channel interfaces, tunnel interfaces, and other logical interfaces.
-
-
Secure Shell (SSH)
-
Use SSH Version 2. SSH Version 1 is not supported.
-
When the device is running SCP and SSH cryptographic operations, expect high CPU until the SCP read process is completed. SCP supports file transfers between hosts on a network and uses SSH for the transfer.
Since SCP and SSH operations are currently not supported on the hardware crypto engine, running encryption and decryption process in software causes high CPU. The SCP and SSH processes can show as much as 40 or 50 percent CPU usage, but they do not cause the device to shutdown.
-
-
USB Authentication—When you connect a Cisco USB drive to the switch, the switch tries to authenticate the drive against an existing encrypted preshared key. Since the USB drive does not send a key for authentication, the following message is displayed on the console when you enter password encryption aes command:
Device(config)# password encryption aes Master key change notification called without new or old key
-
VLAN Restriction—It is advisable to have well-defined segregation while defining data and voice domain during switch configuration and to maintain a data VLAN different from voice VLAN across the switch stack. If the same VLAN is configured for data and voice domains on an interface, the resulting high CPU utilization might affect the device.
-
Wired Application Visibility and Control limitations:
-
NBAR2 (QoS and Protocol-discovery) configuration is allowed only on wired physical ports. It is not supported on virtual interfaces, for example, VLAN, port channel nor other logical interfaces.
-
NBAR2 based match criteria ‘match protocol’ is allowed only with marking or policing actions. NBAR2 match criteria will not be allowed in a policy that has queuing features configured.
-
‘Match Protocol’: up to 256 concurrent different protocols in all policies.
-
NBAR2 and Legacy NetFlow cannot be configured together at the same time on the same interface. However, NBAR2 and wired AVC Flexible NetFlow can be configured together on the same interface.
-
Only IPv4 unicast (TCP/UDP) is supported.
-
AVC is not supported on management port (Gig 0/0)
-
NBAR2 attachment should be done only on physical access ports. Uplink can be attached as long as it is a single uplink and is not part of a port channel.
-
Performance—Each switch member is able to handle 500 connections per second (CPS) at less than 50% CPU utilization. Above this rate, AVC service is not guaranteed.
-
Scale—Able to handle up to 5000 bi-directional flows per 24 access ports and 10000 bi-directional flows per 48 access ports.
-
-
YANG data modeling limitation—A maximum of 20 simultaneous NETCONF sessions are supported.
-
Secure Password Migration—Type 6 encrypted password is supported from Cisco IOS XE Gibraltar 16.10.1 and later releases. Autoconversion to password type 6 is supported from Cisco IOS XE Gibraltar 16.11.1 and later releases.
If the startup configuration has a type 6 password and you downgrade to a version in which type 6 password is not supported, you can/may be locked out of the device.
-
The File System Check (fsck) utility is not supported in install mode.
Caveats
Caveats describe unexpected behavior in Cisco IOS-XE releases. Caveats listed as open in a prior release are carried forward to the next release as either open or resolved.
Cisco Bug Search Tool
The Cisco Bug Search Tool (BST) allows partners and customers to search for software bugs based on product, release, and keyword, and aggregates key data such as bug details, product, and version. The BST is designed to improve the effectiveness in network risk management and device troubleshooting. The tool has a provision to filter bugs based on credentials to provide external and internal bug views for the search input.
To view the details of a caveat, click on the identifier.
Open Caveats in Cisco IOS XE Gibraltar 16.10.x
Identifier |
Applicable Models |
Description |
---|---|---|
All models |
Smart licensing(SL)Actions done soon after system bootup can cause SL to get stuck, requiring reload |
|
All models |
ISSU / SSO convergence time for EoMPLS is high |
|
Catalyst 9500 |
SF: ERSPAN fragments the packet and truncated remaining portion is not captured |
|
Catalyst 9500 |
SNMP timeout when querying entSensorValueEntry |
|
Catalyst 9500 |
After reloading gPTP/AVB ports stuck @ disabled (not dot1as capable) |
|
Catalyst 9500 |
WCCP redirection to proxy server breaks in certain scenarios. |
|
Catalyst 9500 |
usbflash1 entries are displayed multiple times in sh inventory o/p after multiple SSO |
|
Catalyst 9500 |
Yang Get-config shows all the pwd configured on switch instead it should show only last updated pwd |
|
Catalyst 9500 |
9500-40x :phyloop back fails for forty gig ports |
|
Catalyst 9500 |
Standby member of stackwise-virtual crashes after removing allowed VLAN on trunk interfaces |
|
Catalyst 9500 |
IP Source Guard blocks traffic after host IP renewal |
|
Catalyst 9500 |
Configure for usb on the switch are gone after renumber the switch |
|
Catalyst 9500 High Performance |
C9500-48Y4C: TestPhyLoopback showing Untested for some 1G interfaces |
|
Catalyst 9500 High Performance |
C9500-24Y4C/48Y4C :FEC CL91 config gets removed after upgrading to 16.9.1/16.10.1 & link goes down |
|
Catalyst 9500 High Performance |
show cli display incorrect BW for 4SFP10G interface |
|
Catalyst 9500 High Performance |
9500-32C Breakout P&S: Programming failure on set of interfaces post reload |
|
Catalyst 9500 High Performance |
9500-32C Breakout P&S: scaled ACL remains ERRORed out with ACL removal |
Resolved Caveats in Cisco IOS XE Gibraltar 16.10.x
Caveat ID Number |
Applicable Models |
Description |
---|---|---|
All Models |
Everest 16.6.2 // FMAN FP Fails to create objects for some prefixes |
|
All Models |
Output drops counter mismatch after applied "qos queue-softmax-multiplier 1200" |
|
All Models |
Memory leak in alloc_repexp_entry caused by alloc_ril_index failure |
|
All Models |
in MPLS VPNv6 scenario, egress PE device does not generate ICMPv6 Too Big message |
|
Catalyst 9500 |
StackWise Virtual not forwarding IGMP traffic over the standby switch. |
|
Catalyst 9500 |
Linux IOSD crash with sh vtp counters cmd |
|
Catalyst 9500 |
Stack-merge on Stby and CONN_ERR_CONN_TIMEOUT_ERR on Active with multiple SWO |
|
Catalyst 9500 |
COPP: The default and set rate are different for COPP queues |
|
Catalyst 9500 |
SPAN Filter Drops All Traffic |
|
Catalyst 9500 |
C9x00 crashed with multicast memory corruption. |
|
Catalyst 9500 |
WCCP redirection to proxy server breaks in certain scenarios. |
|
Catalyst 9500 |
16.6.3: Access Tunnel Create Interface code is considered to be update request in FMAN_FP |
|
Catalyst 9500 |
FED crash at expired "FED MAC AGING TIMER" or "unknown" timer without a stack trace. |
|
Catalyst 9500 |
[SVL] Traffic is not forward out on standby switch over SVL after SSO |
|
Catalyst 9500 |
WDAVC: FNF doesn't work in some stack scenarios. |
|
Catalyst 9500 |
ECR Installation fails and Pending-Acknowledgement, Pending-Issue counters go up |
|
Catalyst 9500 |
Cat9x00: IPv6 SPAN filter still applied in hardware when removing entire monitor session |
|
Catalyst 9500 |
FED logs overrun 20,000 times with same trace |
|
Catalyst 9500 |
Show version cli shows invalid USB-SSD disk size on a CAT9k switch |
|
Catalyst 9500 |
Standby reloads and crashed @fnf_ios_config_dist_validate_sel_process_add |
|
Catalyst 9500 High Performance |
Autoneg support for 100G/40G/25G Cu xcvr |
|
Catalyst 9500 High Performance |
Autoneg not supported on C9500-48Y4C/C9500-24Y4C uplink ports and it is disabled by default |
|
Catalyst 9500 High Performance |
C9500-24Y4C:"speed 10000" config is rejected on C9500-24Y4C bootup for SFP-10/25GBase-CSR |
|
Catalyst 9500 High Performance |
Transceiver is removed and inserted syslog when configured 10G mode for SFP-10/25GBase-CSR |
|
Catalyst 9500 High Performance |
16.10.1: Disable FEC by default for 100G LR4 |
|
Catalyst 9500 High Performance |
1G SFP do not link up when connected to C9500-24Y4C/C9500-48Y4C |
Troubleshooting
For the most up-to-date, detailed troubleshooting information, see the Cisco TAC website at this URL:
https://www.cisco.com/en/US/support/index.html
Go to Product Support and select your product from the list or enter the name of your product. Look under Troubleshoot and Alerts, to find information for the problem that you are experiencing.
Related Documentation
Information about Cisco IOS XE at this URL: https://www.cisco.com/c/en/us/products/ios-nx-os-software/ios-xe/index.html
All support documentation for Cisco Catalyst 9500 Series Switches is at this URL: https://www.cisco.com/c/en/us/support/switches/catalyst-9500-series-switches/tsd-products-support-series-home.html
Cisco Validated Designs documents at this URL: https://www.cisco.com/go/designzone
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: https://cfnng.cisco.com/mibs
Communications, Services, and Additional Information
-
To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.
-
To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.
-
To submit a service request, visit Cisco Support.
-
To discover and browse secure, validated enterprise-class apps, products, solutions and services, visit Cisco Marketplace.
-
To obtain general networking, training, and certification titles, visit Cisco Press.
-
To find warranty information for a specific product or product family, access Cisco Warranty Finder.