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:
You can use firmware packages in service profiles to upgrade the server firmware, including the BIOS on the server, by defining a host firmware policy and including it in the service profile associated with a server.
You cannot upgrade the firmware on the CMC, shared adapter, storage controller, board controller, fabric interconnect, or Cisco UCS Manager through service profiles. You must upgrade the firmware on those endpoints directly.
Note | Cisco UCS no longer supports the creation of new management firmware packages. You can modify and update existing management firmware packages, if desired. However, we recommend that you remove the management firmware packages from all service profiles and use host firmware packages to update the Cisco Integrated Management Controller (CIMC) on the servers. |
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 package includes the following firmware for server endpoints:
Tip | You can include more than one type of firmware in the same host firmware package. For example, a host firmware package can include the BIOS firmware, CIMC firmware, and board controller firmware. 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.
Note | Cisco UCS no longer supports the creation of new management firmware packages. You can modify and update existing management firmware packages, if desired. However, we recommend that you remove the management firmware packages from all service profiles and use host firmware packages to update the Cisco Integrated Management Controller (CIMC) on the servers. |
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 firmware package policies in service profiles to upgrade server and adapter firmware.
Caution | Unless you have configured and scheduled a maintenance window, 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 firmware packages.
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. The server must be rebooted to ensure that the endpoints are running the versions specified in the firmware package.
For service profiles that are associated with servers, Cisco UCS Manager upgrades the firmware and reboots the server as soon as you save the changes to the firmware packages unless you have configured and scheduled a maintenance window. If you configure and schedule a maintenance window, Cisco UCS Manager defers the upgrade and server reboot until then.
To update firmware through a firmware package in a service profile, you need to update the firmware in the package. What happens after you save the changes to a firmware package depends upon how the Cisco UCS domain is configured.
The following table describes the most common options for upgrading servers with a firmware package in a service profile.
If the policy is included in one or more service profiles associated with a server and those service profiles do not include maintenance policies, 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 unless you have configured and scheduled a maintenance window.
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. |
Ensure that the appropriate firmware was 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 | board-controller | cimc | graphics-card | host-hba | host-hba-optionrom | host-nic | local-disk | raid-controller | server-bios} version-num |
Creates a package image for the host firmware package and enters organization firmware host package image mode. The hw-vendor-name must match the full name of the vendor, and must begin and end with quotation marks. 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 host-hba and host-hba-optionrom options are not supported by Cisco UCS M-Series Servers. The model and model number (PID) must match the servers that are associated with this firmware package. If you select the wrong model or 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 according to the settings in the maintenance policies included in the service profiles. |
The following example creates the app1 host firmware package, creates a BIOS package image, 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 Systems Inc" N20-AQ0102 bios UCSME.142M4.2.0.100.52.122920140321 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.
Note | Cisco UCS no longer supports the creation of new management firmware packages. You can modify and update existing management firmware packages, if desired. However, we recommend that you remove the management firmware packages from all service profiles and use host firmware packages to update the Cisco Integrated Management Controller (CIMC) on the servers. |
If the policy is included in one or more service profiles associated with a server and those service profiles do not include maintenance policies, Cisco UCS Manager updates and activates the management firmware in the server with the new versions and reboots the server as soon as you save the management firmware package policy unless you have configured and scheduled a maintenance window.
Ensure that the appropriate firmware was 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/ # scope fw-mgmt-pack pack-name |
Scope to 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" cimc "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 model and model number (PID) must match the servers that are associated with this firmware package. If you select the wrong model or 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 according to the settings in the maintenance policies included in the service profiles. |
The following example updates 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 # scope 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 Systems Inc" "SB-1600-CTRL" cimc "2.3(200.166)" 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.