Upgrading Field-Programmable Device
“
Product Information
Specifications:
- Product Name: Field-Programmable Device (FPD)
- Memory: Non-volatile, re-programmable memory
- Functionality: Defines internal wiring and functionality
- Upgrade Method: Manual and Automatic
Product Usage Instructions
Manual FPD Upgrade:
To manually upgrade the FPD, follow these steps:
- Use the command:
upgrade hw-module fpd - All cards or all FPGA in a card can be upgraded.
- If reload is required to activate FPD, ensure the upgrade is
complete. - Line-cards, fabric cards, RP cards, Interface modules (IMs),
and RSPs can’t be reloaded during the FPD upgrade process.
Automatic FPD Upgrade:
To enable automatic FPD upgrade:
- Ensure FPD auto-upgrade is enabled (default setting).
- To disable automatic upgrade, use the command:
fpd
auto-upgrade disable
Notes:
- The force option can be used cautiously to recover from a
failed upgrade. - After upgrading, if the image is rolled back, the FPD version
is not downgraded.
Frequently Asked Questions (FAQ)
Q: What is an FPD image package used for?
A: An FPD image package is used to upgrade FPD images.
Q: How can I check the status of an FPD upgrade?
A: Use the command: show hw-module fpd to check the
upgrade status.
“`
Upgrading Field-Programmable Device
An FPD is a field programmable logic device which contains non-volatile, re-programmable memory to define its internal wiring and functionality. The contents of this non-volatile memory are called the FPD image or FPD firmware. Over the lifespan of an FPD, FPD firmware images may need upgrades for bug fixes or functionality improvements. These upgrades are performed in the field with minimum system impact.
· Overview of FPD Image Upgrade , on page 1 · Restrictions for FPD Upgrade , on page 1 · Types of FPD Upgrade Service, on page 2 · How to Upgrade FPD Images, on page 4 · Automatic Line Card Reload on FPD Upgrade, on page 10 · Power Module Upgrades, on page 10 · Upgrading FPD for PSU, on page 12
Overview of FPD Image Upgrade
An FPD image is used to upgrade the software on an FPD. Whenever a new IOS XR version is released, the software package includes FPD images. However ,generally the FPD image isn’t automatically upgraded. You must manually upgrade the FPD image when you upgrade the Cisco IOS XR software image. FPD versions must be compatible with the Cisco IOS XR software that is running on the router; if an incompatibility exists between an FPD version and the Cisco IOS XR software, the device with the FPGA may not operate properly until the incompatibility is resolved.
Restrictions for FPD Upgrade
The Optics FPD Upgrade Service is not available using the upgrade hw-module fpd command. You can upgrade Optics FPD using the upgrade optics port filename /harddisk:/cl1.bin location command. For more information on optics FPD upgrade, see Upgrade QDD Optical Modules in Upgrade the Router Chapter in Cisco IOS XR Setup and Upgrade Guide for Cisco 8000 Series Routers.
Restrictions For Automatic FPD Upgrade The following FPDs do not support Auto FPD Upgrade:
Upgrading Field-Programmable Device 1
Types of FPD Upgrade Service
Upgrading Field-Programmable Device
· Optics FPDs · Power Module FPDs · Timing FPDs
Types of FPD Upgrade Service
An FPD image package is used to upgrade FPD images. The install activate command is used to place the FPD binary files into the expected location on the boot devices.
Supported Upgrade Methods
Method
Remarks
Manual Upgrade Auto Upgrade
Upgrade using CLI, force upgrade supported.
Upgrade using install SMU activation or during image upgrade. User can enable/disable auto upgrade feature.
Manual FPD upgrade
Manual FPD upgrade is performed using the upgrade hw-module fpd command. All cards or all FPGA in a card can be upgraded. If reload is required to activate FPD, the upgrade should be complete. Line-cards, fabric cards and RP cardsInterface module (IMs) and RSPs can’t be reloaded during the process of the FPD upgrade.
FPD upgrade is transaction-based:
· Each fpd upgrade CLI execution is one transaction.
· Only one transaction is allowed at any given time.
· One transaction may include one or many FPD upgrades.
Once the upgrade is complete, the router/the card (on which the FPD is upgraded) must be reloaded.
The force option can be used to forcibly upgrade the FPD (regardless of whether it’s required or not). It triggers all FPDs to be upgraded or downgraded. The force option can also be used to downgrade or upgrade the FPGAs even after the version check. However, the force option must be used cautiously and only to recover a component from a failed upgrade.
Note
· Sometimes, FPDs can have primary and backup images.
· The use of the force option when performing an FPD upgrade isn’t recommended except under explicit direction from Cisco engineering or TAC for a one-time purpose only.
· A new FPD upgrade should be issued only when previous FPD upgrades have been completed on the same FPD with the following syslog message:
RP/0/RP0/CPU0:May 10 10:11:44.414 UTC: fpd-serv[205]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : FPD Upgrade Completed (use “show hw-module fpd” to check upgrade status)
Upgrading Field-Programmable Device 2
Upgrading Field-Programmable Device
Automatic FPD Upgrade
Automatic FPD Upgrade
FPD auto-upgrade is enabled by default. To ensure that the FPD image is automatically upgraded, you should not disable this feature. If you need to disable the automatic upgrade of the FPD image running on the Field Replaceable Unit (FRU), you can manually apply the configuration fpd auto-upgrade disable in administration configuration mode. With FPD auto-upgrade enabled, FPD images are automatically updated in the following instances:
· Software upgrade is carried out. · Field Replaceable Unit(FRU) such as Line cards, RSPs, Fan Trays or alarm cards are added to an existing
router or reloaded.
For the automatic FPD upgrade to work on a system upgrade, the following conditions must be met: · The FPD package installation envelope (PIE) must be installed on the router. · The FPD PIE must be activated together with the new Cisco IOS XR image.
For the automatic FPD upgrade to work on a FRU Insertion or reload , the following conditions must be met: · The FPD package installation envelope (PIE) must be installed and activated on the router.
Note Although the FPD upgrade is performed during the install operation, there is no install commit performed. Therefore, once the FPD has been upgraded, if the image is rolled back to the original version, the FPD version is not downgraded to the previous version.
The automatic FPD upgrade is not performed in the following instances: · Line cards or other cards or alarm cards are added to an existing router. · A line card chassis is added to an existing router. · A non-reload software maintenance upgrade (SMU) or PIE installation is performed, even where the FPD image version changes. Since a non-reload installation is, by definition, not supposed to reload the router, and an FPD upgrade requires a router reload, the automatic FPD upgrade is repressed.
Note In all cases where the automatic FPD upgrade is not performed, you must perform a manual FPD upgrade using the upgrade hw-module fpd command.
FPD auto-upgrade can be enabled and disabled. When auto FPD is enabled, it automatically updates FPDs when a SMU or image changes, including an updated firmware revision. Use the fpd auto-upgrade command to disable or enable auto-fpd.
YANG Data Models for Auto FPD Upgrade YANG is a data modeling language that helps to create configurations, retrieve operational data and execute actions. The router acts on the data definition when these operations are requested using NETCONF RPCs. The data model handles the following types of requirements on the routers for FPD:
Upgrading Field-Programmable Device 3
How to Upgrade FPD Images
Upgrading Field-Programmable Device
Operational Data
Native Data Model
CLI Commands
Auto Upgrade: Enabling or
Cisco-IOS-XR-fpd-infra-cfg.yang
disabling of automatic upgrade of
FPD.
· fpd auto-upgrade enable · fpd auto-upgrade disable
Auto Reload: Enabling or disabling of automatic reload of FPD.
Cisco-IOS-XR-fpd-infra-cfg.yang
· fpd auto-reload enable · fpd auto-reload disable
You can access the data models from the Github repository. To learn more about the data models and put them to use, see the Programmability Configuration Guide for Cisco 8000 Series Routers.
How to Upgrade FPD Images
The main tasks of the FPD upgrade service are: · Check FPD image version to decide if a specific firmware image needs an upgrade or not. You can determine if an FPD image upgrade is needed using the show hw-module fpd command and perform the upgrade, if needed, under the following circumstances: · Migrate the software to a later Cisco IOS XR software release.
· Swap line cards from a system running a different Cisco IOS XR software release.
· Insert a new line card.
· Automatic FPD Image Upgrade (if enabled) Or Manual FPD Image Upgrade using the upgrade hw-module fpd command.
· Invoke the appropriate device driver with a name of the new image to load.
Guidelines for Upgrading FPD
The following are some of the important guidelines to be taken into consideration for upgrading FPD: · Upgrades to the Cisco IOS XR software might result in an FPD incompatibility. Ensure that you perform the FPD upgrade procedure and resolve all incompatibilities, for the cards to function properly.
· The use of the force option when performing a FPD upgrade is not recommended except under explicit direction from Cisco engineering or TAC for a one-time purpose only.
· If your card supports multiple FPD images, you can use the show fpd package admin command to determine what specific image to upgrade in the upgrade hw-module fpd command.
· A message is displayed when router modules cannot get upgraded during upgrade with location all option indicating that the FPGA is intentionally skipped during upgrade. To upgrade such FPGAs, you can use the CLI command with a particular location explicitly specified. For example, upgrade hw-module fpd all location 0/3/1.
· It is recommended to upgrade all FPGAs on a given node using the upgrade hw-module fpd all location {all | node-id} command. Do not upgrade the FPGA on a node using the upgrade hw-module fpd individual-fpd location {all | node-id} as it may cause errors in booting the card.
Upgrading Field-Programmable Device 4
Upgrading Field-Programmable Device
How to Upgrade FPD Images
Before you begin
· Before performing the manual upgrading the FPD on your router using the upgrade hw-module FPD , you must install and activate the fpd.pie and fpd.rpm package.
· The FPD upgrade procedure is performed while the card is online. At the end of the procedure the card must be reloaded before the FPD upgrade is complete. To reload the card, you can use the hw-module location location reload command in Config mode, during the next maintenance window. The upgrade procedure is not complete until the card is reloaded.
· During the FPD upgrade, you must not do the following:
· Reload, perform an online insertion and removal (OIR) of a line card (LC), or power down the chassis. Doing so may cause the node to enter an unusable state.
· Press Ctrl-C if the console appears to hang without any output. Doing so may abort the upgrade.
· If you are not sure whether a card requires an FPD upgrade, you can install the card and use the show hw-module fpd command to determine if the FPD image on the card is compatible with the currently running Cisco IOS XR software release.
Procedure
Step 1 Step 2
show hw-module fpd location {all | node-id} Example:
Router#show hw-module fpd location all
or
Router#show hw-module fpd location 0/4/cpu0
Displays the current FPD image versions for the specified card or all cards installed in the router. Use this command to determine if you must upgrade the FPD image on your card.
In the event of an FPD incompatibility with your card, you might receive the following error message:
LC/0/0/CPU0:Jul 5 03:00:18.929 UTC: optics_driver[220]: %L2-OPTICS-3-BAD_FPGA_IMAGE : Detected bad MI FPGA image programmed in MI FPGA SPI flash in 0/0/CPU0 location: Failed to validate meta data CRC
LC/0/0/CPU0:Jul 5 03:00:19.019 UTC: optics_driver[220]: %L2-OPTICS-3-BACKUP_FPGA_LOADED : Detected Backup FPGA image running on 0/0/CPU0 – primary image corrupted (@0x8c = 0x44) RRouter:Jul 5 03:00:48.987 UTC: fpd-serv[301]: %PKT_INFRA-FM-3-FAULT_MAJOR : ALARM_MAJOR :FPD-NEED-UPGRADE :DECLARE :0/0:
(Optional) show fpd package
Example: The following example shows a sample output from the show fpd package command:
Router#show fpd package
=============================== ================================================
Field Programmable Device Package
================================================
Req
SW
Min Req Min Req
Card Type
FPD Description
Reload Ver
SW Ver Board Ver
Upgrading Field-Programmable Device 5
How to Upgrade FPD Images
Upgrading Field-Programmable Device
Step 3
=================== ========================== ====== ======= ======== =========
——————————————————————————–
8201
Bios
YES
1.23
1.23
0.0
BiosGolden
YES
1.23
1.15
0.0
IoFpga
YES
1.11
1.11
0.1
IoFpgaGolden
YES
1.11
0.48
0.1
SsdIntelS3520
YES
1.21
1.21
0.0
SsdIntelS4510
YES 11.32
11.32
0.0
SsdMicron5100
YES
7.01
7.01
0.0
SsdMicron5300
YES
0.01
0.01
0.0
x86Fpga
YES
1.05
1.05
0.0
x86FpgaGolden
YES
1.05
0.48
0.0
x86TamFw
YES
5.13
5.13
0.0
x86TamFwGolden
YES
5.13
5.05
0.0
——————————————————————————–
8201-ON
Bios
YES
1.208
1.208
0.0
BiosGolden
YES
1.208
1.207
0.0
IoFpga
YES
1.11
1.11
0.1
IoFpgaGolden
YES
1.11
0.48
0.1
SsdIntelS3520
YES
1.21
1.21
0.0
SsdIntelS4510
YES 11.32
11.32
0.0
SsdMicron5100
YES
7.01
7.01
0.0
SsdMicron5300
YES
0.01
0.01
0.0
x86Fpga
YES
1.05
1.05
0.0
x86FpgaGolden
YES
1.05
0.48
0.0
x86TamFw
YES
5.13
5.13
0.0
x86TamFwGolden
YES
5.13
5.05
0.0
——————————————————————————–
8201-SYS
Bios
YES
1.23
1.23
0.0
BiosGolden
YES
1.23
1.15
0.0
Displays which cards are supported with your current Cisco IOS XR software release, which FPD image you need for each card, and what the minimum hardware requirements are for the various modules. (A minimum hardware requirement version of 0.0 indicates that all hardware can support this FPD image version.)
If there are multiple FPD images for your card, use this command to determine which FPD image to use if you want to upgrade only a specific FPD type.
The FPD name used in the FPD Description column of the output of the show fpd package command includes the last ten characters of DCO-PID. Depending on the slot and port numbers, the FPD name is appended with DCO_0, DCO_1, or DCO_2. For example, the FPD names for CFP2-WDM-D-1HL in port 0 and port 1 are -WDM-D-1HL_DCO_0 and WDM-D-1HL_DCO_1 respectively.
upgrade hw-module fpd {all | fpga-type} [ force] location [all | node-id]
Example:
Router#upgrade hw-module fpd all location 0/3/1 . . . Successfully upgraded 1 FPD for SPA-2XOC48POS/RPR
on location 0/3/1
Router#upgrade hw-module location 0/RP0/CPU0 fpd all upgrade command issued (use “show hw-module fpd” to check upgrade status) Router: %SECURITY-SSHD_SYSLOG_PRX-6-INFO_GENERAL : sshd[29745]: Accepted authentication for cisco from 223.255.254.249 port 39510 ssh2 upgrade hw-module location 0/RP0/CPU0 fpd all RRouter: ssh_syslog_proxy[1223]: %SECURITY-SSHD_SYSLOG_PRX-6-INFO_GENERAL : sshd[29803]: Accepted authentication for cisco from 223.255.254.249 port 39524 ssh2
Upgrading Field-Programmable Device 6
Upgrading Field-Programmable Device
How to Upgrade FPD Images
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : Upgrade for the following FPDs has been
committed:
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : Location
FPD name
Force
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT :
==================================================
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
x86FpgaGolden
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
x86Fpga
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
SsdMicron5300
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
IoFpgaGolden
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
IoFpga
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
DbIoFpgaGolden
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
DbIoFpga
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
BiosGolden
FALSE
Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : 0/RP0/CPU0
Bios
FALSE
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
x86FpgaGolden@0/RP0/CPU0: Image not upgradable
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
x86TamFwGolden@0/RP0/CPU0: Image not upgradable
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
x86FpgaGolden@0/RP0/CPU0: A dependent FPD upgrade is skipped
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
IoFpgaGolden@0/RP0/CPU0: Upgrade not required
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
DbIoFpgaGolden@0/RP0/CPU0: Upgrade not required
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
BiosGolden@0/RP0/CPU0: Image not upgradable
Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_SKIPPED : FPD upgrade skipped for
SsdMicron5300@0/RP0/CPU0: Upgrade not required as it is current
Router#fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_COMPLETE : FPD upgrade complete for Bios@0/RP0/CPU0 [image upgraded to version 254.00] Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_COMPLETE : FPD upgrade complete for x86TamFw@0/RP0/CPU0 [image upgraded to version 7.10] Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_COMPLETE : FPD upgrade complete for DbIoFpga@0/RP0/CPU0 [image upgraded to version 14.00] Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_COMPLETE : FPD upgrade complete for IoFpga@0/RP0/CPU0 [image upgraded to version 14.00] Router:fpd_client[385]: %PLATFORM-FPD_CLIENT-1-UPGRADE_COMPLETE : FPD upgrade complete for x86Fpga@0/RP0/CPU0 [image upgraded to version 254.00] Router:shelfmgr[459]: %PLATFORM-SHELFMGR-6-INFO_LOG : 0/RP0/CPU0 is operational Router:fpd-serv[265]: %INFRA-FPD_Manager-1-UPGRADE_ALERT : FPD Upgrade Completed (use “show hw-module
fpd” to check upgrade status)
Upgrades all the current FPD images that must be upgraded on the specified card with new images.
Before continuing to the next step, wait for confirmation that the FPD upgrade has successfully completed. Status messages, similar to these, are displayed to the screen until the FPD upgrade is completed:
FPD upgrade started. FPD upgrade in progress.. FPD upgrade in progress.. FPD upgrade sent to location xxxx FPD upgrade sent to location yyyy
Upgrading Field-Programmable Device 7
How to Upgrade FPD Images
Upgrading Field-Programmable Device
FPD upgrade in progress.. FPD upgrade finished for location xxx FPD upgrade in progress.. FPD upgrade finished for location yyyy FPD upgrade completed.
The “FPD upgrade in progress.” message is printed every minute. These logs are information logs, and as such, are displayed if the logging console informational command is configured.
If Ctrl-C is pressed while the FPD upgrade is in progress, the following warning message is displayed:
FPD upgrade in progress on some hardware, aborting now is not recommended as it might cause HW programming failure and result in RMA of the hardware. Do you want to continue? [Confirm(y/n)]
If you confirm that you want to abort the FPD upgrade procedure, this message is displayed:
FPD upgrade process has been aborted, please check the status of the hardware and reissue the upgrade command if required.
Note · If your card supports multiple FPD images, you can use the show fpd package admin command to determine what specific image to upgrade in the upgrade hw-module fpd command.
· A message is displayed when router modules cannot get upgraded during upgrade with location all option indicating that the FPGA is intentionally skipped during upgrade. To upgrade such FPGAs, you can use the CLI command with a particular location explicitly specified. For example, upgrade hw-module fpd all location 0/3/1.
· It is recommended to upgrade all FPGAs on a given node using the upgrade hw-module fpd all location {all | node-id} command. Do not upgrade the FPGA on a node using the upgrade hw-module fpd <individual-fpd> location {all | node-id} as it may cause errors in booting the card.
Step 4
Step 5 Step 6
hw-module location{ node-id | all } reload Use the hw-module location reload command to reload a line card.
Router:ios(config)# hw-module location 0/3 reload
exit show hw-module fpd Verifies that the FPD image on the card has been successfully upgraded by displaying the status of all FPDs in the system. Example:
Router# show hw-module fpd
Auto-upgrade:Disabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location Card type
HWver FPD device
ATR Status Running Programd Reload Loc
————————————————————————————————-
0/RP0/CPU0 8201
0.30 Bios
NEED UPGD 7.01 7.01 0/RP0/CPU0
0/RP0/CPU0 8201
0.30 BiosGolden
B NEED UPGD
7.01 0/RP0/CPU0
Upgrading Field-Programmable Device 8
Upgrading Field-Programmable Device
How to Upgrade FPD Images
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/RP0/CPU0 8201
0/PM0
PSU2KW-ACPI
0/PM1
PSU2KW-ACPI
0.30 IoFpga
NEED UPGD 7.01
0.30 IoFpgaGolden
B NEED UPGD
0.30 SsdIntelS3520
NEED UPGD 7.01
0.30 x86Fpga
NEED UPGD 7.01
0.30 x86FpgaGolden B NEED UPGD
0.30 x86TamFw
NEED UPGD 7.01
0.30 x86TamFwGolden B NEED UPGD
0.0 PO-PrimMCU
NEED UPGD 7.01
0.0 PO-PrimMCU
NEED UPGD 7.01
7.01 7.01 7.01 7.01 7.01 7.01 7.01 7.01 7.01
0/RP0 0/RP0 0/RP0 0/RP0 0/RP0 0/RP0 0/RP0 NOT REQ NOT REQ
If the cards in the system do not meet the minimum requirements, the output contains a “NOTES” section that states how to upgrade the FPD image.
Table 1: show hw-module fpd Field Descriptions
Field Card Type HW Version Type
Description Module part number. Hardware model version for the module. Hardware type.
· lc–Line card
Subtype
FPD type. Can be one of the following types: · Bios – Basic Input/Output System · BiosGolden – Golden BIOS image · IoFpga – Input/Output Field-Programmable Gate Array · IoFpgaGolden – Golden IoFpga · SsdIntelS3520 – Solid State Drive, made by Intel, of the model series S3520 · x86Fpga – Field-Programmable Gate Array designed to work with x86-based systems · x86FpgaGolden – Golden image of x86Fpga · x86TamFw – x86 Tam firmware · x86TamFwGolden – Golden image of x86TamFw · PO-PrimMCU – Primary microcontroller unit associated with a ‘PO’
Inst
FPD instance. The FPD instance uniquely identifies an FPD and is used by the FPD process to
register an FPD.
Current SW Version Currently running FPD image version.
Upg/Dng?
Specifies whether an FPD upgrade or downgrade is required. A downgrade is required in rare cases when the version of the FPD image has a higher major revision than the version of the FPD image in the current Cisco IOS XR software package.
Upgrading Field-Programmable Device 9
Automatic Line Card Reload on FPD Upgrade
Upgrading Field-Programmable Device
Automatic Line Card Reload on FPD Upgrade
This feature automatically reloads a newly inserted line card (LC) after a successful FPD upgrade. The prior auto FPD upgrade process did not reload the line card automatically, the user had to manually reload the LC.
Restrictions for Automatic Line Card Reload on FPD Upgrade
The following restriction must be considered while configuring automatic line card reload on FPD upgrade: · If the FPD upgrade fails on a line card then the automatic line card reload feature (if enabled) stops the LC from reloading.
Configure Automatic Line Card Reload on FPD Upgrade
The following sample shows how to configure auto-reload feature:
Router# config Router(config)#fpd auto-upgrade enable Router(config)#fpd auto-reload enable Router(config)#commit
The auto-reload feature is only supported on line cards.
Note During the FPD upgrade process, the linecard may display IOS XR RUN state before triggering auto-reload.
Power Module Upgrades
In Cisco IOS XR Routers, Field Programmable Device (FPD) upgrades for power modules are used to update the firmware or hardware logic of power entry modules (PEMs) within the router. These upgrades ensure that power modules operate effectively with the latest enhancements and bug fixes. Follow the Manual Power Module FPD Upgrade procedure to upgrade the FPD on PEMs.
Manual Power Module FPD Upgrade
Manual Power modules FPD upgrades are supported on Cisco Routers and should be performed in Config mode only. This feature lets you perform FPD upgrades on individual PEMs. Only power modules that support FPD upgrades can be upgraded manually.
Note Power module upgrades are time consuming and can’t be implicitly upgraded or as a part of automatic FPD upgrades. These modules must be upgraded independent of the other fpga upgrades.
To determine which PEMs requires upgrade, use show hw-module location all fpd. PEMs requiring upgrade are in UPGD SKIP status.
Upgrading Field-Programmable Device 10
Upgrading Field-Programmable Device
Manual Power Module FPD Upgrade
Router#show hw-module location all fpd
Auto-upgrade:Disabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location Card type
HWver FPD device
ATR Status Running Programd
Reload Loc
————————————————————————————————-
0/RP0/CPU0 8201
0.30 Bios
NEED UPGD 7.01 7.01
0/RP0/CPU0
0/RP0/CPU0 8201
0.30 BiosGolden
B NEED UPGD
7.01
0/RP0/CPU0
0/RP0/CPU0 8201
0.30 IoFpga
NEED UPGD 7.01 7.01
0/RP0
0/RP0/CPU0 8201
0.30 IoFpgaGolden
B NEED UPGD
7.01
0/RP0
0/RP0/CPU0 8201
0.30 SsdIntelS3520
NEED UPGD 7.01 7.01
0/RP0
0/RP0/CPU0 8201
0.30 x86Fpga
NEED UPGD 7.01 7.01
0/RP0
0/RP0/CPU0 8201
0.30 x86FpgaGolden B NEED UPGD
7.01
0/RP0
0/RP0/CPU0 8201
0.30 x86TamFw
NEED UPGD 7.01 7.01
0/RP0
0/RP0/CPU0 8201
0.30 x86TamFwGolden B NEED UPGD
7.01
0/RP0
0/PM0
PSU2KW-ACPI
0.0 PO-PrimMCU
NEED UPGD 7.01 7.01
NOT REQ
0/PM1
PSU2KW-ACPI
0.0 PO-PrimMCU
NEED UPGD 7.01 7.01
NOT REQ
To upgrade the power modules manually, use [admin] upgrade hw-module location 0/PTlocation fpd <fpd_device>.
Router# admin Router(admin)# upgrade hw-module location 0/PT0 fpd PM0-DT-Pri0MCU
To force a power module upgrade, use upgrade hw-module fpd all force location pm-all command in Admin mode.
Upgrading Field-Programmable Device 11
Upgrading FPD for PSU
Upgrading Field-Programmable Device
Upgrading FPD for PSU
Table 2: Feature History Table
Feature Name Optimized PSU FPD Upgrade
Release Information Release 7.8.1
Feature Description
We have optimized the upgrade process of Field-Programmable Devices (FPDs) associated with the Power Supply Unit (PSUs) on the router. During the installation and PSU insertion process on the router, the FPDs associated with the PSUs are automatically upgraded. Starting this release, the PSU FPDs are grouped in the form of a parent FPD and its related child FPDs, and the upgrade image is downloaded only once. The upgrade is then triggered on the parent FPD PSU and replicated to the child FPD PSUs.
In earlier releases, you downloaded the FPD image for each FPD associated with that PSU, and the upgrade process was then triggered sequentially. This process was time-consuming.
The feature is supported on the following PSUs:
· PSU2KW-ACPI
· PSU2KW-HVPI
· PSU3KW-HVPI
· PSU4.8KW-DC100
Note You must disable auto FPD upgrade for PSUs before upgrading the router to Cisco IOS XR Software Release 7.9.1 or later if your router uses any of the following PSUs: · PSU2KW-ACPI
· PSU2KW-ACPE
· PSU2KW-HVPI
· PSU4.8KW-DC100
Upgrading Field-Programmable Device 12
Upgrading Field-Programmable Device
Automatic FPD Upgrade for PSU
To disable auto FPD upgrade, use the following command:
fpd auto-upgrade exclude pm
RP/0/RSP0/CPU0:ios# show running-config fpd auto-upgrade RP/0/RP0/CPU0:ios(config)#fpd auto-upgrade exclude pm RP/0/RP0/CPU0:ios(config)#commit RP/0/RP0/CPU0:ios#
Automatic FPD Upgrade for PSU
Feature Name
Release Information
Automatic FPD upgrade for PSU Release 7.5.2
Feature Description
Automatic FPD upgrade for PSUs is now enabled. In earlier releases, automatic upgrades did not apply to FPDs associated with the PSUs.
During the Power Supply Unit (PSU) insertion and installation process, the routers can now automatically upgrade the Field-Programmable Devices (FPD) associated with the PSUs.
Starting with Cisco IOS-XR Release 7.5.2, the automatic FPD upgrade includes the FPDs associated with the PSUs by default. This means that when automatic FPD upgrade is enabled, the FPDs associated with the PSUs will also be upgraded. The upgrades for the PSUs will occur sequentially, so the FPD upgrades for the PSUs will take longer than for other components.
You can choose to exclude PSUs from the automatic upgrade process to reduce the time taken for FPD automatic upgrade by preventing them from being upgraded upon insertion or during a system upgrade using the fpd auto-upgrade exclude pm command.
Configuration example for excluding PSUs from automatic FPD upgrade:
Configuration
Router# config Router(config)# fpd auto-upgrade enable Router(config)# fpd auto-upgrade exclude pm Router(config)# commit
Show Running Configuration
Router# show running-config fpd auto-upgrade fpd auto-upgrade enable fpd auto-upgrade include pm
Upgrading Field-Programmable Device 13
Exclude the Default PSU Upgrade from the Automatic FPD Upgrade
Upgrading Field-Programmable Device
Exclude the Default PSU Upgrade from the Automatic FPD Upgrade
Table 3: Feature History Table
Feature Name
Release Information
Exclude the Default Release 24.3.1 PSU Upgrade from the Automatic FPD Upgrade
Feature Description
Introduced in this release on: Fixed Systems (8200 [ASIC: Q200, P100], 8700 [ASIC: P100], Centralized Systems (8600 [ASIC:Q200]); Modular Systems (8800 [LC ASIC: Q100, Q200, P100])
To make the automatic FPD upgrade process more time efficient, we have decreased the default time needed for FPD automatic upgrades by excluding PSUs from the automatic upgrade process. This is because the PSU upgrades are carried out one after the other, and on a fully loaded router, the process could take more than an hour to complete. We have also added an option to include the PSU in the automatic FPD upgrade. Previously, the PSU upgrade was included by default in the automatic FPD upgrade.
The feature introduces the following change:
CLI:
· The include pm keyword is introduced in the fpd auto-upgrade command.
The routers automatically upgrade the Field-Programmable Devices (FPDs) associated with the Power Supply Unit (PSU) by default during the PSU insertion and installation process.
Starting with Cisco IOS-XR Release 24.3.1, the automatic FPD upgrade excludes the FPDs associated with the PSUs by default. This means that when the automatic FPD upgrade is enabled, the FPDs associated with the PSUs will not be upgraded by default to avoid the FPD automatic upgrade taking longer. The PSU upgrade exclusion is because the PSU upgrades will occur sequentially, and the FPD upgrades for the PSUs will take longer for a fully loaded router.
You can include the PSU upgrade to the FPD automatic upgrade process using the fpd auto-upgrade include pm command.
Include PSUs to Automatic FPD Upgrade
To include the PSU upgrade to FPD automatic upgrade process, do the following:
Procedure
Step 1
Enable the FPD automatic upgrade.
Example:
Router# config Router(config)# fpd auto-upgrade enable Router(config)# commit
Upgrading Field-Programmable Device 14
Upgrading Field-Programmable Device
Auto upgrade support for SC/MPA
Step 2 Step 3 Step 4
Include PSU upgrade in the FPD automatic upgrade. Example:
Router# config Router(config)# fpd auto-upgrade include pm Router(config)# commit
Verify the FPD and PSU automatic upgrade configurations. Example:
Router# show running-config fpd auto-upgrade fpd auto-upgrade enable fpd auto-upgrade include pm
View the status of PSU auto upgrade. Example:
Router# show hw-module fpd
Auto-upgrade:Disabled
Auto-upgrade PM:Disabled Attribute codes: B golden, P protect, S secure, A Anti Theft aware
Auto upgrade support for SC/MPA
In Cisco 8000 Series Routers, the auto upgrade on bootup path is being supported for new CPU less cards SC and MPA.
The RP and SC cards together form a domain in Active and Standby nodes. The respective domain lead (RP) is responsible to trigger the auto upgrade of respective SC cards.
Upgrading Field-Programmable Device 15
Auto upgrade support for SC/MPA
Upgrading Field-Programmable Device
Upgrading Field-Programmable Device 16
Documents / Resources
 |
Cisco Upgrading Field-Programmable Device [pdf] Owner's Manual 8000 Series Routers, Upgrading Field-Programmable Device, Field-Programmable Device, Device |