Terraform provider for OpenManage Enterprise

The Terraform provider for OpenManage Enterprise is a custom Terraform Provider that allows the resource management of PowerEdge servers using OpenManage Enterprise (OME). For more details on OME, please refer to OME official webpage here.

For general information about Terraform, visit the official website and the GitHub project page.

Table of Contents

• License
• Supported Platforms
• Prerequisites
• Installation
• List of DataSources in Terraform Provider for Dell OME
• List of Resources in Terraform Provider for Dell OME
• Releasing, Maintenance and Deprecation

License

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

Supported Platforms

• Dell OpenManage Enterprise versions 3.10.0 (Build 55) and above.
• Dell OpenManage Enterprise version 4.0.1 (Build 20) and above.

Prerequisites

List of DataSources in Terraform Provider for Dell OME

• Configuration Report
• Device Groups
• Template
• VLAN Networks
• Device Datasource
• Device Compliance Report
• Application Certificate Datasource
• Firmware Repository
• Firmware Baseline Compliance Report
• Firmware Catalog

List of Resources in Terraform Provider for Dell OME

• Configuration Baseline
• Configuration Compliance
• Deployment
• Template
• User Resource
• Static Group Resource
• Discovery Resource
• Devices Resource
• Device Action Resource
• Application CSR Resource
• Application Certificate Resource
• Appliance Network Resource
• Firmware Catalog
• Firmware Baselines

Installation of Terraform Provider for Dell OME

Install from Terraform Registry

The provider will be fetched from the Terraform registry and installed by Terraform automatically. Create a file called main.tf in your workspace with the following contents

terraform {
  required_providers {
    ome = {
      version = "1.2.0"
      source  = "registry.terraform.io/dell/ome"
    }
  }
}

Then, in that workspace, run

terraform init

If you are upgrading from a previous version, set the version of ome in the required providers block to “1.2.0” as shown above. Then, in your workspace, run

terraform init -upgrade

For more details on how to upgrade provider versions, please check out https://developer.hashicorp.com/terraform/tutorials/configuration-language/provider-versioning

Installation from source code

Dependencies: Go 1.21.x, make, Terraform 1.5.x/1.6.x

Run

git clone https://github.com/dell/terraform-provider-ome.git
cd terraform-provider-ome
make install

Then follow installation from Terraform registry

For adding resources, please refer examples

SSL Certificate Verification

For SSL verifcation on RHEL, these steps can be performed:

• Copy the CA certificate to the /etc/pki/ca-trust/source/anchors path of the host by any external means.
• Import the SSL certificate to host by running

update-ca-trust extract

For SSL verification on Ubuntu, these steps can be performed:

• Copy the CA certificate to the /etc/ssl/certs path of the host by any external means.
• Import the SSL certificate to host by running:

 update-ca-certificates

Releasing, Maintenance and Deprecation

Terraform Provider for Dell Technnologies PowerFlex follows Semantic Versioning.

New versions will be released regularly if significant changes (bug fixes or new features) 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.