enfence.powerha_aix.fs (1.3.2) — module

manage file_system resource 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 file_system resource in PowerHA cluster.

This module was added in 1.2.0.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# create JFS2 filesytem on existing logical volume with INLINE jfs2log.
- name: create /ora filesystem
  enfence.powerha_aix.fs:
    name: /ora
    lv: lvora
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# delete an existing file system.
- name: delete /ora file system
  enfence.powerha_aix.fs:
    name: /ora
    state: absent

Inputs

    
lv:
    aliases:
    - lvol
    - logical_volume
    description:
    - logical volume where the file system must be created.
    - required if I(vg) is not specified and state is C(present).
    required: false
    type: str

vg:
    aliases:
    - volume_group
    - volumegroup
    description:
    - volume group where the file system must be created.
    - required if I(lv) is not specified and state is C(present).
    required: false
    type: str

efs:
    description: enable Encyrpted File System (EFS) on jfs2.
    required: false
    type: bool

log:
    aliases:
    - lv_for_log
    default: INLINE
    description:
    - logical volume for jfs/jfs2 log.
    - use C(INLINE) if you want to use jfs2 inline logs.
    required: false
    type: str

name:
    aliases:
    - mount
    - mountpoint
    - mount_point
    description: name (mount point) of the file system.
    required: true
    type: str

perm:
    aliases:
    - perms
    - permissions
    - permission
    choices:
    - rw
    - ro
    description: permissions on the file system.
    required: false
    type: str

size:
    aliases:
    - units
    description:
    - size of the future file system.
    - required if the state is C(present) and I(lv) is not specified.
    required: false
    type: int

type:
    choices:
    - jfs2
    - enhanced
    - jfs
    - standard
    - compressed
    - large
    default: jfs2
    description:
    - file system type.
    - C(jfs2) and C(enhanced) are aliases.
    - C(jfs) and (standard) are aliases.
    - C(compressed) is C(jfs) filesytem with compression enabled. I(fragment_size) must
      be 2048 or less.
    - C(large) is large file enabled C(jfs) filesystem. I(fragment_size) must be 4096.
    required: false
    type: str

unit:
    aliases:
    - size_per_unit
    choices:
    - mb
    - gb
    - block
    description:
    - which unit is used to specify I(size) of the filesystem.
    - required if I(size) is specified.
    required: false
    type: str

quota:
    aliases:
    - enable_quota_mgmt
    choices:
    - 'no'
    - all
    - user
    - group
    description: type of quotas that can be enabled on jfs2 filesytem.
    required: false
    type: str

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

options:
    choices:
    - nodev
    - nosuid
    - nodev,nosuid
    description: file system options.
    required: false
    type: str

ea_format:
    aliases:
    - eaformat
    - ext_attr_format
    choices:
    - v1
    - v2
    description: specifies the format is used to store jfs2 extended attributes.
    required: false
    type: str

block_size:
    choices:
    - 512
    - 1024
    - 2048
    - 4096
    default: 4096
    description: jfs2 block size in bytes.
    required: false
    type: int

fragment_size:
    choices:
    - 512
    - 1024
    - 2048
    - 4096
    description:
    - jfs fragment size in bytes.
    - by default jfs uses I(4096) bytes fragments.
    - 'the module sets C(fragment_size) to I(4096) by default if you specify C(type):
      I(large) and no C(fragment_size).'
    - 'the module sets C(fragment_size) to I(2048) by default if you specify C(type):
      I(compressed) and no C(fragment_size).'
    required: false
    type: int

bytes_per_inode:
    choices:
    - 512
    - 1024
    - 2048
    - 4096
    - 8192
    - 16384
    - 32768
    - 65536
    - 131072
    description: number of bytes per i-node for jfs filesytem.
    required: false
    type: int

disk_accounting:
    description: enables accounting on the file system.
    required: false
    type: bool

alloc_group_size:
    choices:
    - 8
    - 16
    - 32
    - 64
    description: allocation group size in megabytes for jfs filesytem.
    required: false
    type: int

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