Cisco�IOS�XR System Management Configuration Guide for the Cisco�XR�12000 Series Router, Release 4.3.x
Upgrading FPD on the Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 426.0KB) The complete bookPDF (PDF - 3.32MB) | Feedback

Upgrading FPD on the Cisco IOS XR Software

Upgrading FPD on the Cisco IOS XR Software

In general terms, field-programmable devices (FPDs) are hardware devices implemented on router cards that support separate software upgrades. A field-programmable gate array (FPGA) is a type of programmable memory device that exists on most hardware components of the router. The term FPD has been introduced to collectively and generically describe any type of programmable hardware device on SIPs and shared port adapters (SPAs), including FPGAs and the read-only memory monitor (ROMMON). Cisco IOS XR software provides the Cisco FPD upgrade feature to manage the upgrade of FPD images on SIPs and SPAs.

This chapter describes the information that you must know to verify image versions and to perform an upgrade for SPA or SIP FPD images when incompatibilities arise.

For complete descriptions of the FPD commands listed in this module, see Related Documents. To locate documentation for other commands that might appear in the course of performing a configuration task, search online in Cisco IOS XR Commands Master List for the Cisco XR 12000 Series Router.

Table 1 Feature History for Upgrading FPD Software on Cisco IOS XR Software

Release

Modification

Release 3.3.0

Support for FPD upgrades was introduced for SIPs and SPAs.

This module contains the following topics:

Prerequisites for FPD Image Upgrades

Before upgrading the FPD on your router you must install and activate the Cisco XR 12000 Series Router-fpd.pie. For information about performing this task, see the Upgrading and Managing the Cisco IOS XR Software module in Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router.

Overview of FPD Image Upgrade Support

An FPD image is used to upgrade the software on an FPD. Whenever a Cisco IOS XR Software image is released that supports SIPs and SPAs, a companion SIP and SPA FPD image is bundled with the Cisco IOS XR software release. Generally, the FPD image is not automatically upgraded. You must manually upgrade the FPD image running on the SPA or SIP 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. An FPGA incompatibility on a SPA does not necessarily affect the running of the SPA interfaces; an FPD incompatibility on a SIP disables all interfaces for all SPAs in the SIP until the incompatibility is addressed.

Use the show hw-module fpd command to determine if an FPD upgrade is required. A value of ‘Yes’ in the Upg/Dng? (upgrade/downgrade) column indicates that an upgrade or downgrade is required.

The Cisco XR 12000 Series Router supports upgrades for FPGA devices on its SIPs and SPAs. ROMMON, MBUS ROM and FabLoader are not part of an FPD image package that corresponds to a Cisco IOS XR software image. SIPs and SPAs support manual upgrades for FPGA devices using the Cisco FPD upgrade feature that is further described in this module.

Automatic FPD Upgrade

By default, the FPD image is not automatically upgraded. Generally, you must manually upgrade the FPD image running on the SPA or SIP when you upgrade the Cisco IOS XR software image. However, if you enable the fpd auto-upgrade command in administration configuration mode, FPD images are automatically updated whenever you perform a software upgrade. For the automatic FPD upgrade to work, the following conditions must be met:

  • The FPD package installation envelope (PIE) must already be installed on the router.
  • The FPD PIE must be activated together with the new Cisco IOS XR image.
  • The fpd auto-upgrade command must be enabled.

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 such as RPs, SPAs or alarm cards are 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.


How to Upgrade FPD Images

You must 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:

  • You migrate the software to a later Cisco IOS XR software release.
  • You swap SPAs or SIPs from a system running a different Cisco IOS XR software release.
  • You insert a new SPA or SIP.

In the event that there is an FPD incompatibility with your card, you may receive an error message. If you upgrade to a newer version of the Cisco IOS XR software and there is an FPD incompatibility, you receive the following message:

LC/0/1/CPU0:Dec 23 16:33:47.945 : spa_192_jacket_v2[203]: %PLATFORM-UPGRADE_FPD-4-DOWN_REV : spa fpga2 instance 0 is down-rev (V0.6), upgrade to (V1.0). Use the "upgrade hw-module fpd" CLI in admin mode.

If the FPD image on the card is newer then what is required by the currently running Cisco IOS XR software image on the router, you receive the following error message:

