VhAJddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl Z dZd Zd Zd Zd Zd ZdZdZdZedk(reyy))absolute_importdivisionprint_functiona author: - Kairo Araujo (@kairoaraujo) module: aix_filesystem short_description: Configure LVM and NFS file systems for AIX description: - This module creates, removes, mount and unmount LVM and NFS file system for AIX using C(/etc/filesystems). - For LVM file systems is possible to resize a file system. extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: account_subsystem: description: - Specifies whether the file system is to be processed by the accounting subsystem. type: bool default: false attributes: description: - Specifies attributes for files system separated by comma. type: list elements: str default: - agblksize=4096 - isnapshot=no auto_mount: description: - File system is automatically mounted at system restart. type: bool default: true device: description: - 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). type: str fs_type: description: - Specifies the virtual file system type. type: str default: jfs2 permissions: description: - Set file system permissions. V(rw) (read-write) or V(ro) (read-only). type: str choices: [ro, rw] default: rw mount_group: description: - Specifies the mount group. type: str filesystem: description: - Specifies the mount point, which is the directory where the file system will be mounted. type: str required: true nfs_server: description: - Specifies a Network File System (NFS) server. type: str rm_mount_point: description: - Removes the mount point directory when used with state V(absent). type: bool default: false size: description: - Specifies the file system size. - For already V(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. type: str state: description: - Controls the file system state. - V(present) check if file system exists, creates or resize. - V(absent) removes existing file system if already V(unmounted). - V(mounted) checks if the file system is mounted or mount the file system. - V(unmounted) check if the file system is unmounted or unmount the file system. type: str choices: [absent, mounted, present, unmounted] default: present vg: description: - Specifies an existing volume group (VG). type: str notes: - For more O(attributes), please check "crfs" AIX manual. a - 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 z changed: description: Return changed for aix_filesystems actions as true or false. returned: always type: bool msg: description: Return message regarding the action. returned: always type: str ) AnsibleModule)ismountNc|jdd}|j|d|g\}}}|dk(r-tjd|ry|j d|zy y) z Check if file system already exists on /etc/filesystems. :param module: Ansible module. :param community.general.filesystem: filesystem name. :return: True or False. lsfsTz-lzNo record matchingFz%Failed to run lsfs. Error message: %smsgN) get_bin_path run_commandrefindall fail_json)module filesystemlsfs_cmdrclsfs_outerrs t/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/aix_filesystem.py _fs_existsrsk""640H**HdJ+GHB# Qw ::*C 0   !H3!N  Oc|jdd}|j|d|g\}}}|dk7r|jd|zy |j}|D]}|j dd|k(syy ) z Validate if NFS server is exporting the device (remote export). :param module: Ansible module. :param nfs_host: nfs_host parameter, NFS server. :param device: device parameter, remote export. :return: True or False. showmountT-arz*Failed to run showmount. Error message: %sr :r FN)r rr splitlinessplit) rnfs_hostdevice showmount_cmdr showmount_outrshowmount_datalines r_check_nfs_devicer's'' T:M#//h0OPB s QwICOP&113" Dzz#q!V+ rc6|jdd}|j|dg\}}}|dk7r|jd|z|j|g\}}}|dk7r|jd|z||vr ||vr d|z}d|fS||vr d |z}d|fSd |z}d |fS) z Check the current state of volume group. :param module: Ansible module argument spec. :param vg: Volume Group name. :return: True (VG in varyon state) or False (VG in varyoff state) or None (VG does not exist), message. lsvgTz-orzFailed executing %s command.r z$Volume group %s is in varyoff state.Fz#Volume group %s is in varyon state.zVolume group %s does not exist.N)r rr)rvglsvg_cmdrcurrent_active_vgsrcurrent_all_vgsr s r _validate_vgr.s""640H"("4"4h5E"FBC Qw;hFG%118*=B Qw;hFG _+=!=4r9cz ! !3b8Sy/"4SyrcN|jdd}|js|j|dd|z|g\}}}|dk(rd}||fS|dk7r2tjd|rd}||fS|j d |z y tjd |rd}||fSd}||fSd}d }||fS)z Resize LVM file system. chfsTrzsize=%sFrzMaximum allocation for logicalz%Failed to run chfs. Error message: %sr zThe filesystem size is alreadyN)r check_moderrrr) rrsizechfs_cmdrchfs_outrchangedr s r resize_fsr8s""640H   "..$ D@PR\/]^Hc 8GH$ $ 1Wzz:C@|#  %Ls%R Szz:HEH$ $H$ $|rc dj| } ddd} | ddd} ndd d} |d }nd |z}|d }nd |z}|d }nt||\}}|rd |z}nd}||fS|d }nd|z}| |}| |}| l|jdd}|jsF|j |d||d| d| |ddg \}}}|dk7r|j d|zyd}d|z}||fSd}d }||fS|jdd}|jsB|g}|j d|j ||r5|j\}}|j ||j ||r5|j\}}|j ||j ||j d|j ||r5|j\}}|j ||j ||r5|j\}}|j ||j ||r5|j\}}|j ||j ||j d|j | |r5|j\}}|j ||j || r9| j}|j d|D]}|j ||j |\}}}|dk(r|jd |zy|dk7r|j d!|d"|yd}||fSd}d }||fS)#z3 Create LVM file system or NFS remote mount point. z -a z-t yesz-t noTFNz-Arz-A yesz-A nor2z -a size=%sz-d %sz-g %sFz-u %smknfsmntTz-fz-hz-tz-wbgrz)Failed to run mknfsmnt. Error message: %sr zNFS file system %s created.crfsz-vz-mz-p zVUsing a existent previously defined logical volume, volume group needs to be empty. %sFailed to run . Error message: ) joinr.r r3rrappendr exit_json)rfs_typerr*r"r4 mount_group auto_mountaccount_subsystem permissions nfs_server attributesaccount_subsys_optauto_mount_optvg_stater r7 mknfsmnt_cmdr mknfsmnt_outrcrfs_cmdcmdflagvaluesplitted_attributescrfs_outs r create_fsrV s Z(J     |d" ~6! z $VR0 # 2BGC<   +  +J*+<=**:t<   $*$6$6 dJX^`dfprvyDFPRVX\8]%^ !B cQw  %PSV%V W3j@|#GCC< &&vt4  *C JJt  JJw  " u 4  5! &  u 4  5! JJt  JJz " + 1 1 3 u 4  5! * 0 0 2 u 4  5! 1 7 7 9 u 4  5! JJt  JJ{ # $ u 4  5!&0&6&6&8# 4 0&EJJu%&!' 2 23 7 B#Rx  =?BC!Dq  cSV%W X((GCC< rcddd}||}|jdd}|jsH|d||g}|j|\}}}|dk7r|jd|d| y d} |} |sd |z} | | fSd} d} | | fS) z) Remove an LVM file system or NFS entry. z-rr2r:rmfsTrr?r@r zFile system %s removed.Nr r3rr) rrrm_mount_pointrm_mount_point_optrmfs_cmdrQrrmfs_outrr7r s r remove_fsr^s  (7N""640H   ~z:"..s3Hc 7   #s!S  TGC/*<C< |rc|jdd}|js=|j||g\}}}|dk7r|jd|zyd}d|z}||fSd}d}||fS) z Mount a file system. mountTrz&Failed to run mount. Error message: %sr File system %s mounted.r2NrY)rr mount_cmdr mount_outrr7r s rmount_fsrds##GT2I   #//J0GHIs 7   !IC!O  PG+j8CC< |rc|jdd}|js=|j||g\}}}|dk7r|jd|zyd}d|z}||fSd}d}||fS) z Unmount a file system.unmountTrz(Failed to run unmount. Error message: %sr zFile system %s unmounted.r2NrY)rr unmount_cmdr unmount_outrr7r s r unmount_fsris%%i6K   %11; 2KLK 7   !Kc!Q  RG- :CC< |rctttddtddddgtdd td tdd tdd tdd d dgtd td tddtd tddgdtd  d }|jd}|jd}|jd}|jd}|jd}|jd}|jd}|jd}|jd} |jd} |jd} |jd} |jd } tdd!"}| dk(rt|}t ||}|s|r(d#|z|d$<d|d%<| t ||| \|d%<|d$<np| F|d&|d$<|j d0i|n,t|| |rt|||| || ||||| | \|d%<|d$<|9| d'|d$<|j d0i|nt|||| || ||||| | \|d%<|d$<|| t|||| || ||||| | \|d%<|d$<n| d(k(rBt|r d)|z|d$<nt ||}|s d*|z|d$<nt||| \|d%<|d$<n| d+k(r/t|rd|d%<d,|z|d$<ndt||\|d%<|d$<nN| d-k(r/t|sd|d%<d.|z|d$<n0t||\|d%<|d$<nd/| z|d$<|j d0i||jd0i|y)1NboolF)typedefaultliststrzagblksize=4096z isnapshot=no)rlelementsrmT)rl)rlrequiredjfs2rwro)rlrmchoicespresent)absentmountedrv unmounted) rGrJrFr"rrDrHrErIrZr4stater*) argument_specsupports_check_moderGrJrFr"rDrHrErrIrZr4rzr*r2)r7r zFile system %s already exists.r r7z%BRTbAcd6U#6eV4%d|L%('VU;5!E9>kl !!F& &9:|,J|,J ]]8 $FmmI&G-- .K-- .K|,J|,J]]#34N == D MM' "E t B  F  Z( vz2  $bF5M$F$$.v.)VD;D"GZVT;XbduxCEOQ[<\8y)6%=~:$qF5M$F$$.v.8AR{T^`qs~AKMW8X4F9%ve}!j&83<GZVT;PZ\moz}GIS4T0y!6%= (  : 5 BF5M#6:6I @: Mu 3rs{A@ a F7 r 5U ,,:>M `>((m` zFr