The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter includes the following sections:
Cisco UCS uses firmware obtained from and certified by Cisco to support the endpoints in a Cisco UCS instance. Each endpoint is a component in the instance that requires firmware to function. A Cisco UCS instance includes the following firmware endpoints that need to be upgraded when you upgrade the firmware:
Endpoints physically located on servers, such as the BIOS, storage controller (RAID controller), and Cisco Integrated Management Controller (CIMC)
Endpoints physically located on adapters, including NIC and HBA firmware, and Option ROM (where applicable)
I/O modules
Fabric interconnects
Cisco UCS Manager
Note |
In Release 1.3(1) the BMC was renamed to CIMC Controller. After you upgrade to this release, Cisco UCS Manager no longer uses the term BMC. Because this document is aimed at Release 1.3(1), the term CIMC is sometimes used rather than BMC. |
Cisco maintains a set of best practices for managing firmware images and updates in this document and in the following technical note: Unified Computing System Firmware Management Best Practices.
This document uses the following definitions for managing firmware:
Changes the firmware running on an endpoint to another image, such as a release or patch. Upgrade includes both update and activation.
Copies the firmware image to the backup partition on an endpoint.
Sets the firmware in the backup partition as the active firmware version on the endpoint. Activation can require or cause the reboot of an endpoint.
Cisco delivers all firmware updates or packages to Cisco UCS components in images. These images can be the following:
Component image, which contains the firmware for one component
Package, which is a collection of component images
Cisco also provides release notes with each image, which you can obtain from the same website from which you obtained the image.
Cisco UCS Manager provides mechanisms to download both component images and packages to the fabric interconnect.
Every firmware image has a header, which includes the following:
Cisco UCS Manager provides you with two views of the catalog of firmware images and their contents that have been downloaded to the fabric interconnect:
This view provides you with a read-only representation of the packages that have been downloaded onto the fabric interconnect. This view is sorted by image, not by the contents of the image. For packages, you can use this view to see which component images are (were) in each downloaded package.
The images view lists the component images available on the system. You cannot use this view to see packages. The information available about each component image includes the name of the component, the image size, the image version, and the vendor and model of the component.
You can use this view to identify the firmware updates available for each component. You can also use this view to delete obsolete and unneeded images. Cisco UCS Manager deletes a package after all images in the package have been deleted.
Tip |
Cisco UCS Manager stores the images in bootflash on the fabric interconnect. In a cluster system, space usage in bootflash on both fabric interconnects is the same, because all images are synchronized between them. If Cisco UCS Manager reports that the bootflash is out of space, delete obsolete images to free up space. |
Cisco UCS firmware is upgraded through a combination of the following methods:
Direct upgrade at the endpoints. For a cluster configuration with two fabric interconnects, a direct upgrade can be minimally disruptive to data traffic. However, it requires that the Cisco UCS instance does not include firmware policies for those endpoints that you upgrade directly. You cannot avoid disruption to traffic in a Cisco UCS instance with only one fabric interconnection.
Upgrades to server endpoints through service profiles that include a host firmware package, a management firmware package, or both. This method is disruptive to data traffic and should be performed during a maintenance window.
Note |
Direct upgrade is not available for all endpoints, including the server BIOS, storage controller, HBA firmware, and HBA option ROM. You must upgrade those endpoints through the host firmware package included in the service profile associated with the server. |
Before you upgrade the firmware for any endpoint in a Cisco UCS instance, consider the following guidelines and cautions:
Some endpoints, such as adapters and the server CIMC, can be upgraded through either a direct firmware upgrade or a firmware package included in a service profile. The configuration of a Cisco UCS instance determines how you upgrade these endpoints. If the service profiles associated with the servers include a host firmware package, upgrade the adapters for those servers through the firmware package. In the same way, if the service profiles associated with the servers include a management firmware package, upgrade the CIMC for those servers through the firmware package.
Upgrades of a CIMC through a management firmware package or an adapter through a firmware package in the service profile associated with the server take precedence over direct firmware upgrades. You cannot directly upgrade an endpoint if the service profile associated with the server includes a firmware package. To perform a direct upgrade, you must remove the firmware package from the service profile.
For a cluster configuration with two fabric interconnects, you can take advantage of the failover between the fabric interconnects and perform a direct firmware upgrade of the endpoints without disrupting data traffic. However, you cannot avoid disrupting data traffic for those endpoints which must be upgraded through a host or management firmware package.
For a standalone configuration with a single fabric interconnect, you can minimize the disruption to data traffic when you perform a direct firmware upgrade of the endpoints. However, you must reboot the fabric interconnect to complete the upgrade and, therefore, cannot avoid disrupting traffic.
If you use Cisco UCS Manager GUI to update the firmware, do not select ALL from the Filter drop-down list in the Activate Firmware dialog box to activate all endpoints simultaneously. Many firmware releases and patches have dependencies that require the endpoints to be activated in a specific order for the firmware update to succeed. This order can change depending upon the contents of the release or patch. Activating all endpoints does not guarantee that the updates occur in the required order and can disrupt communications between the endpoints and the fabric interconnects and Cisco UCS Manager. For information about the dependencies in a specific release or patch, see the release notes provided with that release or patch.
During a direct upgrade, you should configure Set Startup Version Only for an adapter. With this setting, the activated firmware moves into the pending-next-boot state, and the server is not immediately rebooted. The activated firmware does not become the running version of firmware on the adapter until the server is rebooted. You cannot configure Set Startup Version Only for an adapter in the host firmware package.
If a server is not associated with a service profile, the activated firmware moves into the pending-next-boot state. Cisco UCS Manager does not reboot the endpoints or activate the firmware until the server is associated with a service profile. If necessary, you can manually reboot an unassociated server to activate the firmware.
When you configure Set Startup Version Only for an I/O module, the I/O module is rebooted when the fabric interconnect in its data path is rebooted. If you do not configure Set Startup Version Only for an I/O module, the I/O module reboots and disrupts traffic. In addition, if Cisco UCS Manager detects a protocol and firmware version mismatch between it and the I/O module, Cisco UCS Manager automatically updates the I/O module with the firmware version that matches its own and then activates the firmware and reboots the I/O module again.
An upgrade from an earlier Cisco UCS firmware release to release 1.3(1i) or higher has the following impact on the Protect Configuration property of the local disk configuration policy the first time servers are associated with service profiles after the upgrade:
After you upgrade the Cisco UCS instance, the initial server association proceeds without configuration errors whether or not the local disk configuration policy matches the server hardware. Even if you enable the Protect Configuration property, Cisco UCS does not protect the user data on the server if there are configuration mismatches between the local disk configuration policy on the previous service profile and the policy in the new service profile.
Note |
If you enable the Protect Configuration property and the local disk configuration policy encounters mismatches between the previous service profile and the new service profile, all subsequent service profile associations with the server are blocked. |
Any servers that are already associated with service profiles do not reboot after the upgrade. Cisco UCS Manager does not report any configuration errors if there is a mismatch between the local disk configuration policy and the server hardware.
When a service profile is disassociated from a server and a new service profile associated, the setting for the Protect Configuration property in the new service profile takes precedence and overwrites the setting in the previous service profile.
The firmware on the Cisco UCS 82598KR-CI 10-Gigabit Ethernet Adapter (N20-AI0002) is burned into the hardware at manufacture. You cannot upgrade the firmware on this adapter.
The firmware versions on an endpoint depend upon the type of endpoint. The endpoints physically located on a fabric interconnect have different versions than those physically located on a server or I/O module.
Each CIMC, I/O module, and adapter has two slots for firmware in flash. Each slot holds a version of firmware. One slot is active and the other is the backup slot. A component boots from whichever slot is designated as active.
The following firmware version terminology is used in Cisco UCS Manager:
The running version is the firmware that is active and in use by the endpoint.
The startup version is the firmware that will be used when the endpoint next boots up. Cisco UCS Manager uses the activate operation to change the startup version.
The backup version is the firmware in the other slot and is not in use by the endpoint. This version can be firmware that you have updated to the endpoint but have not yet activated, or it can be an older firmware version that was replaced by a recent activate. Cisco UCS Manager uses the update operation to replace the image in the backup slot.
If the endpoint cannot boot from the startup version, it boots from the backup version.
You can only activate the fabric interconnect firmware and Cisco UCS Manager on the fabric interconnect. The fabric interconnect and Cisco UCS Manager firmware do not have backup versions, because all the images are stored on the fabric interconnect. As a result, the number of bootable fabric interconnect images is not limited to two, like the server CIMC and adapters. Instead, the number of bootable fabric interconnect images is limited by the available space in the memory of the fabric interconnect and the number of images stored there.
The fabric interconnect and Cisco UCS Manager firmware have running and startup versions of the kernel and system firmware. The kernel and system firmware must run the same versions of firmware.
If you follow the correct procedure and apply the upgrades in the correct order, a direct firmware upgrade and the activation of the new firmware version on the endpoints is minimally disruptive to traffic in a Cisco UCS instance.
You can directly upgrade the firmware on the following endpoints:
The adapter and board controller firmware can also be upgraded through the host firmware package in the service profile. If you use a host firmware package to upgrade this firmware, you can reduce the number of times a server needs to be rebooted during the firmware upgrade process.
Note |
Upgrades of a CIMC through a management firmware package or an adapter through a firmware package in the service profile associated with the server take precedence over direct firmware upgrades. You cannot directly upgrade an endpoint if the service profile associated with the server includes a firmware package. To perform a direct upgrade, you must remove the firmware package from the service profile. |
Cisco UCS Manager separates the direct upgrade process into two stages to ensure that you can push the firmware to an endpoint while the system is running without affecting uptime on the server or other endpoints.
During this stage, the system copies the selected firmware version from the primary fabric interconnect to the backup partition in the endpoint and verifies that the firmware image is not corrupt. The update process always overwrites the firmware in the backup slot.
The update stage applies only to the following endpoints:
You can set the update as Startup Version Only to avoid rebooting the endpoint immediately. This allows you to perform the update at any time and then activate and reboot during a maintenance period.
During this stage, the system sets the specified image version (normally the backup version) as the startup version and, if you do not specify Set Startup Version Only, immediately reboots the endpoint. When the endpoint is rebooted, the backup partition becomes the active partition, and the active partition becomes the backup partition. The firmware in the new active partition becomes the startup version and the running version.
The following endpoints only require activation because the specified firmware image already exists on the endpoint:
When the firmware is activated, the endpoint is rebooted and the new firmware becomes the active kernel version and system version. If the endpoint cannot boot from the startup firmware, it defaults to the backup version and raises a fault.
Caution |
When you configure Set Startup Version Only for an I/O module, the I/O module is rebooted when the fabric interconnect in its data path is rebooted. If you do not configure Set Startup Version Only for an I/O module, the I/O module reboots and disrupts traffic. In addition, if Cisco UCS Manager detects a protocol and firmware version mismatch between it and the I/O module, Cisco UCS Manager automatically updates the I/O module with the firmware version that matches its own and then activates the firmware and reboots the I/O module again. |
If you upgrade firmware by individual components in a Cisco UCS instance, we recommend that you activate the updates in the required order for quicker activation and to avoid potential issues with conflicting firmware versions.
Adapter (interface card)—If you plan to upgrade the adapters directly, perform this step first. However, if you prefer, you can omit this step and upgrade the adapters as part of the last step, in a host firmware package.
BMC—If you upgrade the adapters in the host firmware package, perform this step first.
I/O module.
Cisco UCS Manager.
Fabric interconnect.
Host firmware package—Must be the last step in the upgrade process. We recommend that you upgrade the board controller firmware during this step to avoid an addiitional reboot of the server. You must upgrade the BIOS and storage controller firmware in a host firmware package.
Adapter (interface card)—If you plan to upgrade the adapters directly, perform this step first. However, if you prefer, you can omit this step and upgrade the adapters as part of the last step, in a host firmware package.
BMC—If you upgrade the adapters in the host firmware package, perform this step first.
I/O module.
Fabric interconnect.
Cisco UCS Manager.
Host firmware package—Must be the last step in the upgrade process. We recommend that you upgrade the board controller firmware during this step to avoid an addiitional reboot of the server. You must upgrade the BIOS and storage controller firmware in a host firmware package.
When you perform a direct firmware upgrade on an endpoint, you can disrupt traffic or cause an outage in one or more of the endpoints in the Cisco UCS instance.
When you upgrade the firmware for a fabric interconnect, you cause the following outage impacts and disruptions:
A firmware upgrade to Cisco UCS Manager causes the following disruptions:
When you upgrade the firmware for an I/O module, you cause the following outage impacts and disruptions:
For a standalone configuration with a single fabric interconnect, data traffic is disrupted when the I/O module reboots. For a cluster configuration with two fabric interconnects, data traffic fails over to the other I/O module and the fabric interconnect in its data path.
If you activate the new firmware as the startup version only, the I/O module reboots when the corresponding fabric interconnect is rebooted
If you activate the new firmware as the running and startup version, the I/O module reboots immediately.
An I/O module can take up to ten minutes to become available after a firmware upgrade.
When you upgrade the firmware for a CIMC in a server, you impact only the CIMC and internal processes. You do not interrupt server traffic. This firmware upgrade causes the following outage impacts and disruptions to the CIMC:
If you activate the firmware for an adapter and do not configure the Set Startup Version Only option, you cause the following outage impacts and disruptions:
You can use service profiles to upgrade the server and adapter firmware, including the BIOS on the server, by defining the following policies and including them in the service profile associated with a server:
Note |
You cannot upgrade the firmware on an I/O module, fabric interconnect, or Cisco UCS Manager through service profiles. You must upgrade the firmware on those endpoints directly. |
This policy enables you to specify a set of firmware versions that make up the host firmware package (also known as the host firmware pack). The host firmware includes the following firmware for server and adapter endpoints:
Adapter Firmware Packages
Storage Controller Firmware Packages
Fibre Channel Adapters Firmware Packages
BIOS Firmware Packages
HBA Option ROM Packages
Board Controller Packages
Tip |
You can include more than one type of firmware in the same host firmware package. For example, a host firmware package can include both BIOS firmware and storage controller firmware or adapter firmware for two different models of adapters. However, you can only have one firmware version with the same type, vendor, and model number. The system recognizes which firmware version is required for an endpoint and ignores all other firmware versions. |
The firmware package is pushed to all servers associated with service profiles that include this policy.
This policy ensures that the host firmware is identical on all servers associated with service profiles which use the same policy. Therefore, if you move the service profile from one server to another, the firmware versions are maintained. Also, if you change the firmware version for an endpoint in the firmware package, new versions are applied to all the affected service profiles immediately, which could cause server reboots.
You must include this policy in a service profile, and that service profile must be associated with a server for it to take effect.
This policy is not dependent upon any other policies. However, you must ensure that the appropriate firmware has been downloaded to the fabric interconnect. If the firmware image is not available when Cisco UCS Manager is associating a server with a service profile, Cisco UCS Manager ignores the firmware upgrade and completes the association.
This policy enables you to specify a set of firmware versions that make up the management firmware package (also known as a management firmware pack). The management firmware package includes the Cisco Integrated Management Controller (CIMC) on the server. You do not need to use this package if you upgrade the CIMC directly.
The firmware package is pushed to all servers associated with service profiles that include this policy. This policy ensures that the CIMC firmware is identical on all servers associated with service profiles which use the same policy. Therefore, if you move the service profile from one server to another, the firmware versions are maintained.
You must include this policy in a service profile, and that service profile must be associated with a server for it to take effect.
This policy is not dependent upon any other policies. However, you must ensure that the appropriate firmware has been downloaded to the fabric interconnect.
You can use the host and management firmware package policies in service profiles to upgrade server and adapter firmware.
Caution |
If you modify a host firmware package by adding an endpoint or changing firmware versions for an existing endpoint, Cisco UCS Manager upgrades the endpoints and reboots all servers associated with that firmware package as soon as the changes are saved, disrupting data traffic to and from the servers. |
For a new service profile, this upgrade takes place over the following stages:
During this stage, you create the host and/or management firmware packages and include them in the appropriate firmware policies.
During this stage, you include the firmware packages in a service profile, and then associate the service profile with a server. The system pushes the selected firmware versions to the endpoints. For a host firmware package, the server is rebooted to ensure that the endpoints are running the versions specified in the firmware package.
If the service profile is already associated with a server, Cisco UCS Manager upgrades the firmware as soon as you save the changes to the host firmware packages. For a host firmware package, Cisco UCS Manager reboots the server as soon as the change is saved.
You downgrade firmware in a Cisco UCS instance in the same way that you upgrade firmware. The package or version that you select when you update the firmware determines whether you are performing an upgrade or a downgrade.
Completing the Prerequisites for Upgrading the Firmware
All endpoints in a Cisco UCS instance must be fully functional and all processes must be complete before you begin a firmware upgrade or downgrade on those endpoints. You cannot upgrade or downgrade an endpoint that is not in a functional state. For example, the firmware on a server that has not been discovered cannot be upgraded or downgraded. An incomplete process, such as an FSM that has failed after the maximum number of retries, can cause the upgrade or downgrade on an endpoint to fail. If an FSM is in progress, Cisco UCS Manager queues up the update and activation and runs them when the FSM has completed successfully.
Before you upgrade or downgrade firmware in a Cisco UCS instance, complete the following prerequisites:
Back up the configuration into an All Configuration backup file.
For a cluster configuration, verify that the high availability status of the fabric interconnects shows that both are up and running.
For a standalone configuration, verify that the Overall Status of the fabric interconnect is Operable.
Verify that all servers, I/O modules, and adapters are fully functional. An inoperable server cannot be upgraded.
Verify that all servers have been discovered. They do not need to be powered on or associated with a service profile.
Obtain the backup server IP address and authentication credentials.
The following example uses SCP to create an All Configuration backup file on the host named host35 and commits the transaction:
UCS-A# scope system UCS-A /system* # create backup scp://user@host35/backups/all-config.bak all-configuration enabled Password: UCS-A /system* # commit-buffer UCS-A /system #
If your Cisco UCS instance is running in a high availability cluster configuration, you must verify the operability of both fabric interconnects.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope fabric-interconnect {a | b} | Enters fabric interconnect mode for the specified fabric interconnect. |
Step 2 | UCS-A /fabric-interconnect # show | Displays information about the fabric interconnect. Verify that the operability of the fabric interconnects is in the Operable state. If the operability is not in the Operable state, run a show tech-support command and contact Cisco Technical Support. Do not proceed with the firmware upgrade. For more information about the show tech-support command, see the Cisco UCS Troubleshooting Guide. |
The following example displays that the operability for both fabric interconnects is in the Operable state:
UCS-A# scope fabric-interconnect a UCS-A /fabric-interconnect # show Fabric Interconnect: ID OOB IP Addr OOB Gateway OOB Netmask Operability -- --------------- --------------- --------------- ----------- A 192.168.100.10 192.168.100.20 255.255.255.0 Operable UCS-A /fabric-interconnect # exit UCS-A# scope fabric-interconnect b UCS-A /fabric-interconnect # show Fabric Interconnect: ID OOB IP Addr OOB Gateway OOB Netmask Operability -- --------------- --------------- --------------- ----------- B 192.168.100.11 192.168.100.20 255.255.255.0 Operable
The high availability status is the same for both fabric interconnects in a cluster configuration.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# show cluster state | Displays the operational state and leadership role for both fabric interconnects in a high availability cluster. Verify that both fabric interconnects (A and B) are in the Up state and HA is in the Ready state. If the fabric interconnects are not in the Up state or HA is not in the Ready state, run a show tech-support command and contact Cisco Technical Support. Do not proceed with the firmware upgrade. For more information about the show tech-support command, see the Cisco UCS Troubleshooting Guide. Also note which fabric interconnect has the primary role and which has the subordinate role; you will need to know this information to upgrade the firmware on the fabric interconnects. |
The following example displays that both fabric interconnects are in the Up state, HA is in the Ready state, fabric interconnect A has the primary role, and fabric interconnect B has the subordinate role:
UCS-A# show cluster state Cluster Id: 0x4432f72a371511de-0xb97c000de1b1ada4 A: UP, PRIMARY B: UP, SUBORDINATE HA READY
If your Cisco UCS is running in a high availability cluster configuration, you must verify the status for both I/O modules in all chassis.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope chassis chassis-id | Enters chassis mode for the specified chassis. |
Step 2 | UCS-A /chassis# scope iom iom-id | Enters chassis I/O module mode for the selected I/O module. |
Step 3 | UCS-A# show | Shows the status of the specified I/O module on the specified chassis. Verify that the overall status of the I/O module is in the Operable state. If the overall status is not in the Operable state, run a show tech-support command and contact Cisco Technical Support. Do not proceed with the firmware upgrade. For more information about the show tech-support command, see the Cisco UCS Troubleshooting Guide. |
The following example displays that the overall status for both I/O modules on chassis 1 is in the Operable state:
UCS-A# scope chassis 1 UCS-A /chassis # scope iom 1 UCS-A /chassis/iom # show IOM: ID Side Fabric ID Overall Status ---------- ----- --------- -------------- 1 Left A Operable UCS-A /chassis/iom # exit UCS-A /chassis # scope iom 2 UCS-A /chassis/iom # show IOM: ID Side Fabric ID Overall Status ---------- ----- --------- -------------- 2 Right B Operable
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope server chassis-id/server-id | Enters chassis server mode for the specified server in the specified chassis. |
Step 2 | UCS-A /chassis/server # show status detail | Shows the status detail of the server. Verify that the overall status of the server is Ok, Unavailable, or any value that does not indicate a failure. If the overall status is in a state that indicates a failure, such as Discovery Failed, the endpoints on that server cannot be upgraded. |
The following example displays that the overall status for server 7 on chassis 1 is in the Ok state:
UCS-A# scope server 1/7 UCS-A /chassis/server # show status detail Server 1/7: Slot Status: Equipped Conn Path: A,B Conn Status: A,B Managing Instance: B Availability: Unavailable Admin State: In Service Overall Status: Ok Oper Qualifier: N/A Discovery: Complete Current Task:
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope server chassis-id/server-id | Enters chassis server mode for the specified server in the specified chassis |
Step 2 | UCS-A /chassis/server # show adapter status | Displays the status of the adapter. Verify that the overall status of the adapter is in the Operable state. If the overall status of the adapter is in any state other than Operable, you cannot upgrade it. However, you can proceed with the upgrade for the other adapters in the Cisco UCS instance. |
The following example displays that the overall status for the adapter in server 7 on chassis 1 is in the Operable state:
UCS-A# scope server 1/7 UCS-A /chassis/server # show adapter status Server 1/1: Overall Status -------------- Operable
Downloading and Managing Images
Step 1 | In a web browser, navigate to http://www.cisco.com. |
Step 2 | Under Support, click Download Software. |
Step 3 | Click Unified Computing. |
Step 4 | Enter your Cisco.com username and password to log in. |
Step 5 |
Click Cisco Unified Computing System. If you prefer to download an image for a single component, expand the node for that component and click the link to the appropriate image. |
Step 6 | Click Unified Computing System (UCS) Complete Software Bundle. |
Step 7 |
Under the Latest Releases folder, click the link for the latest release of Cisco UCS. Images for earlier releases are archived under the All Releases link. |
Step 8 | Click the Release Notes link to download the latest version of the Release Notes. |
Step 9 | Click one of the following buttons and follow the instructions provided: |
Step 10 | Follow the prompts to complete your download of the image. |
Step 11 | Read the release notes before upgrading the Cisco UCS instance. |
Download the firmware image to the fabric interconnect.
The following example uses SCP to download the ucs-k9-bundle.1.0.0.988.gbin firmware package.
UCS-A# scope firmware UCS-A /firmware # download image scp://user1@192.168.10.10/images/ucs-k9-bundle.1.0.0.988.gbin
Display the download status to confirm that the firmware package has completely downloaded, and then directly update the firmware at the endpoints.
After a firmware download operation has been started, you can check the download status to see if the package is still downloading or if it has completely downloaded.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope firmware | Enters firmware mode. |
Step 2 | UCS-A /firmware # show download-task | Displays the status for your download task. When your image is completely downloaded, the task state changes from Downloading to Downloaded. The CLI does not automatically refresh, so you may have to enter the show download-task command multiple times until the task state displays Downloaded. |
The following example displays the download status for the ucs-k9-bundle.1.0.0.988.gbin firmware package. The show download-task command is entered multiple times until the download state indicates that the firmware package has been downloaded:
UCS-A# scope firmware UCS-A /firmware # show download-task Download task: File Name Protocol Server Userid State --------- -------- --------------- --------------- ----- ucs-k9-bundle.1.0.0.988.gbin Scp 10.193.32.11 user1 Downloading UCS-A /firmware # show download-task Download task: File Name Protocol Server Userid State --------- -------- --------------- --------------- ----- ucs-k9-bundle.1.0.0.988.gbin Scp 10.193.32.11 user1 Downloading UCS-A /firmware # show download-task Download task: File Name Protocol Server Userid State --------- -------- --------------- --------------- ----- ucs-k9-bundle.1.0.0.988.gbin Scp 10.193.32.11 user1 Downloaded
This procedure is optional and displays the available software images on the fabric interconnect for all endpoints.. You can also use the show image command in each endpoint mode to display the available software images for that endpoint.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCS-A# scope firmware | Enters firmware mode. |
||
Step 2 | UCS-A /firmware # show image | Displays all software images downloaded onto the fabric interconnect.
|
The following example displays all available software images on the fabric interconnect:
UCS-A# scope firmware UCS-A /firmware # show image Name Type Version ------------------------------------------------------- -------------------- ------- ucs-2100.1.0.0.988.gbin Iom 1.0(0.988) ucs-6100-k9-kickstart.4.0.1a.N2.1.0.988.gbin Switch Kernel 4.0(1a)N2(1.0.988) ucs-6100-k9-system.4.0.1a.N2.1.0.988.gbin Switch Software 4.0(1a)N2(1.0.988) ucs-b200-m1-bios.S5500.86B.01.00.0030-978a.021920.gbin Server Bios S5500.86B.01.00.0030-978a.021920 ucs-b200-m1-k9-bmc.1.0.0.988.gbin Bmc 1.0(0.988) ucs-b200-m1-sasctlr.2009.02.09.gbin Storage Controller 2009.02.09 ucs-m71kr-e-cna.1.0.0.988.gbin Adapter 1.0(0.988) ucs-m71kr-e-hba.zf280a4.gbin Host Hba zf280a4 ucs-m71kr-e-optionrom.ZN502N5.gbin Host Hba Optionrom ZN502N5 ucs-m71kr-q-cna.1.0.0.988.gbin Adapter 1.0(0.988) ucs-m71kr-q-optionrom.1.69.gbin Host Hba Optionrom 1.69 ucs-m81kr-vic.1.0.0.988.gbin Adapter 1.0(0.988) ucs-manager-k9.1.0.0.988.gbin System 1.0(0.988)
Directly Upgrading Firmware at Endpoints
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope adapter chassis-id/ blade-id/adapter-id | Enters chassis server adapter mode for the specified adapter. |
Step 2 | UCS-A /chassis/server/adapter # show image | Displays the available software images for the adapter. |
Step 3 | UCS-A /chassis/server/adapter # update firmware version-num | Updates the selected firmware version on the adapter. |
Step 4 | UCS-A /chassis/server/adapter # commit-buffer | (Optional) Commits the transaction. Use this step only if you intend to use the show firmware command in Step 5 to verify that the firmware update completed successfully before activating the firmware in Step 6. You can skip this step and commit the update-firmware and activate-firmware commands in the same transaction; however, if the firmware update does not complete successfully, the firmware activation will not start. Cisco UCS Manager copies the selected firmware image to the backup memory partition and verifies that image is not corrupt. The image remains as the backup version until you explicitly activate it. |
Step 5 | UCS-A /chassis/server/adapter # show firmware | (Optional) Displays the status of the firmware update. Use this step only if you want to verify that the firmware update completed successfully. The firmware update is complete when the update status is Ready. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Updating to Ready. Continue to Step 6 when the update status is Ready. |
Step 6 | UCS-A /chassis/server/adapter # activate firmware version-num [ignorecompcheck [set-startup-only] | set-startup-only] | Activates the selected firmware version on the adapter. Use the set-startup-only keyword if you want to move the activated firmware into the pending-next-boot state and not immediately reboot the server. The activated firmware does not become the running version of firmware on the adapter until the server is rebooted. You cannot use the set-startup-only keyword for an adapter in the host firmware package. Use the ignorecompcheck keyword if you want to ignore the compatibility check and activate the firmware regardless of any possible incompatibilities or currently executing tasks. |
Step 7 | UCS-A /chassis/server/adapter # commit-buffer | Commits the transaction. |
Step 8 | UCS-A /chassis/server/adapter # show firmware | (Optional) Displays the status of the firmware activation. Use this step only if you want to verify that the firmware activation completed successfully. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Activating to Ready. |
The following example updates and activates the adapter firmware to version 1.2(1) in the same transaction, without verifying that the firmware update and firmware activation completed successfully:
UCS-A# scope adapter 1/1/1 UCS-A# /chassis/server/adapter # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-m81kr-vic.1.2.1.gbin Adapter 1.2(1) Active UCS-A# /chassis/server/adapter # update firmware 1.2(1) UCS-A# /chassis/server/adapter* # activate firmware 1.2(1) ignorecompcheck set-startup-only UCS-A# /chassis/server/adapter* # commit-buffer UCS-A# /chassis/server/adapter #
The following example updates the adapter firmware to version 1.2(1), verifies that the firmware update completed successfully before starting the firmware activation, activates the adapter firmware, and verifies that the firmware activation completed successfully:
UCS-A# scope adapter 1/1/1 UCS-A# /chassis/server/adapter # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-m81kr-vic.1.2.1.gbin Adapter 1.2(1) Active UCS-A# /chassis/server/adapter # update firmware 1.2(1) UCS-A# /chassis/server/adapter* # commit-buffer UCS-A# /chassis/server/adapter # show firmware Adapter 1: Running-Vers: 1.1(1) Update-Status: Updating Activate-Status: Ready UCS-A# /chassis/server/adapter # show firmware Adapter 1: Running-Vers: 1.1(1) Update-Status: Ready Activate-Status: Ready UCS-A# /chassis/server/adapter # activate firmware 1.2(1) ignorecompcheck UCS-A# /chassis/server/adapter* # commit-buffer UCS-A# /chassis/server/adapter # show firmware Adapter 1: Running-Vers: 1.1(1) Update-Status: Ready Activate-Status: Activating UCS-A# /chassis/server/adapter # show firmware Adapter 1: Running-Vers: 1.2(1) Update-Status: Ready Activate-Status: Ready
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope server chassis-id / blade-id | Enters chassis server mode for the specified server. |
Step 2 | UCS-A /chassis/server # scope cimc | Enters chassis server CIMC mode. |
Step 3 | UCS-A /chassis/server/cimc # show image | Displays the available software images for the adapter. |
Step 4 | UCS-A /chassis/server/cimc # update firmware version-num | Updates the selected firmware version on the CIMC in the server. |
Step 5 | UCS-A /chassis/cimc # commit-buffer | (Optional) Commits the transaction. Use this step only if you intend to use the show firmware command in Step 6 to verify that the firmware update completed successfully before activating the firmware in Step 7. You can skip this step and commit the update-firmware and activate-firmware commands in the same transaction; however, if the firmware update does not complete successfully, the firmware activation will not start. Cisco UCS Manager copies the selected firmware image to the backup memory partition and verifies that image is not corrupt. The image remains as the backup version until you explicitly activate it. |
Step 6 | UCS-A /chassis/cimc # show firmware | (Optional) Displays the status of the firmware update. Use this step only if you want to verify that the firmware update completed successfully. The firmware update is complete when the update status is Ready. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Updating to Ready. Continue to Step 7 when the update status is Ready. |
Step 7 | UCS-A /chassis/server/cimc # activate firmware version-num [ignorecompcheck] | Activates the selected firmware version on the CIMC in the server. Use the ignorecompcheck keyword if you want to ignore the compatibility check and activate the firmware regardless of any possible incompatibilities or currently executing tasks. |
Step 8 | UCS-A /chassis/server/cimc # commit-buffer | Commits the transaction. |
Step 9 | UCS-A /chassis/cimc # show firmware | (Optional) Displays the status of the firmware activation. Use this step only if you want to verify that the firmware activation completed successfully. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Activating to Ready. |
The following example updates and activates the CIMC firmware to version 1.2(1) in the same transaction, without verifying that the firmware update and firmware activation completed successfully:
UCS-A# scope server 1/1 UCS-A# /chassis/server # scope cimc UCS-A# /chassis/server/cimc # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-b200-m1-k9-cimc.1.2.1.gbin Bmc 1.2(1) Active UCS-A# /chassis/server/cimc # update firmware 1.2(1) UCS-A# /chassis/server/cimc* # activate firmware 1.2(1) ignorecompcheck set-startup-only UCS-A# /chassis/server/cimc* # commit-buffer UCS-A# /chassis/server/cimc #
The following example updates the CIMC firmware to version 1.2(1), verifies that the firmware update completed successfully before starting the firmware activation, activates the CIMC firmware, and verifies that the firmware activation completed successfully:
UCS-A# scope server 1/1 UCS-A# /chassis/server # scope cimc UCS-A# /chassis/server/cimc # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-b200-m1-k9-cimc.1.2.1.gbin Bmc 1.2(1) Active UCS-A# /chassis/server/cimc # update firmware 1.2(1) UCS-A# /chassis/server/cimc* # commit-buffer UCS-A# /chassis/server/cimc # show firmware Running-Vers Update-Status Activate-Status --------------- --------------- --------------- 1.1(1) Updating Ready UCS-A# /chassis/server/cimc # show firmware Running-Vers Update-Status Activate-Status --------------- --------------- --------------- 1.1(1) Ready Ready UCS-A# /chassis/server/cimc # activate firmware 1.2(1) ignorecompcheck UCS-A# /chassis/server/cimc* # commit-buffer UCS-A# /chassis/server/cimc # show firmware Running-Vers Update-Status Activate-Status --------------- --------------- --------------- 1.1(1) Ready Activating UCS-A# /chassis/server/cimc # show firmware Running-Vers Update-Status Activate-Status --------------- --------------- --------------- 1.2(1) Ready Ready
If your system is running in a high availability cluster configuration, you must update and activate both I/O modules.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope chassis chassis-id | Enters chassis mode for the specified chassis. |
Step 2 | UCS-A /chassis # scope iom iom-id | Enters chassis I/O module mode for the selected I/O module. |
Step 3 | UCS-A /chassis/iom # show image | Displays the available software images for the I/O module. |
Step 4 | UCS-A /chassis/iom # update firmware version-num | Updates the selected firmware version on the I/O module. |
Step 5 | UCS-A /chassis/iom # commit-buffer | (Optional) Commits the transaction. Use this step only if you intend to use the show firmware command in Step 6 to verify that the firmware update completed successfully before activating the firmware in Step 7. You can skip this step and commit the update-firmware and activate-firmware commands in the same transaction; however, if the firmware update does not complete successfully, the firmware activation will not start. Cisco UCS Manager copies the selected firmware image to the backup memory partition and verifies that image is not corrupt. The image remains as the backup version until you explicitly activate it. |
Step 6 | UCS-A /chassis/iom # show firmware | (Optional) Displays the status of the firmware update. Use this step only if you want to verify that the firmware update completed successfully. The firmware update is complete when the update status is Ready. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Updating to Ready. Continue to Step 7 when the update status is Ready. |
Step 7 | UCS-A /chassis/iom # activate firmware version-num [ignorecompcheck [set-startup-only] | set-startup-only] | Activates the selected firmware version on the I/O module. Use the set-startup-only keyword if you want to reboot the I/O module only when the fabric interconnect in its data path reboots. If you do not use the set-startup-only keyword, the I/O module reboots and disrupts traffic. In addition, if Cisco UCS Manager detects a protocol and firmware version mismatch between it and the I/O module, it updates the I/O module with the firmware version that matches its own and then activates the firmware and reboots the I/O module again. Use the ignorecompcheck keyword if you want to ignore the compatability check and activate the firmware regardless of any possible incompatibilities or currently executing tasks. |
Step 8 | UCS-A /chassis/iom # commit-buffer | Commits the transaction. |
Step 9 | UCS-A /chassis/iom # show firmware | (Optional) Displays the status of the firmware activation. Use this step only if you want to verify that the firmware activation completed successfully. The CLI does not automatically refresh, so you may have to enter the show firmware command multiple times until the task state changes from Activating to Ready. |
The following example updates and activates the I/O module firmware to version 1.2(1) in the same transaction, without verifying that the firmware update and firmware activation completed successfully:
UCS-A# scope chassis 1 UCS-A# /chassis # scope iom 1 UCS-A# /chassis/iom # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-2100.1.2.1.gbin Iom 1.2(1) Active UCS-A# /chassis/iom # update firmware 1.2(1) UCS-A# /chassis/iom* # activate firmware 1.2(1) ignorecompcheck set-startup-only UCS-A# /chassis/iom* # commit-buffer UCS-A# /chassis/iom #
The following example updates the I/O module firmware to version 1.2(1), verifies that the firmware update completed successfully before starting the firmware activation, activates the I/O module firmware, and verifies that the firmware activation completed successfully:
UCS-A# scope chassis 1 UCS-A# /chassis # scope iom 1 UCS-A# /chassis/iom # show image Name Type Version State -------------------------------------------------- -------------------- ------------- ----- ucs-2100.1.2.1.gbin Iom 1.2(1) Active UCS-A# /chassis/iom # update firmware 1.2(1) UCS-A# /chassis/iom* # commit-buffer UCS-A# /chassis/iom # show firmware IOM Fabric ID Running-Vers Update-Status Activate-Status -------- --------- --------------- --------------- --------------- 1 A 1.1(1) Updating Ready UCS-A# /chassis/iom # show firmware IOM Fabric ID Running-Vers Update-Status Activate-Status -------- --------- --------------- --------------- --------------- 1 A 1.1(1) Ready Ready UCS-A# /chassis/iom # activate firmware 1.2(1) ignorecompcheck UCS-A# /chassis/iom* # commit-buffer UCS-A# /chassis/iom # show firmware IOM Fabric ID Running-Vers Update-Status Activate-Status -------- --------- --------------- --------------- --------------- 1 A 1.1(1) Ready Activating UCS-A# /chassis/iom # show firmware IOM Fabric ID Running-Vers Update-Status Activate-Status -------- --------- --------------- --------------- --------------- 1 A 1.2(1) Ready Ready
Only certain servers, such as the Cisco UCS B440 High Performance blade server, have board controller firmware. The board controller firmware controls the algorithms for functions such as lighting the front panel LEDs on the server.
Note |
This activation procedure causes the server to reboot immediately. To reduce the number of times a server needs to be rebooted during the upgrade process, we recommend that you upgrade the board controller firmware through the host firmware package in the service profile. |
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope server chassis-id/server-id | Enters chassis server mode for the specified server. |
Step 2 | UCS-A /chassis/server #scope boardcontroller | Enters board controller mode for the server. |
Step 3 | UCS-A /chassis/server/boardcontroller # show image | (Optional) Displays the available software images for the board controller. |
Step 4 | UCS-A /chassis/server/boardcontroller # show firmware | (Optional) Displays the current running software image for the board controller. |
Step 5 | UCS-A /chassis/server/boardcontroller # activate firmware version-num [ignorecompcheck] | Activates the selected firmware version on the board controller in the server. Use the ignorecompcheck keyword if you want to ignore the compatibility check and activate the firmware regardless of any possible incompatibilities or currently executing tasks. |
Step 6 | UCS-A /chassis/server/boardcontroller # commit-buffer | Commits the transaction to the system configuration. |
Cisco UCS Manager disconnects all active sessions, logs out all users, and then activates the software. When the upgrade is complete, you are prompted to log back in.
The following example activates the board controller firmware:
UCS-A# scope server 1/1 UCS-A# /chassis/server # scope boardcontroller UCS-A# /chassis/server/boardcontroller # show image Name Type Version State -------------------------------------- ----------------- ------------------ ----- ucs-b440-m1-pld.B440100C-B4402006.bin Board Controller B440100C-B4402006 Active UCS-A# /chassis/server/boardcontroller # show firmware BoardController: Running-Vers: B440100C-B4402006 Activate-Status: Ready UCS-A# /chassis/server/boardcontroller # activate firmware B440100C-B4402006 ignorecompcheck UCS-A# /chassis/server/boardcontroller* # commit-buffer
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCS-A# scope system | Enters system mode. |
||
Step 2 | UCS-A /system # show image | Displays the available software images for Cisco UCS Manager (system). |
||
Step 3 | UCS-A /system # activate firmware version-num [ignorecompcheck] | Activates the selected firmware version on the system. Use the ignorecompcheck keyword if you want to ignore the compatibility check and activate the firmware regardless of any possible incompatibilities or currently executing tasks.
|
||
Step 4 | UCS-A /system # commit-buffer | Commits the transaction. Cisco UCS Manager makes the selected version the startup version and schedules the activation to occur when the fabric interconnects are upgraded. |
The following example upgrades Cisco UCS Manager to version 1.2(1) and commits the transaction:
UCS-A# scope system UCS-A# /system # show image Name Type Version State -------------------------------------------------- ---------------- ----------- ----- ucs-manager-k9.1.2.1.gbin System 1.2(1) Active UCS-A# /system # activate firmware 1.2(1) UCS-A# /system* # commit-buffer UCS-A# /system #
When updating the firmware on two fabric interconnects in a high availability cluster configuration, you must activate the subordinate fabric interconnect before activating the primary fabric interconnect. For more information about determining the role for each fabric interconnect, see Verifying the High Availability Status and Roles of a Cluster Configuration.
Tip |
If you ever need to recover the password to the admin account that was created when you configured the fabric interconnects for the Cisco UCS instance, you must know the running kernel version and the running system version. If you do not plan to create additional accounts, we recommend that you save the path to these firmware versions in a text file so that you can access them if required. |
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope fabric-interconnect {a | b} | Enters fabric interconnect mode for the specified fabric interconnect. |
Step 2 | UCS-A /fabric-interconnect # show image | Displays the available software images for the fabric interconnect. |
Step 3 | UCS-A /fabric-interconnect # activate firmware {kernel-version kernel-ver-num | system-version system-ver-num} | Activates the selected firmware version on the fabric interconnect. |
Step 4 | UCS-A /fabric-interconnect # commit-buffer | Commits the transaction. Cisco UCS Manager updates and activates the firmware, and then reboots the fabric interconnect and any I/O module in the data path to that fabric interconnect, disrupting data traffic to and from that fabric interconnect. |
The following example upgrades the fabric interconnect to version 4.0(1a)N2(1.2.1) and commits the transaction:
UCS-A# scope fabric-interconnect a UCS-A /fabric-interconnect # show image Name Type Version State --------------------------------------------- -------------------- ----------------- ----- ucs-6100-k9-kickstart.4.0.1a.N2.1.2.1.gbin Fabric Interconnect 4.0(1a)N2(1.2.1) Active ucs-6100-k9-system.4.0.1a.N2.1.2.1.gbin Fabric Interconnect 4.0(1a)N2(1.2.1) Active UCS-A /fabric-interconnect # activate firmware kernel-version 4.0(1a)N2(1.2.1) system-version 4.0(1a)N2(1.2.1) UCS-A /fabric-interconnect* # commit-buffer UCS-A /fabric-interconnect #
Updating Firmware through Service Profiles
This policy enables you to specify a set of firmware versions that make up the host firmware package (also known as the host firmware pack). The host firmware includes the following firmware for server and adapter endpoints:
Adapter Firmware Packages
Storage Controller Firmware Packages
Fibre Channel Adapters Firmware Packages
BIOS Firmware Packages
HBA Option ROM Packages
Board Controller Packages
Tip |
You can include more than one type of firmware in the same host firmware package. For example, a host firmware package can include both BIOS firmware and storage controller firmware or adapter firmware for two different models of adapters. However, you can only have one firmware version with the same type, vendor, and model number. The system recognizes which firmware version is required for an endpoint and ignores all other firmware versions. |
The firmware package is pushed to all servers associated with service profiles that include this policy.
This policy ensures that the host firmware is identical on all servers associated with service profiles which use the same policy. Therefore, if you move the service profile from one server to another, the firmware versions are maintained. Also, if you change the firmware version for an endpoint in the firmware package, new versions are applied to all the affected service profiles immediately, which could cause server reboots.
You must include this policy in a service profile, and that service profile must be associated with a server for it to take effect.
This policy is not dependent upon any other policies. However, you must ensure that the appropriate firmware has been downloaded to the fabric interconnect. If the firmware image is not available when Cisco UCS Manager is associating a server with a service profile, Cisco UCS Manager ignores the firmware upgrade and completes the association.
Caution |
If the policy is included in one or more service profiles associated with a server, Cisco UCS Manager updates and activates the firmware in the server and adapter with the new versions and reboots the server as soon as you save the host firmware package policy. |
Ensure that the appropriate firmware has been downloaded to the fabric interconnect.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 2 | UCS-A org/ # create fw-host-pack pack-name | Creates a host firmware package with the specified package name and enters organization firmware host package mode. |
||
Step 3 | UCS-A /org/fw-host-pack # set descr description | (Optional) Provides a description for the host firmware package.
|
||
Step 4 | UCS-A org/fw-host-pack # create pack-image hw-vendor-name hw-model{adapter | host-hba | host-hba-combined | host-hba-optionrom | host-nic | server-bios | storage-controller | unspecified} version-num | Creates a package image for the host firmware package and enters organization firmware host package image mode. The hw-vendor-name and hw-model values are labels that help you easily identify the package image when you enter the show image detail command. The version-num value specifies the version number of the firmware being used for the package image. The firmware version must match the model numbers (PID) on the servers that are associated with this firmware pack. If you select a firmware version with the wrong model number, Cisco UCS Manager cannot install the firmware update. |
||
Step 5 | UCS-A org/fw-host-pack/pack-image # set version version-num | (Optional) Specifies the package image version number. Changing this number triggers firmware updates on all components using the firmware through a service profile. Use this step only when updating a host firmware package, not when creating a package.
|
||
Step 6 | UCS-A org/fw-host-pack/pack-image # commit-buffer | Commits the transaction. Cisco UCS Manager verifies the model numbers and vendor against all servers associated with service profiles that include this policy. If the model numbers and vendor match a firmware version in the policy, Cisco UCS Manager updates the firmware. |
The following example creates the app1 host firmware package, creates a storage controller package image with version 2009.02.09 firmware, and commits the transaction:
UCS-A# scope org / UCS-A /org # create fw-host-pack app1 UCS-A /org/fw-host-pack* # set descr "This is a host firmware package example." UCS-A /org/fw-host-pack* # create pack-image Cisco UCS storage-controller 2009.02.09 UCS-A /org/fw-host-pack/pack-image* # commit-buffer UCS-A /org/fw-host-pack/pack-image #
Include the policy in a service profile and/or template.
This policy enables you to specify a set of firmware versions that make up the management firmware package (also known as a management firmware pack). The management firmware package includes the Cisco Integrated Management Controller (CIMC) on the server. You do not need to use this package if you upgrade the CIMC directly.
The firmware package is pushed to all servers associated with service profiles that include this policy. This policy ensures that the CIMC firmware is identical on all servers associated with service profiles which use the same policy. Therefore, if you move the service profile from one server to another, the firmware versions are maintained.
You must include this policy in a service profile, and that service profile must be associated with a server for it to take effect.
This policy is not dependent upon any other policies. However, you must ensure that the appropriate firmware has been downloaded to the fabric interconnect.
Caution |
If the policy is included in a one or more service profiles associated with a server, as soon as you save the management firmware package policy, Cisco UCS Manager updates and activates the CIMC firmware in the server with the new version. |
Ensure that the appropriate firmware has been downloaded to the fabric interconnect.
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 2 | UCS-A org/ # create fw-mgmt-pack pack-name | Creates a management firmware package with the specified package name and enters organization firmware management package mode. |
||
Step 3 | UCS-A /org/fw-mgmt-pack # set descr description | (Optional) Provides a description for the management firmware package.
|
||
Step 4 | UCS-A org/fw-mgmt-pack # create pack-image hw-vendor-name hw-model bmc version-num | Creates a package image for the management firmware package and enters organization firmware management package image mode. The hw-vendor-name and hw-model values are labels that help you easily identify the package image when you enter the show image detail command. The version-num value specifies the version number of the firmware being used for the package image. The firmware version must match the model numbers (PID) on the servers that are associated with this firmware pack. If you select a firmware version with the wrong model number, Cisco UCS Manager cannot install the firmware update. |
||
Step 5 | UCS-A org/fw-mgmt-pack/pack-image # set version version-num | (Optional) Specifies the package image version number. Changing this number triggers firmware updates on all components using the firmware through a service profile. Use this step only when updating a firmware package, not when creating a package. |
||
Step 6 | UCS-A org/fw-mgmt-pack/pack-image # commit-buffer | Commits the transaction. Cisco UCS Manager verifies the model numbers and vendor against all servers associated with service profiles that include this policy. If the model numbers and vendor match a firmware version in the policy, Cisco UCS Manager updates the firmware. |
The following example creates the cimc1 host firmware package, creates a CIMC package image with version 1.0(0.988) firmware, and commits the transaction:
UCS-A# scope org / UCS-A /org # create fw-mgmt-pack cimc1 UCS-A /org/fw-mgmt-pack* # set descr "This is a management firmware package example." UCS-A /org/fw-mgmt-pack* # create pack-image Cisco UCS cimc 1.0(0.988) UCS-A /org/fw-mgmt-pack/pack-image* # commit-buffer UCS-A /org/fw-mgmt-pack/pack-image #
Include the policy in a service profile and/or template.
Managing the Capability Catalog
The capability catalog is a set of tunable parameters, strings, and rules. Cisco UCS Manager 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 manufacture and the form factor.
The contents of the capability catalog include the following:
Each Cisco UCS Manager release contains a baseline catalog. When appropriate, Cisco releases an update to the capability catalog and makes it available on the same site where you download firmware images. The catalog update is compatible with Cisco UCS, Release 1.3(1) and above.
As soon as you download a capability catalog update, Cisco UCS Manager 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 any component in the Cisco UCS instance, or reinstall Cisco UCS Manager.
Step 1 | In a web browser, navigate to http://www.cisco.com. |
Step 2 | Under Support, click Download Software. |
Step 3 | Click Unified Computing. |
Step 4 | Enter your Cisco.com username and password to log in. |
Step 5 | Click Cisco Unified Computing System. |
Step 6 | Click Unified Computing System (UCS) Manager Capability Catalog. |
Step 7 |
Under the Latest Releases folder, click the link for the latest release of the capability catalog. Images for earlier releases are archived under the All Releases link. |
Step 8 | Click one of the following buttons and follow the instructions provided: |
Step 9 | Follow the prompts to complete your download of the catalog update. |
Update the capability catalog.
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 immediately updates the capability catalog. You do not need to reboot any hardware components or perform any other tasks for the update to take effect.
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.1.0.0.4.bin Password: UCS-A /system/capability # show version Catalog: Update Version: 1.0(0.4) UCS-A /system/capability # show cat-updater Catalog Updater: File Name Protocol Server Userid Status --------- -------- --------------- --------------- ------ ucs-catalog.1.0.0.4.bin Scp 192.0.2.111 user1 Success UCS-A /system/capability #
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 Catalog Updater: File Name Protocol Server Userid Status --------- -------- --------------- --------------- ------ ucs-catalog.1.0.0.4.bin Scp 192.0.2.111 user1 Failed UCS-A /system/capability # scope cat-updater ucs-catalog.1.0.0.4.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 #
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 Revision ------------------------ ------------------------ -------- Cisco Systems, Inc. N10-FAN1 0 Cisco Systems, Inc. N10-FAN2 0 Cisco Systems, Inc. N20-FAN5 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 #