powermax_host (Resource)
Resource for managing Host in PowerMax array. PowerMax hosts systems are storage hosts that use storage system logical unit number (LUN) resources. A LUN is an identifier that is used for labeling and designating subsystems of physical or virtual storage
Example Usage
/*
Copyright (c) 2023 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public License Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://mozilla.org/MPL/2.0/
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
# Available actions: Create, Update (name, initiator, consistent_lun, host_flags), Delete and Import an existing host from the PowerMax Array.
# After `terraform apply` of this example file it will create a new host with the name set in `name` attribute on the PowerMax
# PowerMax hosts systems are storage hosts that use storage system logical unit number (LUN) resources.
# A LUN is an identifier that is used for labeling and designating subsystems of physical or virtual storage.
resource "powermax_host" "host_1" {
# Attributes which are able to be modified after create (name, initiator, consistent_lun, host_flags)
# Required is the name of the host.
# Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed
name = "host_1"
# Required The initiator(s) associated with the host
initiator = ["10000000c9fc4b7e"]
# Optional consistent_lun the lun addresses on the source are consistent across all paths
consistent_lun = false
# Optional host flags
# All flags are optional and have 2 possible values enabled (to enable that flag on the PowerMax) and override (to force that flag to be set on the PowerMax)
# If a flag is not set then it will have a default value of false
host_flags = {
# Optional It enables a SCSI bus reset to only occur to the port that received the reset.
avoid_reset_broadcast = {
override = true
enabled = true
}
# Optional It is used for hosts that do not expect the queue to be flushed on a 0629 sense.
disable_q_reset_on_ua = {
override = true
enabled = true
}
# Optional It enables the environmental error reporting by the storage system to the host on the specific port.
environ_set = {
override = true
enabled = true
}
# Optional This attribute enables an Open VMS fibre connection
openvms = {
override = true
enabled = true
}
# Optional This attribute provides a stricter compliance with SCSI standards
scsi_support1 = {
override = true
enabled = true
}
# Optional SPC2 Protocol flag. When setting this flag, the port must be offline
spc2_protocol_version = {
override = true
enabled = true
}
# Optional Alters the inquiry data to report that the storage system supports the SCSI-3 protocol
scsi_3 = {
override = true
enabled = true
}
# Optional It enables the volume set addressing mode
volume_set_addressing = {
override = true
enabled = true
}
}
}
# After the execution of above resource block, a PowerMax host has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state
Schema
Required
initiator
(List of String) The initiators associated with the host. (Update Supported)name
(String) The name of the host. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed. (Update Supported)
Optional
consistent_lun
(Boolean) It enables the rejection of any masking operation involving this host that would result in inconsistent LUN values. (Update Supported)host_flags
(Attributes) Flags set for the host. When host_flags = {} then default flags will be considered. (Update Supported) (see below for nested schema)
Read-Only
bw_limit
(Number) Specifies the bandwidth limit for a host.hostgroup
(List of String) The host group associated with the host.id
(String) The ID of the host.maskingview
(List of String) The masking views associated with the host.num_of_host_groups
(Number) The number of hostgroups associated with the host.num_of_initiators
(Number) The number of initiators associated with the host.num_of_masking_views
(Number) The number of masking views associated with the host.numofpowerpathhosts
(Number) The number of powerpath hosts associated with the host.port_flags_override
(Boolean) States whether port flags override is enabled on the host.powerpathhosts
(List of String) The powerpath hosts associated with the host.type
(String) Specifies the type of host.
Nested Schema for host_flags
Optional:
avoid_reset_broadcast
(Attributes) It enables a SCSI bus reset to only occur to the port that received the reset. (Update Supported) (see below for nested schema)disable_q_reset_on_ua
(Attributes) It is used for hosts that do not expect the queue to be flushed on a 0629 sense. (Update Supported) (see below for nested schema)environ_set
(Attributes) It enables the environmental error reporting by the storage system to the host on the specific port. (Update Supported) (see below for nested schema)openvms
(Attributes) This attribute enables an Open VMS fibre connection. (Update Supported) (see below for nested schema)scsi_3
(Attributes) Alters the inquiry data to report that the storage system supports the SCSI-3 protocol. (Update Supported) (see below for nested schema)scsi_support1
(Attributes) This attribute provides a stricter compliance with SCSI standards. (Update Supported) (see below for nested schema)spc2_protocol_version
(Attributes) When setting this flag, the port must be offline. (Update Supported) (see below for nested schema)volume_set_addressing
(Attributes) It enables the volume set addressing mode. (Update Supported) (see below for nested schema)
Nested Schema for host_flags.avoid_reset_broadcast
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.disable_q_reset_on_ua
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.environ_set
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.openvms
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.scsi_3
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.scsi_support1
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.spc2_protocol_version
Optional:
enabled
(Boolean)override
(Boolean)
Nested Schema for host_flags.volume_set_addressing
Optional:
enabled
(Boolean)override
(Boolean)
Import
Import is supported using the following syntax:
# Copyright (c) 2023 Dell Inc., or its subsidiaries. All Rights Reserved.
# Licensed under the Mozilla Public License Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# http://mozilla.org/MPL/2.0/
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# The command is
# terraform import powermax_host.host_1 <id>
# Example:
terraform import powermax_host.host_1 host_1
# after running this command, populate the name field in the config file to start managing this resource