V1.6.2: ReadMe

Mon, 01 Jan 0001 00:00:00 +0000

Terraform Provider for RedFish

The Terraform Provider for RedFish allows data center and IT administrators to use Hashicorp Terraform to automate and orchestrate the provisioning and management of PowerEdge servers.

The Terraform Provider can be used to manage server power cycles, IDRAC attributes, BIOS attributes, virtual media, storage volumes, user support, and firmware updates on the server.

Support

For any Terraform Provider for RedFish issues, questions or feedback, please follow our support process

License

The Terraform Provider for RedFish is released and licensed under the MPL-2.0 license. See LICENSE for the full terms.

Prerequisites

Terraform Provider	iDRAC9 Firmware Version	iDRAC10 Firmware Version	OS	Terraform	Golang
v1.6.2	6.x 7.x	1.20.25.x	ubuntu22.04 rhel9.x	1.14.x 1.15.x	1.26

List of DataSources in Terraform Provider for RedFish

System Configuration and Management

Authentication and Security

Storage Management

Virtual Media

Virtual Media

List of Resources in Terraform Provider for RedFish

System Configuration and Management

Authentication and Security

Firmware and Updates

Dell iDRAC and Lifecycle Controller (LC) Management

Power and Reset Management:

Networking

Server NIC

Storage Management

Virtual Media

Virtual Media

Installation and execution of Terraform Provider for RedFish

The installation and execution steps of Terraform Provider for Dell RedFish can be found here.

Releasing, Maintenance and Deprecation

Terraform Provider for RedFish follows Semantic Versioning.

New versions will be release regularly if significant changes (bug fix or new feature) are made in the provider.

Released code versions are located on tags in the form of “vx.y.z” where x.y.z corresponds to the version number.

Documentation

For more detailed information, please refer to Dell Terraform Providers Documentation.

Terraform Redfish Modules

Check the following links for the terraform-modules repository and registry Terraform Redfish Modules Github Terraform Redfish Modules Registry

V1.6.2: Product Guide

Mon, 01 Jan 0001 00:00:00 +0000

V1.6.2: Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

Terraform Provider for Dell - Redfish Release Notes 1.6.2

This release note contains supplemental information about Terraform Provider for Redfish.

Revision History

The table in this section lists the revision history of this document.

Revision	Date	History
01	September 2023	Terraform Provider 1.0.0 for Redfish
02	December 2023	Terraform Provider 1.1.0 for Redfish
03	March 2024	Terraform Provider 1.2.0 for Redfish
04	May 2024	Terraform Provider 1.3.0 for Redfish
05	July 2024	Terraform Provider 1.4.0 for Redfish
06	October 2024	Terraform Provider 1.5.0 for Redfish
07	April 2025	Terraform Provider 1.6.0 for Redfish
08	June 2026	Terraform Provider 1.6.1 for Redfish
09	September 2026	Current release of Terraform Provider 1.6.2 for Redfish

Product Description

The Terraform Provider for Dell Technologies (Dell) RedFish allows data center and IT administrators to use Hashicorp Terraform to automate and orchestrate the provisioning and management of PowerEdge servers.

Bug Fixes

This release addresses bug fixes to improve stability and user experience for Redfish Provider.

