aix_filesystem – Configure LVM and NFS file systems for AIX
New in version 2.8.
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 | 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. rw (read-write) or ro (read-only). |
rm_mount_point boolean |
| Removes the mount point directory when used with state absent . |
size string | Specifies the file system size. For already present it will be resized.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 / required |
| Controls the file system state. present check if file system exists, creates or resize.absent removes existing file system if already unmounted .mounted checks if the file system is mounted or mount the file system.unmounted check if the file system is unmounted or unmount the file system. |
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. aix_filesystem: device: testlv filesystem: /testfs state: present - name: Creating NFS filesystem from nfshost. aix_filesystem: device: /home/ftp nfs_server: nfshost filesystem: /home/ftp state: present - name: Creating a new file system without a previously logical volume. aix_filesystem: filesystem: /newfs size: 1G state: present vg: datavg - name: Unmounting /testfs. aix_filesystem: filesystem: /testfs state: unmounted - name: Resizing /mksysb to +512M. aix_filesystem: filesystem: /mksysb size: +512M state: present - name: Resizing /mksysb to 11G. aix_filesystem: filesystem: /mksysb size: 11G state: present - name: Resizing /mksysb to -2G. aix_filesystem: filesystem: /mksysb size: -2G state: present - name: Remove NFS filesystem /home/ftp. aix_filesystem: filesystem: /home/ftp rm_mount_point: yes state: absent - name: Remove /newfs. aix_filesystem: 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. |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Kairo Araujo (@kairoaraujo)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/aix_filesystem_module.html