Managing the Capability Catalog in Cisco UCS Manager
This chapter includes the following sections:
- Capability Catalog
- Downloading Individual Capability Catalog Updates
- Verifying that the Capability Catalog is Current
- Activating a M-Series Capability Catalog Update
- Restarting a Capability Catalog Update
- Viewing a Capability Catalog Provider
Capability Catalog
The Capability Catalog is a set of tunable parameters, strings, and rules. Cisco UCS uses the catalog to update the display and configurability of components such as newly qualified DIMMs and disk drives for servers.
The catalog is divided by hardware components, such as the chassis, CPU, local disk, and I/O module. You can use the catalog to view the list of providers available for that component. There is one provider per hardware component. Each provider is identified by the vendor, model (PID), and revision. For each provider, you can also view details of the equipment manufacturer and the form factor.
Contents of the Capability Catalog
The contents of the Capability Catalog include the following:
Updates to the Capability Catalog
Capability Catalog updates are included in each Cisco UCS Infrastructure Software Bundle. Unless otherwise instructed by Cisco TAC, you only need to activate the Capability Catalog update after you've downloaded, updated, and activated a Cisco UCS Infrastructure Software Bundle.
As soon as you activate a Capability Catalog update, Cisco UCS immediately updates to the new baseline catalog. You do not have to perform any further tasks. Updates to the Capability Catalog do not require you to reboot or reinstall any component in a Cisco UCS domain.
Each Cisco UCS Infrastructure Software Bundle contains a baseline catalog. In rare circumstances, Cisco releases an update to the Capability Catalog between Cisco UCS releases and makes it available on the same site where you download firmware images.
Note | The Capability Catalog version is determined by the version of Cisco UCS that you are using. For information about Capability Catalog releases supported by specific Cisco UCS releases, see the Release Notes for Cisco UCS Software. |
Downloading Individual Capability Catalog Updates
Obtaining Capability Catalog Updates from Cisco
Step 1 | In a web browser, navigate to Cisco.com. |
Step 2 | Under Support, click All Downloads. |
Step 3 | In the center pane, click Unified Computing and Servers. |
Step 4 | If prompted, enter your Cisco.com username and password to log in. |
Step 5 | In the right pane, click . |
Step 6 | Click the link for the latest release of the Capability Catalog. |
Step 7 | Click one of the following buttons and follow the instructions provided: |
Step 8 | Follow the prompts to complete your download of the catalog update. |
What to Do Next
Update the Capability Catalog.
Updating the Capability Catalog from a Remote Location
You cannot perform a partial update to the Capability Catalog. When you update the Capability Catalog, all components included in the catalog image are updated.
Cisco UCS Manager downloads the image and updates the Capability Catalog. You do not need to reboot any hardware components.
The following example uses SCP to import a Capability Catalog file:
UCS-A# scope system UCS-A /system # scope capability UCS-A /system/capability # update catalog scp://user1@192.0.2.111/catalogs/ucs-catalog.2.5.0.233.T.bin Warning: This command is deprecated and will be removed in a future release. Replaced by: activate catalog Password: UCS-A /system/capability # show version Catalog: Running-Vers: 2.5(0.233)T Package-Vers: Activate-Status: Ready UCS-A /system/capability # show cat-updater ucs-catalog.2.5.0.233.T.bin Catalog Updater: File Name Protocol Server Userid Status --------- -------- --------------- --------------- ------ ucs-catalog.2.5.0.233.T.bin Scp 192.0.2.111 user1 Success UCS-A /system/capability #
Verifying that the Capability Catalog is Current
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope system |
Enters system mode. |
Step 2 | UCS-A /system # scope capability |
Enters system capability mode. |
Step 3 | UCS-A /system/capability # show version |
Displays the current Capability Catalog version. |
Step 4 | On Cisco.com, determine the most recent release of the Capability Catalog available. |
For more information about the location of Capability Catalog updates, see Obtaining Capability Catalog Updates from Cisco. |
Step 5 | If a more recent version of the Capability Catalog is available on Cisco.com, update the Capability Catalog with that version. |
UCS-A# scope system UCS-A /system # scope capability UCS-A /system/capability # show version Catalog: Running-Vers: 1.0(8.35) 2.5(0.233) Activate-Status: Ready UCS-A /system/capability #
Activating a M-Series Capability Catalog Update
The following example activates a Capability Catalog update and commits the transaction:
UCS-A# scope system UCS-A /system # scope capability UCS-A /system/capability # activate firmware 2.5(0.233) UCS-A /system/capability* # commit-buffer UCS-A /system/capability #
Restarting a Capability Catalog Update
You can restart a failed Capability Catalog file update, modifying the update parameters if necessary.
The following example changes the server IP address and restarts the Capability Catalog file update operation:
UCS-A# scope system UCS-A /system # scope capability UCS-A /system/capability # show cat-updater ucs-catalog.1.0.0.4.binshow cat-updater ucs-catalog.2.5.0.233.T.bin Catalog Updater: File Name Protocol Server Userid Status --------- -------- --------------- --------------- ------ ucs-catalog.1.0.0.4.binucs-catalog.2.5.0.233.T.bin Scp 192.0.2.111 user1 Applied UCS-A /system/capability # scope cat-updater ucs-catalog.1.0.0.4.binscope cat-updater ucs-catalog.2.5.0.233.T.bin UCS-A /system/capability/cat-updater # set server 192.0.2.112 UCS-A /system/capability/cat-updater # restart UCS-A /system/capability/cat-updater #
Viewing a Capability Catalog Provider
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope system |
Enters system command mode. |
Step 2 | UCS-A /system # scope capability |
Enters capability command mode. |
Step 3 | UCS-A /system/capability # show {chassis | cpu | disk | fan | fru | iom | memory | psu | server} [vendor model revision] [detail | expand] |
Displays vendor, model, and revision information for all components in the specified component category. To view manufacturing and form factor details for a specific component, specify the vendor , model , and revision with the expand keyword. If any of these fields contains spaces, you must enclose the field with quotation marks. |
Note | If the server contains one or more SATA devices, such as a hard disk drive or solid state drive, the show disk command displays ATA in the Vendor field. Use the expand keyword to display additional vendor information. |
The following example lists the installed fans and displays detailed information from the Capability Catalog about a specific fan:
UCS-A# scope system
UCS-A /system # scope capability
UCS-A /system/capability # show fan
Fan Module:
Vendor Model HW Revision
------------------------ ------------------------ ------------
Cisco Systems, Inc. N20-FAN5 0
Cisco Systems, Inc. N10-FAN1 0
Cisco Systems, Inc. N10-FAN2 0
Cisco Systems, Inc. N5K-C5548P-FAN 0
Cisco Systems, Inc. N5K-C5596P-FAN 0
Cisco Systems, Inc. UCS-FAN-6248UP 0
Cisco Systems, Inc. UCS-FAN-6296UP 0
UCS-A /system/capability # show fan "Cisco Systems, Inc." N10-FAN1 0 expand
Fan Module:
Vendor: Cisco Systems, Inc.
Model: N10-FAN1
Revision: 0
Equipment Manufacturing:
Name: Fan Module for UCS 6140 Fabric Interconnect
PID: N10-FAN1
VID: NA
Caption: Fan Module for UCS 6140 Fabric Interconnect
Part Number: N10-FAN1
SKU: N10-FAN1
CLEI:
Equipment Type:
Form Factor:
Depth (C): 6.700000
Height (C): 1.600000
Width (C): 4.900000
Weight (C): 1.500000
UCS-A /system/capability #