Product Guide

Terraform Provider for Dell PowerStore

Contents

• Provider
  • Synopsis
  • List Of Parameters
  • Examples
  • Note
• Volume Resource
  • Synopsis
  • List Of Parameters
  • Examples
  • Note
• SnapshotRule Resource
  • Synopsis
  • List Of Parameters
  • Examples
  • Note
• ProtectionPolicy Resource
  • Synopsis
  • List Of Parameters
  • Examples
  • Note
• StorageContainer Resource
  • Synopsis
  • List Of Parameters
  • Examples
• Volume DataSource
  • Synopsis
  • List Of Parameters
  • Examples
  • Note

Provider

Configure the provider on Dell PowerStore

Synopsis

To create any resource / datasource , we need to provide authentication details to connect to the PowerStore

List Of Parameters

Examples

    
        provider "powerstore" {
            username = "username"
            password = "password"
            endpoint = "10.10.10.1"
            insecure = true
            timeout = 120
        }
    

Note

• Provider details must be provided to autnenticate and connect to the PowerStore Storage system before creating any resource / datasource
• If we don't set the insecure attribute in provider block, the authentication will require SSL verification
• User role should be either Powerstore admin or Powerstore storage operator.

Volume Resource

Manage Volume on Dell PowerStore

Synopsis

Managing volumes on PowerStore storage system includes creating new volume, modifying attributes of the volume, importing existing volume and deleting the volume.

List Of Parameters

Examples

- With required attributes only

    resource "powerstore_volume" "test" {
        name = "test_vol"
        size =  3
        capacity_unit= "GB"
    }

- With Host ID:

    resource "powerstore_volume" "test1" {
        name = "test_vol1"
        size =  3
        capacity_unit= "GB"
        description = "Creating volume"
        host_id="022c3fbc-4e92-48b6-928b-18565c803d0e"
        appliance_id="A1"
        volume_group_id="069b594c-6f68-4485-ab56-1c10b6230d71"
        min_size=1048576
        sector_size=512
        protection_policy_id="ea88-9c6e-a549-4281-b346-762451758e43"
        performance_policy_id="default_medium"
        app_type="Relational_Databases_Other"
        app_type_other="db1"
    }

- With HostGroupID:

    resource "powerstore_volume" "test2" {
        name = "test_vol2"
        size =  3
        capacity_unit= "GB"
        description = "Creating volume"
        host_group_id="80c4c618-cf91-4b67-9df3-b2c0f0d6564c"
        appliance_id="A1"
        volume_group_id="069b594c-6f68-4485-ab56-1c10b6230d71"
        min_size=1048576
        sector_size=512
        protection_policy_id="ea889c6e-a549-4281-b346-762451758e43"
        performance_policy_id="default_medium"
        app_type="Relational_Databases_Other"
        app_type_other="db1"
    }

Note

• Either host_id or host_group_id can be present at a time. logical_unit_number is used only when either host_id or host_group_id are present.

SnapshotRule Resource

Manage Snapshot Rule on Dell PowerStore

Synopsis

Managing snapshot rule on PowerStore storage system includes creating new snapshot rule, modifying attributes of the snapshot rule, importing existing snapshot rule and deleting the snapshot rule.

List Of Parameters

Examples

- With required attributes only (using time_of_day):

    resource "powerstore_snapshotrule" "test" {
        name = "test_snapshotrule" 
        time_of_day = "21:00"
        desired_retention = 56
    }

- With required attributes only (using interval):

    resource "powerstore_snapshotrule" "test" {
        name = "test_snapshotrule" 
        interval = "Four_Hours"
        desired_retention = 56
    }

- With optional attributes:

    resource "powerstore_snapshotrule" "test" {
        name = "test_snapshotrule" 
        interval = "Four_Hours"
        days_of_week = ["Monday", "Wednesday"]
        desired_retention = 56
        nas_access_type = "Snapshot"
        is_read_only = false
        delete_snaps = true
    }

Note

• Either interval or time_of_day can be present at a time.

ProtectionPolicy Resource

Manage Protection Policy on Dell PowerStore

Synopsis

Managing protection policy on PowerStore storage system includes creating new protection policy, modifying attributes of the protection policy, importing existing protection policy and deleting the protection policy.

List Of Parameters

Examples

- With required attributes only (associating replication rule using Name):

    resource "powerstore_protectionpolicy" "test" 
    {
        name = "protectionpolicy_acc_new"
        replication_rule_names = ["Emalee-SRA-7416-Rep"]
    }

- Associating replication rule and snapshot rule using ID:

    resource "powerstore_protectionpolicy" "test"
    {
        name = "protectionpolicy_acc_new"
        replication_rule_ids = ["5d45b173-9a85-473e-8ab8-e107f8b8085e"]
        snapshot_rule_ids = ["4be81573-c0e6-4956-a32f-a0e396a9b86d"]
    }

- Associating replication rule and snapshot rule using Name:

    resource "powerstore_protectionpolicy" "test" 
    {
        name = "protectionpolicy_acc_new"
        replication_rule_names = ["Emalee-SRA-7416-Rep"]
        snapshot_rule_names = ["test_snapshotrule_1"]
    }

- With optional attributes:

    resource "powerstore_protectionpolicy" "test" 
    {
        name = "protectionpolicy_acc_new"
        description = "Test CreateProtectionPolicy"
        snapshot_rule_names = ["test_snapshotrule_1"]
        replication_rule_ids = ["5d45b173-9a85-473e-8ab8-e107f8b8085e"]
    }

Note

• Only one of replication_rule_ids, replication_rule_names, snapshot_rule_ids or snapshot_rule_names is required.
• replication_rule_ids and replication_rule_names are mutually exclusive attributes and both cannot be specified in one resource block.
• snapshot_rule_ids and snapshot_rule_names are mutually exclusive attributes and both cannot be specified in one resource block.

StorageContainer Resource

Manage Storage Container on Dell PowerStore

Synopsis

Managing storage container on PowerStore storage system includes creating new storage container, modifying attributes of the storage container, importing existing storage container and deleting the storage container.

List Of Parameters

Examples

- With required attributes only:

    resource "powerstore_storagecontainer" "test" {
        name = "scterraform_acc"
        quota = 10737418240
    }

- With optional attributes:

    resource "powerstore_storagecontainer" "test" {
        name = "scterraform_acc"
        quota = 10737418240
        storage_protocol = "SCSI"
        high_water_mark = 70
    }

Volume DataSource

Manage Volume DataSource on Dell PowerStore

Synopsis

Managing volume datasource on PowerStore storage system includes fetching details of volume using volume name or volume id.

List Of Parameters

Examples

- Get volume details using volume name:

    data "powerstore_volume" "test1" 
    {
        name = "tf_vol"
    }

- Get volume details using volume ID:

    data "powerstore_volume" "test1" 
    {
	id = "a0b0c773-1c50-425a-89dc-aef9162ec787"
    }

Note

• Either of volume id or volume name must be present to fetch details of specific volume.
• Details of all the volumes would be fetched if no parameter is specified i.e empty block.