Cisco 12000 Series Router SIP and SPA Software Configuration Guide, 12.0(33)S

Upgrading Field-Programmable Devices

In general terms, field-programmable devices (FPDs) are hardware devices implemented on router cards that support separate upgrades. The term "FPD" has been introduced to collectively and generically describe any type of programmable hardware device on SPAs. FPDs were introduced on the Cisco 12000 series routers to support SPAs.

This chapter describes the information that you need to know to verify image versions and to perform SPA FPD upgrades.

This chapter includes the following sections:

•Release History

•FPD Quick Upgrade

•Overview of FPD Images and Packages

•Upgrading FPD Images

•Optional FPD Procedures

•FPD Image Upgrade Examples

•Troubleshooting Problems with FPD Image Upgrades

Release History

Table 17-1 provides the release and modification history for all FPD-related features on the Cisco 12000 series routers.

Table 17-1   FPD Release History

FPD Quick Upgrade

This section provides information if you simply want to upgrade FPD for SPAs as quickly as possible. These instructions are not always feasible for operating network environments and are not the only methods available for upgrading FPD. If these methods of upgrade are not suitable for your situation, see the various other sections of this document for other methods of upgrading FPD.

This section addresses the following topics:

•FPD Quick Upgrade Before Upgrading your Cisco IOS Release (Recommended)

•FPD Quick Upgrade After Upgrading your Cisco IOS Release

FPD Quick Upgrade Before Upgrading your Cisco IOS Release (Recommended)

Step 1 When getting your Cisco IOS image, download the FPD image package for the Cisco IOS release that you are upgrading to to any Flash disk on your router before booting the new version of Cisco IOS. The FPD image package can be retrieved from the same site where you went to get your Cisco IOS image. Do not change the name of the FPD image package.

Step 2 Boot using the new version of Cisco IOS. When the new Cisco IOS boots, it by defaults searches for the FPD image package in the router flash file systems and the FPD images will be updated automatically as part of the IOS boot process.

FPD Quick Upgrade After Upgrading your Cisco IOS Release

Step 1 An FPD upgrade is not always necessary after Cisco IOS is upgraded. If you have already upgraded your Cisco IOS, enter the show hw-module all fpd command to see if all system FPDs are compatible. If the FPDs are compatible, no further action is necessary. If at least one FPD needs an upgrade, proceed to Step 2.

Step 2 Go to the cisco.com site where you downloaded your specific Cisco IOS software and locate the FPD image package, if you haven't already.

Step 3 Download this FPD image package to a Flash disk on your router. Do not change the name of the FPD image package.

Do not change any FPD-related settings on your system (if upgrade fpd auto or upgrade fpd path has been changed, change the settings back to the default settings using the no form of the command). Reboot your Cisco IOS release software. When the new Cisco IOS boots, it by defaults searches for the FPD image package in the Flash file systems and the FPD images will be updated automatically as part of the IOS boot process.

Overview of FPD Images and Packages

An FPD image package is used to upgrade FPD images. Whenever a Cisco IOS image is released that supports carrier cards and SPAs, a companion FPD image package is also released for that Cisco IOS software release. The FPD image package is available from Cisco.com and is accessible from the Cisco Software Center page where you also go to download your Cisco IOS software image.

If you are running SPAs on your router and are upgrading your Cisco IOS image, you should download the FPD image package file before booting the router using the new Cisco IOS release. If the SPA requires an FPD upgrade and the Cisco IOS image is unable to locate an FPD image package, the system messages will indicate that the FPD image is incompatible and you will need to go to the Cisco Software Center on Cisco.com to download the FPD image package for your Cisco IOS software release. An FPD incompatibility on a SPA disables all interfaces on that SPA until the incompatibility is addressed.

Note The FPD automatic upgrade feature only searches for the FPD image package file that is the same version number as the Cisco IOS release being used by the system. For example, if the Cisco IOS release being used is Cisco IOS Release 12.0(31)S, then the system will search for the FPD image package file that supports the specific Cisco IOS release (c12k-fpd-pkg.120-31.S.pkg). Therefore, ensure the FPD image package file on your system is compatible with your Cisco IOS release and do not change the name of the FPD image package file.

Upgrading FPD Images

This section documents some of the common scenarios where FPD image updates are necessary. It discusses the following scenarios:

•Migrating to a Newer Cisco IOS Release

•Upgrading FPD Images in a Production System

Migrating to a Newer Cisco IOS Release

This section discusses the following topics:

•Upgrading FPD Images Before Booting the New Cisco IOS Release (Recommended)

•Upgrading FPD Images in a Production System

Upgrading FPD Images Before Booting the New Cisco IOS Release (Recommended)

If you are still running your old Cisco IOS Release but are preparing to load a newer version of Cisco IOS, you can upgrade FPD for the new Cisco IOS Release using the following method:

•Placing FPD Image Package on Flash Disk Before Upgrading IOS (Recommended)

Placing FPD Image Package on Flash Disk Before Upgrading IOS (Recommended)

Placing the FPD image package for the IOS release that you are upgrading to before upgrading IOS is the recommended method for upgrading FPD because it is simple in addition to being fast. To perform this type of FPD upgrade, follow these steps:

