22.27. hpe-support - HPE Support¶
The following documentation is for HPE Support (hpe-support) content package at version v4.12.0-alpha00.78+gc037aaa40eb3ad853690ce178f9ab8a5bae4c436.
22.27.1. Object Specific Documentation¶
22.27.1.1. params¶
The content package provides the following params.
22.27.1.1.1. hpe-firmware-token¶
HPE requires that you have a valid support contract to download firmware updates for their ProLiant servers. This token, which can be generated at <https://support.hpe.com/hpsc/swd/entitlement-token-service/generate> is required to be able to download updates from the firmware update repositories
22.27.1.1.2. hpe-ilo-unwedge-count¶
This tracks the number of times the system has needed to unwedge the ilo while configuring the machine.
22.27.1.1.3. hpe-ilorest-configuration¶
This parameter defines a list of templates that should be applied to the system in order.
The template field is a string that references a name of a template in the system to render. The content field is a string that is the data to apply to the system. The method field is a string that is either rawpatch or load. It dictates which method of ilorest should be used.
An item should have a template or a content field, but not both.
22.27.1.1.4. hpe-repo-urls¶
HPE systems require some base tooling to fully enable remote management and low-level hardware management. The repository that this URL points at should provide the HP SUM tooling and the SSA tooling for managing RAID controllers. You can use the usual YUM variables here, along with “$hpe_gen” for generation specific tooling.
22.27.1.1.5. hpe-repo-versions¶
Depending on your update and audit requirements, you may not want to track the current release of the HPE tooling and firmware update bundles. This param allows you to override the versions of the tooling you are using on a repo by repo basis.
If an enrty is omitted, it will default to ‘current’.
22.27.1.1.6. hpe-system-gen¶
This tracks the generation of HPE ProLiant gear that the running system is. We do this because HPE organizes their tooling and firmware updates according to the system generation.
Current known generations are:
g7
gen8
gen9
gen10
Generation will be determined automatically using the following code:
dmidecode |gawk ‘match($0, /Product Name:.* ([Gg]7|[Gg]en[0-9]+)/, m) { print tolower(m[1]); exit}’
22.27.1.2. tasks¶
The content package provides the following tasks.
22.27.1.2.1. hpe-ilo-reset¶
HPE iLOs have a tendancy to get stuck, and not function correctly in many situations. If you are having issues configuring the HPE iLO, you may need to run this recovery task to ensure you reset the iLO back to a known good working state.
- !!! note
This workflow RESETS the HPE iLO to the Param specified username and password pair in the “ipmi/username” and “ipmi/password” Params. If no values are specified, the iLO will not add a new user to the iLO.
22.27.1.2.2. hpe-ilorest-config¶
This task provides a function that will use ilorest to apply a set of files iteratively. This will keep track of errors and if the system needs to reboot or the ilo needs to be rebooted.
Each entry in the hpe-ilorest-configuration parameter will be applied. The final actions will be reboot the ilo and wait for it to come back. The system will be rebooted if needed.
The task assumes that it can be run repeatedly and that ilorest will notify if changes are needed.
22.27.1.2.3. hpe-ilorest-inventory¶
This task provides a function that will use ilorest to gather inventory information for firmware versions.
This will populate the flash-inventory parameter.
22.27.1.2.4. hpe-tools-install¶
Install HPE tooling from appropriate yum repositories