enfence.powerha_aix.lv (1.3.2) — module

manage logical volumes in PowerHA cluster

| "added in version" 1.2.0 of enfence.powerha_aix"

Authors: Andrey Klyachkin (@aklyachkin)

Install collection

Install with ansible-galaxy collection install enfence.powerha_aix:==1.3.2


Add to requirements.yml

  collections:
    - name: enfence.powerha_aix
      version: 1.3.2

Description

This module creates/deletes/changes logical_volume resource in PowerHA cluster.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: create logical volume
  enfence.powerha_aix.lv:
    name: lvora
    vg: vg01
    size: 1
    unit: gb

Inputs

    
vg:
    aliases:
    - volgrp
    - volume_group
    description: name of the volume group where the logical volume resides.
    required: true
    type: str

mp1:
    aliases:
    - mirror_pool_1
    - first_copy_mirror_pool
    description: Specify a mirror pool for first copy.
    required: false
    type: str

mp2:
    aliases:
    - mirror_pool_2
    - second_copy_mirror_pool
    description: Specify a mirror pool for second copy.
    required: false
    type: str

mp3:
    aliases:
    - mirror_pool_3
    - third_copy_mirror_pool
    description: Specify a mirror pool for third copy.
    required: false
    type: str

name:
    description: name of the logical volume.
    required: true
    type: str

node:
    description: Reference node.
    required: false
    type: str

size:
    description: size of the logical volume. required if state is C(present).
    required: false
    type: int

type:
    choices:
    - jfs
    - jfs2
    - sysdump
    - paging
    - jfslog
    - jfs2log
    - aio_cache
    - boot
    default: jfs2
    description: type of the logical volumes.
    required: false
    type: str

unit:
    choices:
    - pp
    - mb
    - gb
    default: pp
    description:
    - unit for the size of the logical volume.
    - the size will be rounded according to physical partition size in the volume group.
    required: false
    type: str

group:
    description: Specifies group ID for the logical volume special file.
    required: false
    type: str

label:
    description: logical volume label.
    required: false
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description: the desired state of the logical volume - C(present), C(absent).
    required: false
    type: str

copies:
    aliases:
    - lpart_copies
    - lp_copies
    choices:
    - 1
    - 2
    - 3
    description: number of copies of the logical volume.
    required: false
    type: int

max_lp:
    aliases:
    - max_lps
    - max_lparts
    - maxlp
    description: maximum number of logical partitions in the logical volume.
    required: false
    type: int

max_pv:
    aliases:
    - max_pvs_for_new_alloc
    description: maximum number of physical volumes to use for the logical volume.
    required: false
    type: int

sep_pvs:
    aliases:
    - separate_pvs
    - lparts_on_separate_pvs
    - lps_on_separate_pvs
    choices:
    - 'yes'
    - 'no'
    - superstrict
    description: Strict allocation policy.
    required: false
    type: str

volumes:
    aliases:
    - physical_volumes
    - pv
    - pvs
    - volume
    description: physical volumes where the logical volume should reside.
    elements: str
    required: false
    type: list

position:
    aliases:
    - pos
    choices:
    - outer_middle
    - outer_edge
    - center
    - inner_middle
    - inner_edge
    description: position of the logical volume on the physical volume.
    required: false
    type: str

pv_range:
    aliases:
    - pvrange
    - range
    choices:
    - maximum
    - minimum
    description: how to place the logical volume on physical volumes.
    required: false
    type: str

relocate:
    description: Reorganization relocation flag.
    required: false
    type: bool

alloc_map:
    aliases:
    - allocation_map
    description: Specifies the exact physical partitions to allocate.
    required: false
    type: path

encryption:
    aliases:
    - lv_encryption
    - enable_lv_encryption
    description: Enables the data encryption option in the logical volume.
    required: false
    type: bool

auth_method:
    choices:
    - keyserv
    - pks
    description: N/A.
    required: false
    type: str

bb_relocate:
    aliases:
    - bad_block_relocation
    description: Bad-block relocation policy.
    required: false
    type: bool

permissions:
    description: Specifies permissions (file modes) for the logical volume special file.
    required: false
    type: str

stripe_size:
    choices:
    - 4K
    - 8K
    - 16K
    - 32K
    - 64K
    - 128K
    - 256K
    - 512K
    - 1M
    - 2M
    - 4M
    - 8M
    - 16M
    - 32M
    - 64M
    - 128M
    description: Specifies the number of bytes per strip.
    required: false
    type: str

sched_policy:
    aliases:
    - scheduling_policy
    - schedpolicy
    - policy
    choices:
    - parallel
    - sequential
    - parallel_sequential
    - parallel_round_robin
    description: Scheduling policy when more than one logical partition is written.
    required: false
    type: str

serialize_io:
    description: Turns on/off serialization of overlapping I/Os.
    required: false
    type: bool

verify_writes:
    description: Sets the write-verify state for the logical volume.
    required: false
    type: bool

method_details:
    description: N/A.
    required: false
    type: str

auth_method_name:
    description: N/A.
    required: false
    type: str

write_consistency:
    choices:
    - active
    - passive
    - 'off'
    description: mode of write consistency.
    required: false
    type: str

first_block_available:
    description: The logical volume control block does not occupy the first block of the
      logical volume.
    required: false
    type: bool

Outputs

changed:
  description: set to true if the resource was changed
  returned: always
  type: bool
msg:
  description: error and informational messages
  returned: always
  type: str
rc:
  description: return code of the last executed command
  returned: always
  type: int
stderr:
  description: standard error of the last executed command
  returned: always
  type: str
stdout:
  description: standard output of the last executed command
  returned: always
  type: str