Step 1 While still running the Cisco IOS release that will be upgraded, place the FPD image package for the new version of Cisco IOS onto one of your router's Flash file systems. For instance, if you are running Cisco IOS Release 12.0(31)S and are upgrading to Cisco IOS Release 12.0(32)S, place the FPD image package for Cisco IOS Release 12.0(32)S onto a Flash file system while still running Cisco IOS Release 12.0(31)S. The FPD image package for a specific IOS release can be located on cisco.com from the same area where you download that Cisco IOS software image. Your router and SPAs should continue to operate normally since this action will have no impact on the current FPDs.

Caution Do not change the filename of the FPD image package file. The Cisco IOS searches for the FPD image package file by filename, so the FPD image package file cannot be found if it has been renamed.

Step 2 Reboot your router using the new upgraded Cisco IOS image. As part of the bootup process, the router will search for the FPD image package. Since the default settings for the FPD image package search are to check for the FPD image package for the specific Cisco IOS Release in a Flash file system, the FPD image package will be located during the bootup procedure and all FPDs that required upgrades will be upgraded.

Step 3 When the router has booted, verify the upgrade was successful by entering the show hw-module all fpd command.

Upgrading FPD Images after Booting the New Cisco IOS Release

The following steps explain how to upgrade FPD images if you have already upgraded your Cisco IOS release but still need to upgrade your FPD images.

To perform an FPD upgrade after the new Cisco release has been booted, follow these steps:

Step 1 If you are unsure if your FPD images for your SPAs are compatible, enter the show hw-module all fpd command to verify compatibility of all SPAs. If all of your SPAs are compatible, there is no reason to perform this upgrade.

Step 2 If an FPD upgrade is necessary, place the FPD image package for the new version of Cisco IOS onto the router's Flash Disk or on an accessible FTP or TFTP server. The FPD image package can be located on cisco.com from the same area where you downloaded your Cisco IOS software image.

Step 3 Enter the upgrade hw-module subslot slot-number/subslot-number fpd file-url [force] command. The file-url command should direct users to the location of the FPD image package. For instance, if you had placed the FPD image package for Release 12.0(31)S on the TFTP server mytftpserver/myname/myfpdpkg, you would enter upgrade hw-module subslot slot-number/subslot-number fpd file tftp://mytftpserver/myname/myfpdpkg/c12k-fpd-pkg.120-31.S.pkg to complete this step.

If multiple SPAs require upgrades, the different pieces of hardware will have to be updated individually.

Note the force option is used in this command. This option will force an FPD upgrade even if no FPD mismatch is detected. In instances where the upgrade hw-module command is entered, this option is almost never necessary and should only be entered if requested by a technical support representative.

Step 4 Verify the upgrade was successful by entering the show hw-module all fpd command.

Upgrading FPD Images in a Production System

Adding a SPA to a production system presents the possibility that the SPA may contain versions of FPD images that are incompatible with the Cisco IOS release currently running the router. Additionally, some processor CPU is required to perform FPD upgrades. The performance impact will vary depending on various factors, including network traffic load, the type of processing engine used, and the type of service configured.

For these reasons, we recommend that one of the following alternatives be used to perform the FPD upgrade on a production system if possible:

•Using a Non-Production System to Upgrade the SPA FPD Image

•Verifying System Compatibility Before Upgrading

Using a Non-Production System to Upgrade the SPA FPD Image

Before beginning the upgrade, ensure:

•The spare system is running the same version of the Cisco IOS software release that the target production system is running.

•The automatic upgrade feature is enabled on the spare system (the automatic upgrade feature is enabled by default. It can also be enabled using the upgrade fpd auto command).

Use the following procedure to perform an upgrade on a spare system:

Step 1 Download the FPD image package file to the router's flash file system or TFTP or FTP server accessible by the spare system. In most cases, it is preferable to place the file in a Flash file system since the router, by default, searches for the FPD image package in the Flash file systems. If the Flash file systems are full, use the upgrade fpd path command to direct the router to search for the FPD image package in the proper location.

Step 2 Insert the SPA into the spare system.

If an upgrade is required, the system will perform the necessary FPD image updates so that when this SPA is inserted to the target production system it will not trigger an FPD upgrade operation there.

Step 3 Verify the upgrade was successful by entering the show hw-module all fpd command.

Step 4 Remove the SPA from the spare system after the upgrade.

Step 5 Insert the SPA into the target production system.

Verifying System Compatibility Before Upgrading

If a spare system is not available to perform an upgrade, you can check for system compatibility by disabling the automatic upgrade feature before inserting the SPA(the automatic upgrade feature is enabled by default. It can be disabled using the no upgrade fpd auto command).

•If the FPD images on the SPA are compatible with the system, you will only need to re-enable the automatic upgrade feature (the automatic upgrade feature can be re-enabled using the upgrade fpd auto command).

•If the FPD images on the SPA are not compatible with the system, the SPA is disabled but will not impact system performance by attempting to perform an automatic upgrade.

Use the following procedure to check the FPD images on the SPA for system compatibility:

