community.general.aix_filesystem – Configure LVM and NFS file systems for AIX
community.general.aix_filesystem – Configure LVM and NFS file systems for AIX
Note
This plugin is part of the community.general collection (version 1.3.2).
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.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
account_subsystem boolean |
|
Specifies whether the file system is to be processed by the accounting subsystem. |
attributes list / elements=string |
Default: "agblksize=\u00274096\u0027,isnapshot=\u0027no\u0027" |
Specifies attributes for files system separated by comma. |
auto_mount boolean |
|
File system is automatically mounted at system restart. |
device string |
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). | |
filesystem string / required |
Specifies the mount point, which is the directory where the file system will be mounted. | |
fs_type string |
Default: "jfs2" |
Specifies the virtual file system type. |
mount_group string |
Specifies the mount group. | |
nfs_server string |
Specifies a Network File System (NFS) server. | |
permissions string |
|
Set file system permissions. |
rm_mount_point boolean |
|
Removes the mount point directory when used with state |
size string |
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. | |
state string |
|
Controls the file system state.
|
vg string |
Specifies an existing volume group (VG). |
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
community.general.filesystem: /testfs
state: present
- name: Creating NFS filesystem from nfshost.
community.general.aix_filesystem:
device: /home/ftp
nfs_server: nfshost
community.general.filesystem: /home/ftp
state: present
- name: Creating a new file system without a previously logical volume.
community.general.aix_filesystem:
community.general.filesystem: /newfs
size: 1G
state: present
vg: datavg
- name: Unmounting /testfs.
community.general.aix_filesystem:
community.general.filesystem: /testfs
state: unmounted
- name: Resizing /mksysb to +512M.
community.general.aix_filesystem:
community.general.filesystem: /mksysb
size: +512M
state: present
- name: Resizing /mksysb to 11G.
community.general.aix_filesystem:
community.general.filesystem: /mksysb
size: 11G
state: present
- name: Resizing /mksysb to -2G.
community.general.aix_filesystem:
community.general.filesystem: /mksysb
size: -2G
state: present
- name: Remove NFS filesystem /home/ftp.
community.general.aix_filesystem:
community.general.filesystem: /home/ftp
rm_mount_point: yes
state: absent
- name: Remove /newfs.
community.general.aix_filesystem:
community.general.filesystem: /newfs
rm_mount_point: yes
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
changed boolean |
always |
Return changed for aix_filesystems actions as true or false.
|
msg string |
always |
Return message regarding the action.
|
Authors
- Kairo Araujo (@kairoaraujo)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/aix_filesystem_module.html