Prevent inconsistent results after apply for Dell iDRAC, system, and lifecycle controller attribute resources (#351)
Respect the ssl_insecure setting when configuring TLS certificate verification (#357)

Enhancements

Add retry logic with iDRAC readiness checks for temporary service unavailability (#345)
Mark the certificate passphrase as sensitive and prevent credentials from being logged (#347)
Update Go and dependencies to address security vulnerabilities (#349, #356, #359)
Update the lint configuration and CI workflow for golangci-lint v2 compatibility (#354, #355)

List of Resources and supported operations in Terraform Provider for Redfish

System Configuration and Management

Bios - Read, Update
Boot Order - Create, Read, Update
Boot Source Override - Read, Update
System Attributes - Read, Update

Authentication and Security

Certificate - Create, Read, Delete
Directory Service Auth Provider - Read, Update
Directory Service Auth Provider Certificate - Read, Update
User Account - Create, Read, Update, Delete
User Account Password - Create, Read, Update, Delete

Firmware and Updates

Simple Update - Read, Update
iDRAC Firmware Update - Update

Dell iDRAC and Lifecycle Controller (LC) Management

iDRAC Attributes - Read, Update
Lifecycle Controller Attributes - Read, Update
Server Configuration Profile Export - Read, Update
Server Configuration Profile Import - Read, Update

Power and Reset Management:

Power - Read, Update
Manager reset - Create, Read

Networking

Server NIC - Read, Update

Storage Management

Storage Controller - Read, Update
Storage Volume - Create, Read, Update, Delete

Virtual Media

Virtual Media - Create, Read, Update, Delete

List of Data Sources and supported operations in Terraform Provider for Redfish

System Configuration and Management

Bios - Read
System Boot - Read

Authentication and Security

Directory Service Auth Provider - Read
Directory Service Auth Provide Certificate - Read

Firmware and Inventory

Firmware Inventory - Read

Dell iDRAC Management

iDRAC Attributes - Read

Networking

Server NIC - Read

Storage Management

Storage - Read
Storage Controller - Read

Virtual Media

Virtual Media - Read

Known Issues

S.No.	Issue	Description	Workaround
1.	Output is not displayed on console in datasource	Due to the presence of sensitive attribute (password) in the schema, the `sensitive = true` is added in output section of the data block due to which output is not displayed on console.	Output can be checked in terraform state file.
2.	The server details section in resources cannot be updated in a single scoop	In the current version, Terraform consistently relies on the state file for information during read refresh operations. This behavior is observed even if there have been changes to endpoint details, usernames, or passwords for a given rack. Users should be aware that, although updates can be made in the .tf file, Terraform will default to using the previously recorded details in the state file during any read refresh, whether it was initiated automatically or as a prerequisite to a planning operation.	Whenever server connection configuration requires update , user has to manually change the the server block values (user, password, endpoint and ssl_insecure flag) in corresponding state file directly.
3.	Storage volume resource attribute “optimum_io_size_bytes” value is updated from the server in case it is not provided in the terraform config	“optimum_io_size_bytes” attribute of storage volume resource is optional and if it is not provided in the config (OR) if the value is given as null then during the subsequent run of ’terraform apply’ the system will show ‘update-in-place’ for “optimum_io_size_bytes” attribute as there is some default value set by the server.	User should update the config with the value shown in plan i.e with the value present in terraform state
4.	controller_ids and controller_names are not accepting same controller details	controller_ids and controller_names are not accepting same controller details	No workaround as of now
5.	SSO configuration is not supported by 17G	SSO configuration is not supported by 17G
6.	Schema configuration is not required for 17G as it support only standard schema	Schema configuration not required for 17G as it support only standard schema	No workaround as of now
7.	ServiceAddresses can not be Configured using AccountService API, it can be configured only using iDRAC attributes OEM API for 17 Gen Active Directory	ServiceAddresses can not be Configured using AccountService API, it can be configured only using iDRAC attributes OEM API for 17 Gen Active Directory and LDAP	No workaround as of now
8.	17G Storage controller read-only properties should be greyed out in the UI and a PATCH call involving any of them should throw an error saying that these are read-only properties	17G Storage controller read-only properties should be greyed out in the UI and a PATCH call involving any of them should throw an error saying that these are read-only properties	No workaround as of now

Limitations

Virtual Media attribute “write_protected” can only be configured as “true”.

Distribution

The software package is available for download from the Official Terraform Registry as well as from the Terraform Provider for Redfish GitHub page.

Documentation

Readme

Product Guide

Dell Technologies – RedFish

V1.6.2: ReadMe

Terraform Provider for RedFish

Table of contents

Support

License

Prerequisites

List of DataSources in Terraform Provider for RedFish

System Configuration and Management

Authentication and Security

Firmware and Inventory

Dell iDRAC Management

Networking

Storage Management

Virtual Media

List of Resources in Terraform Provider for RedFish

System Configuration and Management

Authentication and Security

Firmware and Updates

Dell iDRAC and Lifecycle Controller (LC) Management

Power and Reset Management:

Networking

Storage Management

Virtual Media

Installation and execution of Terraform Provider for RedFish

Releasing, Maintenance and Deprecation

Documentation

Terraform Redfish Modules

V1.6.2: Product Guide

V1.6.2: Release Notes

Terraform Provider for Dell - Redfish Release Notes 1.6.2

Contents

Revision History

Product Description

Bug Fixes

Enhancements

List of Resources and supported operations in Terraform Provider for Redfish

System Configuration and Management

Authentication and Security

Firmware and Updates

Dell iDRAC and Lifecycle Controller (LC) Management

Power and Reset Management:

Networking

Storage Management

Virtual Media

List of Data Sources and supported operations in Terraform Provider for Redfish

System Configuration and Management

Authentication and Security

Firmware and Inventory

Dell iDRAC Management

Networking

Storage Management

Virtual Media

Known Issues

Limitations

Distribution

Documentation