Step 1 Disable the automatic upgrade feature using the no upgrade fpd auto global configuration command.

Step 2 Insert the SPA into the system.

If the FPD images are compatible, the SPAs will operate successfully after bootup.

If the FPD images are not compatible, the SPA is disabled. At this point we recommend that you wait for a scheduled maintenance when the system is offline to manually perform the FPD upgrade using one of the procedures outlined in the "Upgrading FPD Images" section.

Step 3 Re-enable the automatic upgrade feature using the upgrade fpd auto global configuration command.

Optional FPD Procedures

This section provides information for optional FPD-related functions. None of the topics discussed in this section are necessary for completing FPD upgrades, but may be useful in some FPD-related scenarios. It covers the following topics:

•Manually Upgrading SPA FPD Images

•Upgrading FPD From an FTP or TFTP Server

•Modifying the Default Path for the FPD Image Package File Location

•Upgrading Multiple FPD Images

•Displaying Current and Minimum Required FPD Image Versions

•Displaying Information About the Default FPD Image Package

•Verifying the FPD Image Upgrade Progress

Manually Upgrading SPA FPD Images

To manually upgrade the current FPD version on a SPA, use the following command:

Router# upgrade hw-module subslot slot-number/subslot-number fpd file file-url [force]

In this example, slot-number is the slot where the SIP is installed, subslot-number is the subslot number where the SPA is located, file-url is the location and name of the FPD image package file, and force is an option that forces the SPA to perform an FPD upgrade even if FPD is compatible (the force option is almost never necessary and should only be entered if requested by a technical support representative). The SPA will automatically be reloaded to complete the FPD upgrade.

Caution An image upgrade can require a long period of time to complete depending on the hardware being upgraded.

Upgrading FPD From an FTP or TFTP Server

The generally recommended method to perform an FPD image upgrade is to download the FPD image package to a Flash file system and use the FPD automatic upgrade. By default, the system searches the Flash file systems for the FPD image package file when an FPD incompatibility is detected.

This default behavior of loading an FPD image from Flash can be changed using the upgrade fpd path global configuration command, which sets the path to search for the FPD image package file to a location other than the router's Flash file systems.

For large deployments where all the systems are being upgraded to a specific Cisco IOS software release, we recommend that the FPD image package file be placed on an FTP or TFTP server that is accessible to all the affected systems, and then use the upgrade fpd path global configuration command to configure the routers to look for the FPD image package file from the FTP or TFTP server prior to the reloading of the system with the new Cisco IOS release.

Note This approach can also be used if there is not enough disk space on the system Flash card to hold the FPD image package file.

To download an FPD image package file to an FTP or TFTP server, use the following procedure:

Step 1 Copy the FPD image package file to the FTP or TFTP server.

Step 2 Access the router from a connection that does not use the SPA interface for access, if possible. We recommend not using the SPA interface as your connection to the router because an FPD incompatibility disables all interfaces on the SPA, making a manual FPD upgrade impossible through a SPA interface. If access through one of the SPA ports is the only access to the router you have, do not use the TFTP or FTP upgrade method. Instead, copy the FPD image package to your router's default Flash card before upgrading your Cisco IOS Release. This will allow the router to find the FPD image package during the first IOS bootup and upgrade FPD automatically.

Step 3 From global configuration mode, use the upgrade fpd path command to instruct the router to locate the FPD image package file from the FTP or TFTP server location.

For example, enter one of the following global configuration commands from the target system's console:

Router(config)# upgrade fpd path tftp://my_tftpserver/fpd_pkg_dir/

or

Router(config)# upgrade fpd path ftp://login:password@my_ftpserver/fpd_pkg_dir/

Note The final "/" at the end of each of the above examples is required. If the path is specified without the trailing "/" character, the command will not work properly.

In these examples, my_tftpserver or my_ftpserver is the path to server name, fpd_pkg_dir is the directory on the TFTP server where the FPD image package is located, and login:password is your FTP login name and password.

Step 4 Make sure that the FPD automatic upgrade feature is enabled by examining the output of the show running-config command (look for the upgrade fpd auto configuration line in the output. If there are no upgrade commands in the output, then upgrade fpd auto is enabled because it is the default setting.) If automatic upgrades are disabled, use the upgrade fpd auto global configuration command to enable automatic FPD upgrades.

Step 5 Enter the show upgrade fpd file command to ensure your router is connecting properly to the default FPD image package. If you are able to generate output related to the FPD image package using this command, the upgrade should work properly.
In the following example, the router is able to generate FPD image package information for the FPD image package on the TFTP server.

Router#show upgrade fpd file 
tftp://mytftpserver/myname/myfpdpkg/c12k-fpd-pkg.120-31.S.pkg        

Loading myname/myfpdpkg//c12k-fpd-pkg.120-31.S.pkg from 223.255.254.254 (via Ethernet0): 
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

[OK - 1577472 bytes]

Cisco Field Programmable Device Image Package for IOS

C12K Family FPD Image Package (c12k-fpd-pkg.120-31.S.pkg), Version 12.0(31)S