LC/0/1/CPU0:Dec 23 16:33:47.955 : spa_192_jacket_v2[203]: %PLATFORM-UPGRADE_FPD-4-UP_REV : spa fpga instance 1 is severely up-rev (V2.1), downgrade to (V1.6). Use the "upgrade hw-module fpd" CLI in admin mode.

You should perform the FPD upgrade procedure if you receive such messages. Cards may not function properly if FPD incompatibilities are not resolved.

Before You Begin
  • Before upgrading the FPD, you must install and activate the c12k-fpd.pie. For information about performing this task, see the Upgrading and Managing Cisco IOS XR Software module.
  • 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 automatically reload the card, you can use the reload keyword in the upgrade hw-module fpd command. Alternatively, you can use the hw-module reload command during your next maintenance window. The upgrade procedure is not complete until the card is reloaded.

    Note


    Upgrading the FPD image on a SPA or SIP using the reload keyword temporarily places the card offline at the end of the upgrade procedure, and may interrupt traffic.


  • 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.
SUMMARY STEPS

    1.    show hw-module fpd location {all | node-id}

    2.    admin

    3.    (Optional) show fpd package

    4.    upgrade hw-module fpd {all | fpga-type} [force] location [all | node-id] [reload]

    5.    exit

    6.    (Optional) hw-module {location node-id | subslot subslot-id} reload

    7.    show platform


