License BIG-IP with BIG-IQ

Welcome to the F5 BIG-IP Terraform Provider Licensing Guide with BIG-IQ.

See also

• Terraform documentation.

• BIG-IQ License Management.

With this Terraform Resource, you can assign the regkey/utility licenses to an F5 BIG-IP provider. You can also revoke licenses from BIG-IP provider for MANAGED, UNMANAGED, or UNREACHABLE devices using BIG-IQ.

This section provides examples of the bigip_common_license_manage_bigiq resource module. This resource is used for BIG-IP provider license management from BIG-IQ using Terraform.

Prerequisites

To license from BIG-IQ with Terraform, ensure you meet the following requirements:

• BIG-IQ v5.6 or newer

• The BIG-IP system is running software version 12.X or newer

Example usage

# MANAGED Regkey Pool
resource "bigip_common_license_manage_bigiq" "test_example" {
  bigiq_address = var.bigiq
  bigiq_user = var.bigiq_un
  bigiq_password = var.bigiq_pw
  license_poolname = "regkeypool_name"
  assignment_type = "MANAGED"
}

# UNMANAGED Regkey Pool
resource "bigip_common_license_manage_bigiq" "test_example" {
  bigiq_address = var.bigiq
  bigiq_user = var.bigiq_un
  bigiq_password = var.bigiq_pw
  license_poolname = "regkeypool_name"
  assignment_type = "UNMANAGED"
}

# UNMANAGED Utility Pool
resource "bigip_common_license_manage_bigiq" "test_example" {
  bigiq_address = var.bigiq
  bigiq_user = var.bigiq_un
  bigiq_password = var.bigiq_pw
  license_poolname = "utilitypool_name"
  assignment_type = "UNMANAGED"
  unit_of_measure = "yearly"
  skukeyword1 = "BTHSM200M"
}

# UNREACHABLE Regkey Pool
resource "bigip_common_license_manage_bigiq" "test_example" {
  bigiq_address="xxx.xxx.xxx.xxx"
  bigiq_user="xxxx"
  bigiq_password="xxxxx"
  license_poolname = "regkey_pool_name"
  assignment_type = "UNREACHABLE"
  mac_address = "FA:16:3E:1B:6D:32"
  hypervisor = "azure"
}

Argument reference

The following table provides descriptions for all BIG-IQ licensing parameters provided on the Terraform Registry.

Parameter	Status	Description
big-iq_address	Required	BIGIQ License Manager IP Address, variable type string
bigiq_user	Required	BIGIQ License Manager username, variable type string
bigiq_password	Required	BIGIQ License Manager password, variable type string
bigiq_port	Optional	BIGIQ License Manager Port number, variable type int. Specify if port is other than 443
bigiq_token_auth	Optional	Variable type bool. If set to true enables token based authentication. Default value is false
unit_of_measure	Optional	BIGIQ Login reference for token authentication.
assignment_type	Required	The type of assignment, which is determined by whether the BIG-IP is unreachable, unmanaged, or managed by BIG-IQ. Possible values: “UNREACHABLE”, “UNMANAGED”, or “MANAGED”.
license_poolname	Required	A name given to the license pool, variable type string.
license_poolname	Optional	The units used to measure billing. For example, “hourly” or “daily”. Type string. REQUIRED for Utility licenseType.
skukeyword1	Optional	An optional offering name. type string.
skukeyword2	Optional	An optional offering name. type string.
mac_address	Optional	MAC address of the BIG-IP. type string. REQUIRED Only for unreachable BIG-IP.
hypervisors	Optional	Identifies the platform running the BIG-IP VE. Variable type string.Possible values: “aws”, “azure”, “gce”, “vmware”, “hyperv”, “kvm”, or “xen”. REQUIRED Only for unreachable BIG-IP
tenant	Optional	For an unreachable BIG-IP, in this field you can provide an optional description for the assignment.
key	Optional	License assignment is done with specified key, supported only with RegKeypool type license assignement. Variable type string.