Copyright (c) 2004-2005 by cisco Systems, Inc.

Built Thu 31-Mar-2005 22:24 by luislu

=============================== ================================================

                                        Bundled FPD Image Version Matrix

                                ================================================

                                                                       Min. Req.

Supported Card Types            ID  Image Name                Version  H/W Ver.

=============================== == ========================= ========= =========

2-port T3/E3 Serial SPA          1 T3E3 SPA ROMMON              2.12      0.0   

                                 2 T3E3 SPA I/O FPGA            0.24      0.0   

                                 3 T3E3 SPA E3 FPGA             0.6       0.0   

                                 4 T3E3 SPA T3 FPGA             0.14      0.0   

------------------------------- -- ------------------------- --------- ---------

4-port T3/E3 Serial SPA          1 T3E3 SPA ROMMON              2.12      0.0   

                                 2 T3E3 SPA I/O FPGA            0.24      0.0   

                                 3 T3E3 SPA E3 FPGA             0.6       0.0   

                                 4 T3E3 SPA T3 FPGA             0.14      0.0   

------------------------------- -- ------------------------- --------- ---------

2-port Channelized T3 SPA        1 CT3 SPA ROMMON               2.12      0.100 

                                 2 CT3 SPA I/O FPGA             1.4       0.100 

                                 3 CT3 SPA T3 FPGA R1           0.11      0.100 

                                 3 CT3 SPA T3 FPGA R2           0.15      0.200 

------------------------------- -- ------------------------- --------- ---------

4-port Channelized T3 SPA        1 CT3 SPA ROMMON               2.12      0.100 

                                 2 CT3 SPA I/O FPGA             1.4       0.100 

                                 3 CT3 SPA T3 FPGA R1           0.11      0.100 

                                 3 CT3 SPA T3 FPGA R2           0.15      0.200 

------------------------------- -- ------------------------- --------- ---------

1-port OC-192 POS/SRP FH SPA     1 1-Port POS/RPR SPA IOFPGA    1.2       0.0   

------------------------------- -- ------------------------- --------- ---------

1-port OC-192 POS/SRP HH SPA     1 1-Port POS/RPR SPA IOFPGA    1.2       0.0   

                                 1 1-Port POS/RPR SPA IOFPGA    1.2       2.0   

------------------------------- -- ------------------------- --------- ---------

1-port OC-48 POS/SRP HH SPA      1 1-Port POS/RPR SPA IOFPGA    1.2       0.0   

------------------------------- -- ------------------------- --------- ---------

10-port GE SPA                   1 GE SPA FPGA                  1.6       0.0   

------------------------------- -- ------------------------- --------- ---------

5-port GE SPA                    1 GE SPA FPGA                  1.6       0.0   

------------------------------- -- ------------------------- --------- ---------

1-port 10GE SPA                  1 10GE SPA FPGA                1.6       0.0   

=============================== ================================================

Step 6 Save the configuration and reload the system with the new Cisco IOS release.

During the system startup after the reload, the necessary FPD image version check for all the SPAs will be performed and any upgrade operation will occur automatically if an upgrade is required. In each upgrade operation, the system extracts the necessary FPD images to the SPA from the FPD image package file located on the FTP or TFTP server.

Modifying the Default Path for the FPD Image Package File Location

By default, the Cisco IOS software looks for the FPD image package file on a Flash file system when performing an automatic FPD image upgrade.

Note Be sure there is enough space on one of your Flash file systems to accommodate the FPD image package file.

Alternatively, you can store an FPD image package file elsewhere. However, because the system looks on the Flash file systems by default, you need to change the FPD image package file location so that the system is directed to search an alternate location (such an FTP or TFTP server) that is accessible by the Cisco IOS software. Enter the upgrade fpd path fpd-pkg-dir-url global configuration command, where fpd-pkg-dir-url is the alternate location, to instruct the router to search for the FPD image package elsewhere.

When specifying the fpd-pkg-dir-url, be aware of the following:

•The fpd-pkg-dir-url is the path to the FPD image package, but the FPD image package should not be specified as part of the fpd-pkg-dir-url. For instance, if the c12k-fpd-pkg.120-31.S.pkg file can be found on the TFTP server using the path mytftpserver/myname/myfpdpkg/c12k-fpd-pkg.120-31.S.pkg and you wanted the router to utilize this FPD image package for FPD upgrades, the upgrade fpd path tftp://mytftpserver/myname/myfpdpkg/ command should be entered so the router knows where to find the file. The actual filename should not be specified.

•The final "/" character in the fpd-pkg-dir-url is required. In the preceding example, note that the fpd-pkg-dir-url is tftp://mytftpserver/myname/myfpdpkg/. Entering tftp://mytftpserver/myname/myfpdpkg (note: the final "/" character is missing) as the fpd-pkg-dir-url in that scenario would not work.

If the upgrade fpd path global configuration command has not been entered to direct the router to locate an FPD image package file in an alternate location, the system searches the Flash file systems on the Cisco 12000 series router for the FPD image package file.

Failure to locate an FPD image package file when an upgrade is required will disable the SPA. Because SPAs will not come online until FPD is compatible, the SPA will also be disabled if it requires an FPD upgrade and the automatic upgrade feature is disabled.