DETAILED STEPS
      Command or Action Purpose
    Step 1 show hw-module fpd location {all | node-id}


    Example:
    RP/0/0/CPU0:router# show hw-module fpd location all

    or

    RP/0/0/CPU0: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.

     
    Step 2 admin


    Example:
    RP/0/0/CPU0:router# admin 
     

    Enters administration EXEC mode.

     
    Step 3 show fpd package


    Example:
    RP/0/0/CPU0:router(admin)# show fpd package
     
    (Optional)

    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.

     
    Step 4 upgrade hw-module fpd {all | fpga-type} [force] location [all | node-id] [reload]


    Example:
    RP/0/0/CPU0:router(admin)# upgrade hw-module fpd 
    all force location 0/3/1 reload
    .
    .
    .
    Successfully upgraded 1 FPD for SPA-2XOC48POS/RPR 
      on location 0/3/1
     

    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
    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.

    Note   

    The reload keyword causes the SPA or SIP to be reloaded after the FPD image has been updated, which interrupts traffic transmission. If you do not use the reload keyword, you must manually reload the SPA or SIP as described in 6 before the FPD upgrade is complete.

    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.

     
    Step 5 exit


    Example:
    RP/0/0/CPU0:router(admin)# exit
     

    Exits administration EXEC mode and returns to EXEC mode.

     
    Step 6 hw-module {location node-id | subslot subslot-id} reload


    Example:
    RP/0/0/CPU0:router# hw-module subslot 0/3/1 reload

    or

    RP/0/0/CPU0:router# hw-module location 0/3/cpu0 reload
     
    (Optional)

    Use the hw-module subslot reload command to reload a SPA and the hw-module location reload command to reload a SIP or line card.

    Note   

    Only use this command if you do not use the reload keyword in the upgrade hw-module fpd command as described in 4.

     
    Step 7 show platform


    Example:
    RP/0/0/CPU0:router# show platform
     

    Verifies that the FPD image on the card has been successfully upgraded by displaying the status of all cards in the system.

     

    Configuration Examples for FPD Image Upgrade

    The following examples indicates the use of commands associated with the FPD image upgrade procedure.

    show hw-module fpd Command Output: Example

    Use the show hw-module fpd to display the current version of FPD images on the SPAs, SIPs and other cards installed on your router.

    This command can be used to identify information about FPDs on any card. If you enter the location of a line card that is not a SPA, the output displays information about any programmable devices on that line card.

    The following example shows how to display FPD compatibility for all modules in the router:

    RP/0/0/CPU0:router# show hw-module fpd location all
    
    ===================================== ==========================================
                                          Existing Field Programmable Devices
                                          ==========================================
                                            HW                       Current SW Upg/
    Location     Card Type                Version Type Subtype Inst   Version   Dng?
    ============ ======================== ======= ==== ======= ==== =========== ====
    0/1/0        SPA-4XT3/E3                1.0   spa  fpga    0       0.24     No 
                                                  spa  rommon  0       2.12     No 
                                                  spa  fpga2   0       1.0      No 
                                                  spa  fpga3   0       1.0      No 
    --------------------------------------------------------------------------------
    0/1/1        SPA-4XCT3/DS0              0.253 spa  fpga    1       2.1      No 
                                                  spa  rommon  1       2.12     No 
                                                  spa  fpga2   1       0.15     No 
    --------------------------------------------------------------------------------
    0/3/0        SPA-2XOC48POS/RPR          1.0   spa  fpga    0       1.0      No 
    --------------------------------------------------------------------------------
    0/3/1        SPA-1XTENGE-XFP            3.2   spa  fpga    1       1.7      No 
    --------------------------------------------------------------------------------
      
    RP/0/0/CPU0:router# show hw-module fpd location 0/1/0
    Sun Apr 18 10:51:33.776 DST
    
    ===================================== ==========================================
                                          Existing Field Programmable Devices
                                          ==========================================
                                            HW                       Current SW Upg/
    Location     Card Type                Version Type Subtype Inst   Version   Dng?
    ============ ======================== ======= ==== ======= ==== =========== ====
    0/1/0        SPA-1XTENGE-XFP            3.2   spa  fpga1   0       1.09     No
    --------------------------------------------------------------------------------
      
    Table 2 show hw-module fpd Field Descriptions

    Field

    Description

    Location

    Location of the module in the rack/slot/module notation.

    Card Type

    Module part number.

    HW Version

    Hardware model version for the module.

    Type

    Hardware type. Can be one of the following types:

    • spa—Shared port adapter
    • lc—Line card

    Subtype

    FPD type. Can be one of the following types:

    • fabldr—Fabric downloader
    • fpga1—Field-programmable gate array
    • fpga2—Field-programmable gate array 2
    • fpga3—Field-programmable gate array 3
    • fpga4—Field-programmable gate array 4
    • fpga5—Field-programmable gate array 5
    • rommonA—Read-only memory monitor A
    • rommon—Read-only memory monitor B

    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.

    show fpd package Command Output: Example

    Use the show fpd package command in administration EXEC mode to find out which SPAs and SIPs are supported with your current Cisco IOS XR software release, which FPD image package you need for each SPA or SIP, and what the minimum hardware requirements are for each module. If multiple FPD images are available for your card, they are listed as Subtype fpga2, fpga3, and so on.

    The following example shows sample output from the show fpd package command:

    RP/0/0/CPU0:Router# admin
    Thu Jul  7 04:40:30.631 DST
    
    =============================== ================================================
                                            Field Programmable Device Package
                                    ================================================
                                                                     SW      Min Req   Min Req
    Card Type            FPD Description            Type Subtype   Version   SW Ver    HW Vers
    ==================== ========================== ==== ======= =========== ========  =========
    E3-OC12-ATM-4        CIS1 FPGA                  lc   fpga2   40971.00        0.0       0.0  
                         IOB FPGA                   lc   fpga3   41091.00        0.0       0.0  
                         SAF 0 FPGA                 lc   fpga4   45586.00        0.0       0.0  
                         CIS2 FPGA                  lc   fpga1   40977.00        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    E3-OC3-ATM-4         CIS1 FPGA                  lc   fpga2   40971.00        0.0       0.0  
                         IOB FPGA                   lc   fpga3   41091.00        0.0       0.0  
                         SAF 0 FPGA                 lc   fpga4   45586.00        0.0       0.0  
                         CIS2 FPGA                  lc   fpga1   40977.00        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    12000-ServEngCard    TREX FPGA                  lc   fpga2     162.45        0.0       0.0  
                         TREX FPGA                  lc   fpga1       0.41257     0.0       0.0  
    ----------------------------------------------------------------------------------------------
    12000-SIP            HABANERO FPGA              lc   fpga2     240.03        0.0       0.0  
                         JALAPENO FPGA              lc   fpga5     240.13        0.0       0.0  
                         JALAPENO FPGA              lc   fpga5     240.13        0.0       0.0  
                         JALAPENO FPGA              lc   fpga1     255.23        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    E3-OC12-CH-1         Shiver FPGA                lc   fpga1       1.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-IPSEC-2G         Sequoia                    spa  fpga2       1.01        0.0       1.0  
                         Lodi                       spa  fpga1       1.22        0.0       1.0  
                         SPA PROM                   spa  rommon      1.01        0.0       1.0  
    ----------------------------------------------------------------------------------------------
    SPA-4XT3/E3          SPA E3 Subrate FPGA        spa  fpga2       1.04        0.0       0.0  
                         SPA T3 Subrate FPGA        spa  fpga3       1.04        0.0       0.0  
                         SPA I/O FPGA               spa  fpga1       1.01        0.0       0.0  
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-2XT3/E3          SPA E3 Subrate FPGA        spa  fpga2       1.04        0.0       0.0  
                         SPA T3 Subrate FPGA        spa  fpga3       1.04        0.0       0.0  
                         SPA I/O FPGA               spa  fpga1       1.01        0.0       0.0  
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-4XCT3/DS0        SPA T3 Subrate FPGA        spa  fpga2       0.11        0.0       0.100
                         SPA T3 Subrate FPGA        spa  fpga2       1.04        0.0       0.200
                         SPA I/O FPGA               spa  fpga1       2.08        0.0       0.100
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.100
    ----------------------------------------------------------------------------------------------
    SPA-2XCT3/DS0        SPA T3 Subrate FPGA        spa  fpga2       0.11        0.0       0.100
                         SPA T3 Subrate FPGA        spa  fpga2       1.04        0.0       0.200
                         SPA I/O FPGA               spa  fpga1       2.08        0.0       0.100
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.100
    ----------------------------------------------------------------------------------------------
    SPA-1XCHSTM1/OC3     SPA T3 Subrate FPGA        spa  fpga2       1.04        0.0       0.0  
                         SPA I/O FPGA               spa  fpga1       1.08        0.0       0.0  
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-24CHT1-CE-ATM    SPA T3 Subrate FPGA        spa  fpga2       1.10        0.0       1.0  
                         SPA I/O FPGA               spa  fpga1       2.32        0.0       1.0  
                         SPA ROMMON                 spa  rommon      1.03        0.0       1.0  
    ----------------------------------------------------------------------------------------------
    SPA-2CHT3-CE-ATM     SPA T3 Subrate FPGA        spa  fpga2       1.10        0.0       1.0  
                         SPA I/O FPGA               spa  fpga1       2.22        0.0       1.0  
                         SPA ROMMON                 spa  rommon      1.04        0.0       1.0  
    ----------------------------------------------------------------------------------------------
    SPA-1CHOC3-CE-ATM    SPA OC3 Subrate FPGA       spa  fpga2       1.00        0.0       2.0  
                         SPA I/O FPGA               spa  fpga1       2.23        0.0       2.0  
                         SPA ROMMON                 spa  rommon      1.04        0.0       2.0  
    ----------------------------------------------------------------------------------------------
    SPA-IPSEC-2G-2       Sequoia                    spa  fpga2       1.01        0.0       1.0  
                         Lodi                       spa  fpga1       1.22        0.0       1.0  
                         SPA PROM                   spa  rommon      1.01        0.0       1.0  
    ----------------------------------------------------------------------------------------------
    SPA-1XCHOC48/DS3     SPA I/O FPGA               spa  fpga2       1.00        0.0       0.49 
                         SPA I/O FPGA               spa  fpga3       1.00        0.0       0.52 
                         SPA I/O FPGA               spa  fpga1       1.36        0.0       0.49 
                         SPA ROMMON                 spa  rommon      2.02        0.0       0.49 
    ----------------------------------------------------------------------------------------------
    SPA-1XCHOC12/DS0     SPA I/O FPGA               spa  fpga2       1.00        0.0       0.49 
                         SPA I/O FPGA               spa  fpga1       1.36        0.0       0.49 
                         SPA ROMMON                 spa  rommon      2.02        0.0       0.49 
    ----------------------------------------------------------------------------------------------
    SPA-OC192POS         SPA FPGA swv1.2            spa  fpga1       1.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-8XOC12-POS       SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.5  
    ----------------------------------------------------------------------------------------------
    SPA-8XCHT1/E1        SPA I/O FPGA               spa  fpga1       2.08        0.0       0.0  
                         SPA ROMMON                 spa  rommon      2.12        0.0       0.140
    ----------------------------------------------------------------------------------------------
    SPA-OC192POS-XFP     SPA FPGA swv1.2            spa  fpga1       1.02        0.0       0.0  
                         SPA FPGA swv1.2 hwv2       spa  fpga1       1.02        0.0       2.0  
    ----------------------------------------------------------------------------------------------
    SPA-10X1GE           SPA FPGA swv1.10           spa  fpga1       1.10        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-5X1GE            SPA FPGA swv1.10           spa  fpga1       1.10        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-2XOC48POS/RPR    SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-4XOC48POS/RPR    SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-1XTENGE-XFP      SPA FPGA swv1.9            spa  fpga1       1.09        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-8X1FE            SPA FPGA swv1.1            spa  fpga1       1.01        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-1XOC48POS/RPR    SPA FPGA swv1.2            spa  fpga1       1.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-8XOC3-POS        SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.5  
    ----------------------------------------------------------------------------------------------
    SPA-2XOC12-POS       SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.5  
    ----------------------------------------------------------------------------------------------
    SPA-4XOC12-POS       SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.5  
    ----------------------------------------------------------------------------------------------
    SPA-10X1GE-V2        SPA FPGA swv1.10           spa  fpga1       1.10        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-8X1GE-V2         SPA FPGA swv1.10           spa  fpga1       1.10        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-5X1GE-V2         SPA FPGA swv1.10           spa  fpga1       1.10        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-2X1GE-V2         SPA FPGA swv1.1            spa  fpga1       1.01        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-1X10GE-L-V2      SPA FPGA swv1.11           spa  fpga1       1.11        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-8X1FE-V2         SPA FPGA swv1.1            spa  fpga1       1.01        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-4XOC3-POS-V2     SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.5  
    ----------------------------------------------------------------------------------------------
    SPA-1X10GE-L-IT      SPA FPGA swv1.0            spa  fpga1       1.00        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-1XOC3-ATM-V2     TATM SPA IOFPGA            spa  fpga1       2.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-2XOC3-ATM-V2     SPA TATM IOFPGA            spa  fpga1       2.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-3XOC3-ATM-V2     SPA TATM IOFPGA            spa  fpga1       2.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
    SPA-1XOC12-ATM-V2    SPA TATM IOFPGA            spa  fpga1       2.02        0.0       0.0  
    ----------------------------------------------------------------------------------------------
       
    This table describes the significant fields shown in the display:

    Table 3  show fpd package Field Descriptions

    Field

    Description

    Card Type

    Module part number.

    FPD Description

    Description of all FPD images available for the SPA.

    Type

    Hardware type. Possible types can be:

    • spa—Shared port adapter
    • lc—Line card

    Subtype

    FPD subtype. These values are used in the upgrade hw-module fpd command to indicate a specific FPD image type to upgrade.

    SW Version

    FPD software version recommended for the associated module running the current Cisco IOS XR software.

    Min Req SW Vers

    Minimum required FPD image software version to operate the card. Version 0.0 indicates that a minimum required image was not programmed into the card.

    Min Req HW Vers

    Minimum required hardware version for the associated FPD image. A minimum hardware requirement of version 0.0 indicates that all hardware can support this FPD image version.


    Note


    In the show fpd package command output, the “subtype” column shows the FPDs that correspond with each SPA image. To upgrade a specific FPD with the upgrade hw-module fpd command, replace the fpga-type argument with the appropriate FPD from the “subtype” column, as shown in the following example:

    RP/0/0/CPU0:router(admin)# upgrade hw-module fpd fpga2 location 0/3/1 reload
    

    upgrade hw-module fpd Command Output: Example

    Use the upgrade hw-module fpd command to upgrade the FPD image on a SPA, SIP or line card.

    The following example shows how to force the update of all FPD images on the SPA at location 0/5/1 as well as an automatic reload of the SPA after the images are updated.

    RP/0/0/CPU0:Router# admin
    RP/0/RP0/CPU0:Router(admin)# upgrade hw-module fpd all force location 0/5/1 reload
     
    % RELOAD WARNING:
      - Option to automatically reload the target module after upgrade was 
        selected. This action will interrupt normal operation of the module. 
      - If necessary, ensure that appropriate actions have been taken to 
        redirect target module's traffic before starting the upgrade operation. 
      - Note that this reload option does not have effect on target module that 
        has been placed in administrative shutdown state. Modules in this state
        will have to be placed back to a 'no shutdown' state manually after the
        upgrade opration to make the changes to take effect.
    Continue? [confirm] y
      
    Starting the upgrade/download of following FPD:
    
    =========== ==== ======= ======= =========== =========
                                       Current    Upg/Dng
    Location    Type Subtype Upg/Dng   Version    Version
    =========== ==== ======= ======= =========== =========
    0/5/1       spa  fpga    upg         1.0         1.0
    ------------------------------------------------------
    LC/0/5/CPU0:May 22 08:49:18.487 : lc_fpd_upgrade[183]: %PLATFORM-UPGRADE_FPD-6-START : 
      Starting to upgrade fpga subtype image from 1.0 to 1.0 for for 2xOC48 POS/RPR HHSPA 
      on location 0/5/1
    LC/0/5/CPU0:May 22 08:49:20.055 : spa_192_jacket_v2[251]: %L2-SPA_FPD-6-UPDATE_START : 
      SPA-2XOC48POS/RPR[1]: Starting update of FPD 'fpga' image
    LC/0/5/CPU0:May 22 08:49:20.118 : spa_192_jacket_v2[251]: %L2-SPA_192-6-UPGRADE_FPGA : 
      Writing FPD image to SPA bay 1 - attempt: 0
    RP/0/0/CPU0:May 22 08:49:34.093 : invmgr[209]: %PLATFORM-INVMGR-6-NODE_STATE_CHANGE : 
      Node: 0/8/CPU0, state: BRINGDOWN
    LC/0/5/CPU0:May 22 08:49:51.542 : spa_192_jacket_v2[251]: %L2-SPA_FPD-6-UPDATE_PASSED : 
      SPA-2XOC48POS/RPR[1]: Successfully updated FPD 'fpga' image
    
    % LC/0/5/CPU0:May 22 08:49:51.546 : lc_fpd_upgrade[183]: %PLATFORM-UPGRADE_FPD-6-PASSED : 
      Successfully upgrade fpga subtype image for for 2xOC48 POS/RPR HHSPA on location 0/5/1
    Successfully upgraded 1 FPD for SPA-2XOC48POS/RPR on location 0/5/1
      

    show platform Command Output: Example

    Use the show platform command to verify that the SPA is up and running.

    RP/0/0/CPU0:router# show platform
      
    Node            Type            PLIM            State           Config State
    -----------------------------------------------------------------------------
    0/0/CPU0        L3LC Eng 5+     Jacket Card     IOS-XR RUN      PWR,NSHUT,MON
    0/0/0           SPA             SPA-2XOC48POS/R READY           PWR,NSHUT
    0/0/2           SPA             SPA-8XFE-TX     READY           PWR,NSHUT
    0/0/3           SPA             SPA-4XCT3/DS0   READY           PWR,NSHUT
    0/1/CPU0        L3LC Eng 3      OC48-POS        IOS-XR RUN      PWR,NSHUT,MON
    0/2/CPU0        L3LC Eng 3      OC3-POS-16      IOS-XR RUN      PWR,NSHUT,MON
    0/3/CPU0        L3LC Eng 5      Jacket Card     IOS-XR RUN      PWR,NSHUT,MON
    0/3/1           SPA             SPA-OC192POS-XF READY           PWR,NSHUT
    0/7/CPU0        L3LC Eng 5      Jacket Card     IOS-XR RUN      PWR,NSHUT,MON
    0/7/0           SPA             SPA-10X1GE      READY           PWR,NSHUT
    0/7/1           SPA             SPA-1XTENGE-XFP READY           PWR,NSHUT
    0/8/CPU0        PRP             N/A             Card Present    PWR,NSHUT,MON
    0/9/CPU0        PRP(Active)     N/A             IOS-XR RUN      PWR,NSHUT,MON
      

    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 displays the following messages when it tries to power up the SPA. When it cannot successfully power up the SPA, it places it in the failed state, as shown in the following example:

    LC/0/3/CPU0:Feb  4 08:23:16.672 : spa_192_jacket[188]: %L2-SPA-5-OIR_INSERTED : SPA discovered in bay 0
      LC/0/3/CPU0:Feb  4 08:23:23.349 : spa_192_jacket[188]: %L2-SPA-5-OIR_ERROR : SPA (0): An error occurred (0x1002), error recovery action: reset SPA
      LC/0/3/CPU0:Feb  4 08:23:26.431 : spa_192_jacket[188]: %L2-SPA-5-OIR_INSERTED : SPA discovered in bay 0
      LC/0/3/CPU0:Feb  4 08:23:32.593 : spa_192_jacket[188]: %L2-SPA-5-OIR_ERROR : SPA (0): Too many retries, error recovery stopped
      LC/0/3/CPU0:Feb  4 08:23:32.593 : spa_192_jacket[188]: %L2-SPA-5-OIR_ERROR : SPA (0): An error occurred (0x1002), error recovery action: hold SPA in reset 
     

    When a SPA is in the failed state, it may not register itself with the FPD upgrade mechanism. In this case, you do not see the SPA listed when you use the show hw-module fpd command. To verify the state of a SPA, use the show hw-module subslot error command and the show hw-module subslot status command.

    Performing a SPA FPD Recovery Upgrade

    To recover a SPA from the failed state because of a corrupted FPD image, you must manually shut down the SPA. Use the hw-module subslot subslot-id shutdown command in global configuration mode to administratively shutdown the SPA. After the SPA is shut down, you can use the upgrade hw-module fpd command in administration EXEC mode, with the force option, to restart the FPD upgrade process, as shown in the following example:

    RP/0/0/CPU0:router# admin
    RP/0/0/CPU0:router(admin)# upgrade hw-module fpd fpga force location 0/3/0
      


    Note


    Performing a SPA FPD recovery upgrade as well as using the force keyword with the upgrade hw-module fpd command works only if the SPA has power. If the SPA is in the SHUT, NPWR state (you can determine the state by checking the output of the show platform command), the upgrade in general, as well as the force keyword,will not work.


    Performing a SIP FPD Recovery Upgrade

    If a SIP upgrade fails for whatever reason, do not reload the SIP. Try to perform the upgrade procedure again. You can perform the upgrade procedure multiple times, as long as you do not reload the SIP. The FPD upgrade procedure takes several minutes to complete; do not interrupt the procedure. If you reload the SIP when the FPD image is corrupted, the SIP malfunctions and you must contact Cisco technical support for assistance.

    To recover a SIP from the failed state because of a corrupted FPD image, you must contact Cisco technical support.

    To recover a SIP from the failed state because of a corrupted FPD image, you must turn off the automatic reset of the SIP card. Use the hw-module reset auto disable command in administration configuration mode, as shown in the following example:

    RP/0/0/CPU0:router(admin-config)# hw-module reset auto disable location 0/1/4
    

    Additional References

    The following sections provide references related to FPD software upgrade.

    Related Documents

    Related Topic

    Document Title

    Cisco IOS XR command master list

    Cisco IOS XR Commands Master List for the Cisco XR 12000 Series Router

    Cisco IOS XR FPD upgrade-related commands

    Cisco IOS XR System Management Command Reference for the Cisco XR 12000 Series Router

    Initial system bootup and configuration information for a router using the Cisco IOS XR Software.

    Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router

    Information about user groups and task IDs

    Configuring AAA Services on the Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide for the Cisco XR 12000 Series Router

    Information about configuring interfaces and other components on the Cisco CRS-1 from a remote Craft Works Interface (CWI) client management application

    Cisco CRS-1 Series Carrier Routing System Craft Works Interface Configuration Guide

    Standards

    Standards

    Title

    No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.

    MIBs

    MIBs

    MIBs Link

    There are no applicable MIBs for this module.

    To locate and download MIBs for selected platforms using Cisco IOS XR Software, use the Cisco MIB Locator found at the following URL: http:/​/​cisco.com/​public/​sw-center/​netmgmt/​cmtk/​mibs.shtml

    RFCs

    RFCs

    Title

    No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.

    Technical Assistance

    Description

    Link

    The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

    http:/​/​www.cisco.com/​cisco/​web/​support/​index.html