community.general.aix_filesystem module – Configure LVM and NFS file systems for AIX
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.aix_filesystem
.
Synopsis
This module creates, removes, mount and unmount LVM and NFS file system for AIX using
/etc/filesystems
.For LVM file systems is possible to resize a file system.
Aliases: system.aix_filesystem
Parameters
Parameter |
Comments |
---|---|
Specifies whether the file system is to be processed by the accounting subsystem. Choices:
|
|
Specifies attributes for files system separated by comma. Default: |
|
File system is automatically mounted at system restart. Choices:
|
|
Logical volume (LV) device name or remote export device to create a NFS file system. It is used to create a file system on an already existing logical volume or the exported NFS file system. If not mentioned a new logical volume name will be created following AIX standards (LVM). |
|
Specifies the mount point, which is the directory where the file system will be mounted. |
|
Specifies the virtual file system type. Default: |
|
Specifies the mount group. |
|
Specifies a Network File System (NFS) server. |
|
Set file system permissions. Choices:
|
|
Removes the mount point directory when used with state Choices:
|
|
Specifies the file system size. For already 512-byte blocks, Megabytes or Gigabytes. If the value has M specified it will be in Megabytes. If the value has G specified it will be in Gigabytes. If no M or G the value will be 512-byte blocks. If “+” is specified in begin of value, the value will be added. If “-” is specified in begin of value, the value will be removed. If “+” or “-” is not specified, the total value will be the specified. Size will respects the LVM AIX standards. |
|
Controls the file system state.
Choices:
|
|
Specifies an existing volume group (VG). |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Notes
Note
For more
attributes
, please check “crfs” AIX manual.
Examples
- name: Create filesystem in a previously defined logical volume.
community.general.aix_filesystem:
device: testlv
filesystem: /testfs
state: present
- name: Creating NFS filesystem from nfshost.
community.general.aix_filesystem:
device: /home/ftp
nfs_server: nfshost
filesystem: /home/ftp
state: present
- name: Creating a new file system without a previously logical volume.
community.general.aix_filesystem:
filesystem: /newfs
size: 1G
state: present
vg: datavg
- name: Unmounting /testfs.
community.general.aix_filesystem:
filesystem: /testfs
state: unmounted
- name: Resizing /mksysb to +512M.
community.general.aix_filesystem:
filesystem: /mksysb
size: +512M
state: present
- name: Resizing /mksysb to 11G.
community.general.aix_filesystem:
filesystem: /mksysb
size: 11G
state: present
- name: Resizing /mksysb to -2G.
community.general.aix_filesystem:
filesystem: /mksysb
size: -2G
state: present
- name: Remove NFS filesystem /home/ftp.
community.general.aix_filesystem:
filesystem: /home/ftp
rm_mount_point: true
state: absent
- name: Remove /newfs.
community.general.aix_filesystem:
filesystem: /newfs
rm_mount_point: true
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Return changed for aix_filesystems actions as true or false. Returned: always |
|
Return message regarding the action. Returned: always |