Upgrading Multiple FPD Images

A single piece of hardware can contain multiple FPD images. The Cisco 12000 series routers can upgrade up to 4 FPD images simultaneously. However, only one FPD upgrade per router slot can occur at a time, so all FPD images on all SPAs in a single slot will have to wait for the previous FPD upgrade to finish before their specific FPD upgrade begins.

Users should note that some FPD images require the SPA to reload to complete. The FPD upgrade process will perform this step automatically, so users do not have to intervene. However, the other FPDs in the hardware of the specified slot will have to wait for this reload to complete before their upgrade process begins.

During an automatic upgrade, the Cisco 12000 series router will upgrade as many FPDs as possible at a time. No user intervention is possible or necessary. The upgrade process will not stop until all FPD images have been updated.

During manual upgrades, it is important to note that users can only specify upgrades for a single piece of hardware each time the upgrade hw-module [slot slot-number | subslot slot-number/subslot-number] fpd is entered. The up to 4 simultaneous upgrades applies to the manual upgrades as well; if you individually specify multiple manual FPD upgrades, only 4 FPDs can be upgraded simultaneously and that can only occur when the hardware is in different router slots. The FPD upgrade process will stop when all FPDs for the specified hardware have been upgraded.

Displaying Current and Minimum Required FPD Image Versions

To display the current version of FPD images on the SPAs installed on your router, use the show hw-module [slot-number/subslot-number | all] fpd command, where slot-number is the slot number where the SIP is installed, and subslot-number is the number of the SIP subslot where a target SPA is located. Entering the all keyword shows information for hardware in all router slots.

The following examples show the output when using this show command.

The output display in this example shows that FPD versions on SPAs in the system meet the minimum requirements:

Router#show hw-module all fpd

==== ====================== ====== =============================================

                             H/W   Field Programmable   Current   Min. Required

Slot Card Type               Ver.  Device: "ID-Name"    Version      Version

==== ====================== ====== ================== =========== ==============

 2/0 SPA-1XTENGE-XFP         2.1   1-10GE I/O FPGA        1.6         1.6      

---- ---------------------- ------ ------------------ ----------- --------------

 2/1 SPA-10X1GE              1.0   1-GE I/O FPGA          1.6         1.6      

---- ---------------------- ------ ------------------ ----------- --------------

 3/0 SPA-4XCT3/DS0           0.253 1-ROMMON               2.12        2.12     

                                   2-I/O FPGA             1.4         1.4      

                                   3-T3 SUBRATE FPGA      0.15        0.15     

---- ---------------------- ------ ------------------ ----------- --------------

 3/1 SPA-4XCT3/DS0           0.253 1-ROMMON               2.12        2.12     

                                   2-I/O FPGA             1.4         1.4      

                                   3-T3 SUBRATE FPGA      0.15        0.15     

==== ====================== ====== =============================================

This example shows the output when using the slot-number/subslot-number argument to identify a particular SPA:

Router#show hw-module subslot 3/1 fpd

==== ====================== ====== =============================================

                             H/W   Field Programmable   Current   Min. Required

Slot Card Type               Ver.  Device: "ID-Name"    Version      Version

==== ====================== ====== ================== =========== ==============

 3/1 SPA-4XCT3/DS0           0.253 1-ROMMON               2.12        2.12     

                                   2-I/O FPGA             1.4         1.4      

                                   3-T3 SUBRATE FPGA      0.15        0.15     

==== ====================== ====== =============================================

The output display in this example shows that the SPA in subslots 3/0 and 3/1 are disabled because at least one of the programmable devices on each SPA does not meet the minimum version requirements. The output also contains a "NOTES" section that provides the name of the FPD image package file needed to upgrade the disabled FPD image.

Router#show hw-module all fpd

==== ====================== ====== =============================================

                             H/W   Field Programmable   Current   Min. Required

Slot Card Type               Ver.  Device: "ID-Name"    Version      Version

==== ====================== ====== ================== =========== ==============

 2/0 SPA-1XTENGE-XFP         2.1   1-10GE I/O FPGA        1.6         1.6      

---- ---------------------- ------ ------------------ ----------- --------------

 2/1 SPA-10X1GE              1.0   1-GE I/O FPGA          1.6         1.6      

---- ---------------------- ------ ------------------ ----------- --------------

 3/0 SPA-4XCT... <DISABLED>  0.253 1-ROMMON               2.12        2.12     

                                   2-I/O FPGA             1.1         1.4     *

                                   3-T3 SUBRATE FPGA      0.15        0.15     

---- ---------------------- ------ ------------------ ----------- --------------

 3/1 SPA-4XCT... <DISABLED>  0.253 1-ROMMON               2.12        2.12     

                                   2-I/O FPGA             1.1         1.4     *

                                   3-T3 SUBRATE FPGA      0.15        0.15     

==== ====================== ====== =============================================

 NOTES:

       - FPD images that are required to be upgraded are indicated with a '*'

         character in the "Minimal Required Version" field. 

       - The following FPD image package file is required for the upgrade: 

         "c12k-fpd-pkg.120-31.S.pkg"

