PDF(322.2 KB) View with Adobe Reader on a variety of devices
Updated:May 17, 2023
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco MDS 9000 Series EPLD Release Notes, Release 9.3(2a)
First Published: May 17, 2023
Note Release notes are sometimes updated with new information. Refer to the following website for the most recent version of the Cisco MDS 9000 Series Release Notes: http://www.cisco.com/c/en/us/support/storage-networking/mds-9000-nx-os-san-os-software/products-release-notes-list.html
Switches and directors in the Cisco MDS 9000 Series contain several electrical programmable logical devices (EPLDs) that provide hardware functionalities in all the modules. EPLD upgrades are periodically provided to include enhanced hardware functionality or to resolve known issues.
EPLD bundles are released as part of a Cisco MDS NX-OS release. Therefore, the EPLD bundles have a version number that matches the Cisco MDS NX-OS release they are part of.
An EPLD bundle is a package containing updates for multiple EPLDs. Each EPLD update has its own version number, which is independent of the Cisco MDS NX-OS release. As EPLD changes are infrequent, an EPLD bundle may contain new updates for only some EPLDs. The remaining EPLD updates will be the same version as the previous EPLD bundle.
The version of the EPLD bundle must match the version of Cisco MDS NX-OS release that is running when the EPLD upgrades are installed. This requirement only applies during EPLD code upgrade or downgrade. Cisco MDS NX-OS can be subsequently upgraded or downgraded without changing the EPLD versions. Table 1 shows the EPLD bundles that are compatible with specific NX-OS releases.
Table 1 Release Compatibility Matrix
NX-OS Release
EPLD Bundle
NX-OS 9.3(2a)
m9000-pkg1-9.3.2a.epld
m9000-pkg2-9.3.2a.epld
m9000-pkg3-9.3.2a.epld
Table 2 lists the Cisco MDS 9000 components and the EPLD bundle versions that are supported for the components.
1.Although the show version epld command displays Cisco MDS 9132T, MDS 9148T, and MDS 9396T platforms as supported in this bundle, they are not supported. Instead, they are supported in the m9000-pk3 bundle as indicated in this table.
Guidelines and Limitations
When you upgrade or downgrade the EPLDs, observe the following guidelines and limitations:
You can upgrade each module only when it is online. The EPLD upgrade is only disruptive to the module being upgraded.
If you interrupt an EPLD upgrade or downgrade, the module must be upgraded again.
In Cisco MDS 9000 Director Switches, EPLD upgrade or downgrade can only be executed from the active supervisor module. To upgrade the supervisor EPLDs nondisruptively, upgrade the standby supervisor and then switchover. After the new standby supervisor is online, its EPLDs can be upgraded.
In Cisco MDS 9000 Series Fabric Switches, be sure to specify 1 as the module number. The switch must be power cycled for the EPLDs to start running the new code.
Determining EPLD Versions
You can determine the EPLD versions currently installed in the hardware and also in EPLD images by using CLI commands. This section includes the following topics:
Use the show version module slot epld command to view all current EPLD versions on a specific module.
Example 1 Displaying Current EPLD Versions for a Module
switch# show version module 1 epld
EPLD Device Version
---------------------------------------
Power Manager SPI 0.002
IO SPI 0.038
SFP SPI 0.005
Fan Module EPLD Versions
Use the show version fan slot epld command to view all current EPLD versions on a specific fan module. The following command output shows the currently installed EPLD versions on a fan module.
Example 2 Displaying Current EPLD Versions for a Fan Module
switch# show version fan 1 epld
EPLD Device Version
---------------------------------------
Fan Controller (1) 0.006
Fan Controller (2) 0.006
Fabric Module EPLD Versions
Use the show version xbar slot epld command to view all current EPLD versions on a specific fabric module. The following command output shows the currently installed EPLD versions on a fabric module.
Example 3 Displaying Current EPLD Versions for a Fabric Module
switch# show version xbar 2 epld
EPLD Device Version
---------------------------------------
Power Manager 0.008
Displaying EPLD Versions in an EPLD Bundle
Use the show version epld uri command to view all the updates contained in an EPLD package. The following example shows the EPLD versions contained in an EPLD bundle.
Example 4 Displaying EPLD Versions in an EPLD Bundle
switch# show version epld m9000-pkg3.9.3.2a.epld
Retrieving EPLD versions... Please wait.
EPLD image file 9.3.2a built on Fri Dec 16 09:46:41 2022
8/16/32/64G 1 RU Fabric Switch DS-C9148V-K9 MI IO SPI 0.012
8/16/32/64G 1 RU Fabric Switch DS-C9124V-K9 I O SPI 2 0.014
8/16/32/64G 1 RU Fabric Switch DS-C9124V-K9 MI IO SPI 0.012
switch # show version module 1 epld
EPLD Device Version
MI IO SPI 0.012
IO SPI 2 0.014
Installing EPLD Updates
Supervisors, switching, fabric, and fan modules may be upgraded in a switch. For Director switches, modules can be upgraded together or individually. For Fabric switches, modules are upgraded individually. Fabric switches do not require fabric and fan modules to be upgraded.
The modules to be upgraded are specified by the user. If the module number that is specified in the command is not present, the update is aborted. Otherwise, a warning and a prompt to continue is printed. If the user proceeds, the status of each specified module is printed followed by a table of installed and new EPLD versions. If no modules require upgrading, the command exits. If any module EPLD version is different and requires upgrading, the user is prompted to continue. All EPLDs are updated on the first specified module. The update process may take several minutes. After the update, the module is power cycled. For switching modules, this power cycle disrupts traffic on all ports of the module. If the new EPLD version is the same as the installed version or the module is present but not online, no action is taken for that module. If more than one module is specified, the download and power cycle process is repeated for the next module.
Installing EPLD Updates on All Modules in a Director Switch
To update all EPLDs sequentially with a single command, use the install all epld command with the module all fan-module all xbar all options. After each module is upgraded, it is power cycled to load the EPLD update. Switching module power cycles are disruptive to the traffic passing through them. If the active supervisor requires upgrading, it will be updated last and a supervisor switchover executed. Fan modules do not require to be power cycled.
Installing a Director Switch Supervisor Module EPLD Update
To update the EPLDs on supervisor modules of Director Switches in a nondisruptive manner, follow these steps:
Step 1 Update the EPLD on the standby supervisor module. From the active supervisor module, enter the install all epld CLI command, specifying the current standby supervisor module number.
After the EPLD update is complete, the standby supervisor module will be power cycled.
Step 2 After the standby supervisor module reaches 'ha-standby' state, perform a switchover and wait until the new standby supervisor module reaches 'ha-standby' state.
Step 3 From the active supervisor module, repeat steps 1–3.
Module 6 : Power Manager SPI [Programming ] : 100.00% (6020818 of 6020818 total bytes)
Module 6 Upgrade Done.
Waiting for Module 6 to come online.
Module 6 EPLD upgrade is successful.
EPLD Upgrade Completed.
Module Type Upgrade-Result
------ ---- --------------
6 SUP Success
Installing a Switching Module EPLD Update
For Director Switches, use the install all epld uri parallel module slot command to update the EPLDs on an individual module. Use the module all option to update the EPLDs of both supervisors and all switching modules.
Example 6 Updating Module EPLDs on a Director Switch
switch# install all epld bootflash:m9000-pkg2.9.3.2a.epld parallel module 1
WARNING!!!: Executing the "install all epld" command
may result in multiple modules going offline and
affect redundant links.
For EPLD upgrade best practices, please refer below link:
Note An EPLD update of the supervisor module of Fabric Switches (Cisco MDS 9100, Cisco MDS 9200, and Cisco MDS 9300 Series switches) is disruptive since there is no redundant supervisor to take over while the update is in progress. All traffic through the system is stopped while updating and the switch is power cycled after the upgrade has completed. The update may take up to 30 minutes to complete. The following message is displayed: Data traffic on the switch will be affected!! The switch will reload after the upgrade process. Do you want to continue (y/n) ?
Module 1 : IO SPI [Programming ] : 100.00% ( 12970 of 12970 total bytes)
Module 1 : IO SPI 2 [Programming ] : 100.00% ( 3137 of 3137 total bytes)
Waiting for Module to come online.
Module 1 EPLD upgrade is successful.
Reconfiguring Active Supervisor EPLDs.
The Supervisor will reset.
Module 1 : IO SPI 2 [Programming ] : 0.70% ( 22 of 3137 total bytes)
Module 1 EPLD upgrade is successful.
Installing a Fan Module EPLD Update
Use the install all epld uri parallel fan-module slot command to upgrade the EPLDs on the fan modules. The EPLD update for a fan module is nondisruptive and a power cycle is not required after the update.
Example 8 Upgrading Fan Module EPLDs on a Cisco MDS 9700 Series Switch
switch# install all epld bootflash:m9000-pkg2.9.3.2a.epld parallel fan-module 1
WARNING!!!: Executing the "install all epld" command
may result in multiple modules going offline and
affect redundant links.
It is strongly recommended to use one of the following
when EPLD upgrade is attempted on a system carrying
production traffic.or Module EPLDs".
1) "install module <mod#> epld"
2) "install all epld <uri> parallel module <mod#>"
where <mod#> is on a single module
For EPLD upgrade best practices, please refer to the link-
Fan 1 (1 of 2) : Fan Controller [Verifying ] : 100.00% ( 135658 of 135658 total bytes)
Fan 1 (2 of 2) : Fan Controller [Verifying ] : 100.00% ( 135658 of 135658 total bytes)
Waiting for Module to come online.
Fan Module 1 EPLD upgrade is successful.
Installing a Fabric Module EPLD Update
The Cisco MDS 9700 Series switches have dedicated fabric modules. These modules contain EPLDs, which can be upgraded as described in this section. All other Cisco MDS switches do not have these modules, so this process is not applicable for them.
For Cisco MDS 9700 Series switches, use the install all epld uri parallel xbar-module slot command to update the EPLDs on the fabric modules. This process power cycles the updated module. To ensure that the data traffic performance is not affected while the module is power cycled, check the fabric bandwidth utilization by using the show hardware fabric-utilization detail command. If there is adequate reserve fabric bandwidth available before the update starts, then the update will be nondisruptive.
Example 9 Upgrading Fabric Module EPLDs for a Cisco MDS 9700 Series Switch
switch# install all epld bootflash:m9000-pkg2.9.3.2a.epld parallel xbar-module 1
WARNING!!!: Executing the "install all epld" command
may result in multiple modules going offline and
affect redundant links.
It is strongly recommended to use one of the following
when EPLD upgrade is attempted on a system carrying
production traffic.
1) "install module <mod#> epld"
2) "install all epld <uri> parallel module <mod#>"
where <mod#> is on a single module
For EPLD upgrade best practices, please refer to the link-
EPLD Versions in Cisco MDS 9000 EPLD Bundle for Release 9.3(2a)
Each EPLD bundle that you can download from http://www.cisco.com is a bundle of EPLD upgrades. Table 3 lists the EPLD versions for Cisco MDS 9000 series platforms for Cisco MDS NX-OS Release 9.3(2).
Table 3 EPLD Update Versions in Cisco MDS 9000 EPLD Bundle for Release 9.3(2a)
Module Type
Model Number
Releases
EPLD Device
Applicable Models
9.3(2a)
Fan
Fan Controller (1)
Fan Controller (2)
DS-C9718-FAN
0.006
Fan
Fan Controller (1)
Fan Controller (2)
DS-C9710-FAN
0.006
Fan
Fan Controller (1)
Fan Controller (2)
DS-C9706-FAN
0.006
Fabric Module 1
Power Manager
DS-X9718-FAB1
1.002
DS-X9710-FAB1
1.003
DS-X9706-FAB1
1.002
Fabric Module 3
Power Manager
DS-X9706-FAB-3
0.010
DS-X9710-FAB-3
0.008
DS-X9718-FAB-3
0.007
Supervisor Module 3
Power Manager SPI
DS-X97-SF1-K9
22.000
DS-X97-SF1E-K9
22.000
Supervisor Module 4
Power Manager SPI
DS-X97-SF4-K9
23.000
10-Gbps FCoE Module
Power Manager
DS-X9848-480K9
0.006
IO
DS-X9848-480K9
0.005
40-Gbps FCoE Module
Power Manager SPI
DS-X9824-960K9
1.005
IO SPI 2
DS-X9824-960K9
0.028
IO SPI
DS-X9824-960K9
0.031
16-Gbps Advanced Fibre Channel Module
Power Manager
DS-X9448-768K9
10.000
IO
DS-X9448-768K9
15.000
96-Port 2/4/8/16-Gbps Fabric Switch
IO SPI 2
DS-C9396S-K9
1.002
IO SPI
DS-C9396S-K9
1.003
48-Port 2/4/8/16-Gbps Fabric Switch
Power Manager
DS-C9148S-K9
0x1f
40-Port 2/4/8/16-Gbps Fabric Switch
Power Manager
DS-C9250I-K9
0x1a
DB Power Manager
DS-C9250I-K9
0x0b
32-Gbps Advanced Fibre Channel Module
Power Manager SPI
DS-X9648-1536K9
0.002
SFP SPI
DS-X9648-1536K9
0.005
IO SPI
DS-X9648-1536K9
2.000
24/10-Port SAN Extension Module
Power Manager SPI
DS-X9334-K9
1.001
IO SPI
DS-X9334-K9
2.000
32-Port 4/8/16/32-Gbps 1-RU Fabric Switch
IO SPI 2
DS-C9132T
0.024
MI IO SPI
DS-C9132T
0.017
LEM IO SPI
DS-C9132T
0.016
96-Port 4/8/16/32-Gbps 2-RU Fabric Switch
SFP SPI
DS-C9396T-K9
0.007
IO SPI 2
DS-C9396T-K9
0.013
MI IO SPI
DS-C9396T-K9
0.006
LEM-1 SPI
DS-C9396T-K9
0.016
LEM-2 SPI
DS-C9396T-K9
0.016
LEM-3 SPI
DS-C9396T-K9
0.016
48-Port 4/8/16/32-Gbps 1-RU Fabric Switch
SFP SPI
DS-C9148T-K9
0.007
IO SPI 2
DS-C9148T-K9
0.013
MI IO SPI
DS-C9148T-K9
0.006
24-Port 8/16/32/64-Gbps 1-RU Fabric Switch
MI IO SPI
DS-C9124V-K9-SUP
0.012
IO SPI 2
DS-C9124V-K9-SUP
0.014
48-Port 8/16/32/64-Gbps 1-RU Fabric Switch
MI IO SPI
DS-C9148V-K9-SUP
0.012
IO SPI 2
DS-C9148V-K9-SUP
0.014
4/8/16/32-Gbps 1-RU Fabric Switch
IO SPI 2
DS-C9220I-K9
0.024
MI IO SPI
DS-C9220I-K9
0.027
AKFPGA SPI
DS-C9220I-K9
1.000
64-Gbps Advanced Fibre Channel Module
SFP SPI
DS-X9748-3072K9
0.008
IO SPI
DS-X9748-3072K9
0.029
Note The values that are provided in Table 3 are in hexadecimal format as seen on the device.
Related Documentation
The documentation set for the Cisco MDS 9000 Series includes the following documents. To find a document online, use the Cisco MDS NX-OS Documentation Locater at:
Obtaining Documentation, Obtaining Support, and Security Guidelines
For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html
This document is to be along with the documents listed in the “Related Documentation” section.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.