Displaying Information About the Default FPD Image Package

You can use the show upgrade fpd package default command to find out which SPAs are supported with your current Cisco IOS release and which FPD image package you need for an upgrade.

 
Router# show upgrade fpd package default

*************************************************************************

This IOS release requires the following default FPD Image Package for

the automatic upgrade of FPD images:

*************************************************************************

Version: 12.0(31)S

Package Filename: c12k-fpd-pkg.120-31.S.pkg

   List of card type supported in this package:

                                Minimal

         No. Card Type          HW Ver.

        ---- ------------------ -------

          1) 2xT3E3 SPA           0.0  

          2) 4xT3E3 SPA           0.0  

          3) 10xGE SPA            0.0  

          4) 5xGE SPA             0.0  

          5) 1x10GE XFP SPA       0.0  

          6) 1xOC192 POS/RPR HH   0.0  

          7) 1xOC192 POS/RPR FH   0.0  

          8) 2xCT3 SPA            0.100

          9) 2xCT3 SPA            0.200

         10) 4xCT3 SPA            0.100

         11) 4xCT3 SPA            0.200

        ---- ------------------ -------

Verifying the FPD Image Upgrade Progress

You can use the show upgrade fpd progress command to view a "snapshot" of the upgrade progress while an FPD image upgrade is taking place. The following example shows the type of information this command displays:

 
Router# show upgrade fpd progress

FPD Image Upgrade Progress Table:

 ==== =================== ====================================================

                          Field Programmable    Time

 Slot Card Description    Device :"ID-Name"    Needed   Time Left  State

 ==== =================== ================== ========== ========== ===========

  2/0 SPA-1XTENGE-XFP     1-10GE I/O FPGA     00:06:00   00:05:17  Updating...

 ---- ------------------- ------------------ ----------- --------- -----------

  2/1 SPA-10X1GE 	       1-GE I/O FPGA 	    --:--:--   --:--:--  Waiting...

 ==== =================== ====================================================

FPD Image Upgrade Examples

This section provides examples of automatic and manual FPD image upgrades. It includes the following examples:

•System Cannot Locate FPD Image Package File for an Automatic FPD Image Upgrade Example

•Automatic FPD Image Upgrade Example

•Manual FPD Image Upgrade Example

System Cannot Locate FPD Image Package File for an Automatic FPD Image Upgrade Example

The following example displays the output when a SPA-4XCT3/DS0 requires an FPD upgrade and the upgrade fpd auto command is enabled, but the system cannot find the FPD image package file.

SLOT 3:00:13:16: %SPA_OIR-6-INSCARD: Card inserted in Subslot 1

SLOT 3:00:13:27: %SPA_PLUGIN-6-FIRMWARE_DOWNLOADING: SPA-4XCT3/DS0[3/1]: Downloading SPA 
firmware (bundled)...via shared memory.

SLOT 3:00:13:31: %SPA_PLUGIN-6-FIRMWARE_APPS_DOWNLOADING: SPA-4XCT3/DS0[3/1]: Downloading 
SPA firmware application (bundled)...via shared memory.

01:01:18: %FPD_MGMT-3-INCOMP_IMG_VER: Incompatible I/O FPGA (FPD ID=2) image version 
detected for SPA-4XCT3/DS0 card in subslot 3/1. Detected version = 1.1, minimum required 
version = 1.4. Current HW version = 0.253.

01:01:18: %FPD_MGMT-5-UPGRADE_ATTEMPT: Attempting to automatically upgrade the FPD 
image(s) for SPA-4XCT3/DS0 card in subslot 3/1. Use 'show upgrade fpd progress' command to 
view the upgrade progress ...

SLOT 3:00:13:43: %SPA_OIR-6-INSCARD: Card inserted in Subslot 0

01:01:20: %FPD_MGMT-3-PKG_FILE_SEARCH_FAILED: FPD image package 
(c12k-fpd-pkg.120-31.S.pkg) cannot be found in system's flash card or disk to do FPD 
upgrade.

01:01:20: %FPD_MGMT-5-CARD_DISABLED: SPA-4XCT3/DS0 card in subslot 3/1 is being disabled 
because of an incompatible FPD image version. Note that the c12k-fpd-pkg.120-31.S.pkg 
package will be required if you want to perform the upgrade operation.

Automatic FPD Image Upgrade Example

The following example shows the output displayed when a SPA-4XCT3/DS0 requires an FPD image upgrade and the upgrade fpd auto command is enabled. The required FPD image is automatically upgraded.

01:43:56: %FPD_MGMT-3-INCOMP_IMG_VER: Incompatible I/O FPGA (FPD ID=2) image version 
detected for SPA-4XCT3/DS0 card in subslot 3/1. Detected version = 1.1, minimum required 
version = 1.4. Current HW version = 0.253.

01:43:56: %FPD_MGMT-5-UPGRADE_ATTEMPT: Attempting to automatically upgrade the FPD 
image(s) for SPA-4XCT3/DS0 card in subslot 3/1. Use 'show upgrade fpd progress' command to 
view the upgrade progress ...

01:43:56: %FPD_MGMT-6-BUNDLE_DOWNLOAD: Downloading FPD image bundle for SPA-4XCT3/DS0 card 
in subslot 3/1 ...

01:43:57: %FPD_MGMT-6-UPGRADE_TIME: Estimated total FPD image upgrade time for 
SPA-4XCT3/DS0 card in subslot 3/1 = 00:00:50.

01:43:57: %FPD_MGMT-6-UPGRADE_START: I/O FPGA (FPD ID=2) image upgrade in progress for 
SPA-4XCT3/DS0 card in subslot 3/1. Updating to version 1.4. PLEASE DO NOT INTERRUPT DURING 
THE UPGRADE PROCESS (estimated upgrade completion time = 00:00:50) ...via shared memory.

01:44:23: %FPD_MGMT-6-UPGRADE_PASSED: I/O FPGA (FPD ID=2) image in the SPA-4XCT3/DS0 card 
in subslot 3/1 has been successfully updated from version 1.1 to version 1.4. Upgrading 
time = 00:00:25.652

01:44:23: %FPD_MGMT-6-OVERALL_UPGRADE: All the attempts to upgrade the required FPD images 
have been completed for SPA-4XCT3/DS0 card in subslot 3/1. Number of successful/failure 
upgrade(s): 1/0.

01:44:23: %FPD_MGMT-5-CARD_POWER_CYCLE: SPA-4XCT3/DS0 card in subslot 3/1 is being power 
cycled for the FPD image upgrade to take effect.

Manual FPD Image Upgrade Example

In the following example, FPD for the 1-Port 10 Gigabit Ethernet SPA in subslot 2/0 is upgraded manually from the FPD image package file that was placed on disk0:.

Router#upgrade hw-module subslot 2/0 fpd file disk1:c12k-fpd-pkg.120-31.S.pkg   

% The following FPD(s) will be upgraded for SPA-1XTENGE-XFP (H/W ver = 2.1) in subslot 
2/0:

    ================== =========== =========== ============ 

    Field Programmable   Current     Upgrade   Estimated 

    Device: "ID-Name"    Version     Version   Upgrade Time 

    ================== =========== =========== ============ 

    1-10GE I/O FPGA        1.5         1.6       00:00:20

    ================== =========== =========== ============ 

% Are you sure that you want to perform this operation? [no]: y

% Restarting the target card in subslot 2/0 for FPD image upgrade. Please wait ...

Router#

01:59:32: %FPD_MGMT-6-UPGRADE_TIME: Estimated total FPD image upgrade time for 
SPA-1XTENGE-XFP card in subslot 2/0 = 00:00:20.

01:59:32: %FPD_MGMT-6-UPGRADE_START: 10GE I/O FPGA (FPD ID=1) image upgrade in progress 
for SPA-1XTENGE-XFP card in subslot 2/0. Updating to version 1.6. PLEASE DO NOT INTERRUPT 
DURING THE UPGRADE PROCESS (estimated upgrade completion time = 00:00:20) ...

01:59:55: %FPD_MGMT-6-UPGRADE_PASSED: 10GE I/O FPGA (FPD ID=1) image in the 
SPA-1XTENGE-XFP card in subslot 2/0 has been successfully updated from version 1.5 to 
version 1.6. Upgrading time = 00:00:23.440

01:59:55: %FPD_MGMT-6-OVERALL_UPGRADE: All the attempts to upgrade the required FPD images 
have been completed for SPA-1XTENGE-XFP card in subslot 2/0. Number of successful/failure 
upgrade(s): 1/0.

01:59:55: %FPD_MGMT-5-CARD_POWER_CYCLE: SPA-1XTENGE-XFP card in subslot 2/0 is being power 
cycled for the FPD image upgrade to take effect.

Troubleshooting Problems with FPD Image Upgrades

This section contains information to help troubleshoot problems that can occur during the upgrade process.

Power Failure or Removal of a SPA During an FPD Image Upgrade

If the FPD upgrade operation is interrupted by a power failure or the removal of the SPA, it could corrupt the FPD image. This corruption of the FPD image file makes the SPA unusable by the router and the system will display the following message when it stops trying to power up the SPA:

Note To find more information about FPD-related messages, check the system error messages guide for your Cisco IOS software release.

02:10:10: %SPA_OIR-3-SPA_POWERED_OFF: subslot 2/0: SPA 1x10GE XFP SPA powered off after 5 
failures within 600 seconds

The show hw-module subslot slot-number/subslot-number fpd command can be used to verify that the SPA is using a corrupted FPD image. In this example, the SPA in slot 4/1 is corrupted.

Router#show hw-module subslot 2/0 fpd

==== ====================== ====== =============================================

                             H/W   Field Programmable   Current   Min. Required

Slot Card Type               Ver.  Device: "ID-Name"    Version      Version

==== ====================== ====== ================== =========== ==============

 2/0 SPA-1XTENGE-XFP         2.1   1-10GE I/O FPGA 	  ?.?           ?.?

==== ====================== ====== =============================================

Performing a FPD Recovery Upgrade

The recovery upgrade procedure can only be performed on a SPA that has been powered off by the system after it has failed all of the retries attempted to initialize the SPA.

The following example displays the output of an attempt to perform a recovery upgrade before all the initialization retries have been attempted for the SPA in subslot 2/0.

02:04:08: %FPD_MGMT-4-UPGRADE_EXIT: Unexpected exit of FPD image upgrade operation for 
SPA-1XTENGE-XFP card in subslot 2/0.

02:04:15: %FPD_MGMT-5-CARD_DISABLED: SPA-1XTENGE-XFP card in subslot 2/0 is being disabled 
because of an incompatible FPD image version. Note that the c12k-fpd-pkg.120-31.S.pkg 
package will be required if you want to perform the upgrade operation.

Router#upgrade hw-module subslot 2/0 file disk1:c12k-fpd-pkg.120-31.S.pkg

% Cannot get FPD version information for version checking. If a previous upgrade attempt 
has failed for the target card, then a recovery upgrade would be required to fix the 
failure.

% The following FPD(s) will be upgraded for SPA-1XTENGE-XFP (H/W ver = 2.1) in subslot 
2/0:

    ================== =========== =========== ============ 

    Field Programmable   Current     Upgrade   Estimated 

    Device: "ID-Name"    Version     Version   Upgrade Time 

    ================== =========== =========== ============ 

    1-10GE I/O FPGA        ?.?         1.6       00:00:20

    ================== =========== =========== ============ 

% Do you want to perform the recovery upgrade operation? [no]: y

% Cannot perform recovery upgrade operation because the target card is not in a failed 
state. Please try again later.

Once the following error message is displayed, you can perform the recovery upgrade:

Note You must wait to see this error message before you attempt the upgrade.

%SPA_OIR-3-SPA_POWERED_OFF: subslot 2/0: SPA 1x10GE XFP SPA powered off after 5 failures 
within 600 seconds

Perform the manual FPD image upgrade method using the upgrade hw-module subslot command to recover from a corrupted image after the SPA has been powered off by the system. In this command, slot-number is the slot where the SIP is installed, subslot-number is the subslot of the SIP where the SPA is located, and file-url is the location of the FPD image package file.

Note Before proceeding with this operation, make sure that the correct version of the FPD image package file has been obtained for the corresponding Cisco IOS release that the system is using.

The following example displays the console output of a recovery upgrade operation:

Router#upgrade hw-module subslot 2/0 file disk1:c12k-fpd-pkg.120-31.S.pkg

% Cannot get FPD version information for version checking. If a previous upgrade attempt 
has failed for the target card, then a recovery upgrade would be required to fix the 
failure.

% The following FPD(s) will be upgraded for SPA-1XTENGE-XFP (H/W ver = 2.1) in subslot 
2/0:

    ================== =========== =========== ============ 

    Field Programmable   Current     Upgrade   Estimated 

    Device: "ID-Name"    Version     Version   Upgrade Time 

    ================== =========== =========== ============ 

    1-10GE I/O FPGA        ?.?         1.6       00:00:20

    ================== =========== =========== ============ 

% Do you want to perform the recovery upgrade operation? [no]: y

% Proceeding with recovery upgrade operation ...

Router#

02:14:47: %FPD_MGMT-6-UPGRADE_TIME: Estimated total FPD image upgrade time for 
SPA-1XTENGE-XFP card in subslot 2/0 = 00:00:20.

02:14:47: %FPD_MGMT-6-UPGRADE_START: Unknown FPD (FPD ID=1) image upgrade in progress for 
SPA-1XTENGE-XFP card in subslot 2/0. Updating to version 1.6. PLEASE DO NOT INTERRUPT 
DURING THE UPGRADE PROCESS (estimated upgrade completion time = 00:00:20) ...

02:15:10: %FPD_MGMT-6-UPGRADE_PASSED: Unknown FPD (FPD ID=1) image in the SPA-1XTENGE-XFP 
card in subslot 2/0 has been successfully updated from version ?.? to version 1.6. 
Upgrading time = 00:00:23.540

02:15:10: %FPD_MGMT-6-OVERALL_UPGRADE: All the attempts to upgrade the required FPD images 
have been completed for SPA-1XTENGE-XFP card in subslot 2/0. Number of successful/failure 
upgrade(s): 1/0.

02:15:10: %FPD_MGMT-5-CARD_POWER_CYCLE: SPA-1XTENGE-XFP card in subslot 2/0 is being power 
cycled for the FPD image upgrade to take effect. 

Verifying a Successful Upgrade

After the upgrade process is complete, you can use the show hw-module subslot slot-number/subslot-number fpd command to verify that the FPD image has been successfully upgraded:

Router#show hw-module subslot 2/0 fpd

==== ====================== ====== =============================================

                             H/W   Field Programmable   Current   Min. Required

Slot Card Type               Ver.  Device: "ID-Name"    Version      Version

==== ====================== ====== ================== =========== ==============

 2/0 SPA-1XTENGE-XFP         2.1   1-10GE I/O FPGA        1.6         1.6      

==== ====================== ====== =============================================