Vh,LldZddlmZmZmZeZdZdZddl m Z m Z ddl m Z mZmZmZmZmZmZmZ ddlmZdZd Zd Zd Zd Zd ZedZedZedZ edZ!edZ"edZ#edZ$edZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,e-dk(re,yy#e$rY|wxYw)z?This module creates, deletes or modifies mappings on Infinibox.)absolute_importdivisionprint_functiona --- module: infini_map version_added: 2.9.0 short_description: Create and Delete mapping of a volume to a host or cluster on Infinibox description: - This module creates or deletes mappings of volumes to hosts or clusters on Infinibox. - For Linux hosts, after calling this module, the playbook should execute "rescan-scsi-bus.sh" on the host when creating mappings. - When removing mappings "rescan-scsi-bus.sh --remove" should be called. - For Windows hosts, consider using "'rescan' | diskpart" or "Update-HostStorageCache". author: David Ohlemacher (@ohlemacher) options: host: description: - Host Name type: str required: false cluster: description: - Cluster Name type: str required: false state: description: - Creates mapping when present or removes when absent, or provides details of a mapping when stat. required: false default: present choices: [ "stat", "present", "absent" ] type: str volume: description: - Volume name to map to the host. type: str required: true lun: description: - Volume lun. type: int extends_documentation_fragment: - infinibox a - name: Map a volume to an existing host infini_map: host: foo.example.com volume: bar state: present # Default user: admin password: secret system: ibox001 - name: Map a volume to an existing cluster infini_map: cluster: test-cluster volume: bar state: present # Default user: admin password: secret system: ibox001 - name: Unmap volume bar from host foo.example.com infini_map: host: foo.example.com volume: bar state: absent system: ibox01 user: admin password: secret - name: Stat mapping of volume bar to host foo.example.com infini_map: host: foo.example.com volume: bar state: stat system: ibox01 user: admin password: secret ) AnsibleModulemissing_required_lib) HAS_INFINISDK api_wrapper get_clusterget_host get_system get_volumeinfinibox_argument_specmerge_two_dicts)APICommandFailedcT|j}|D]}|j|k(syy)z4 Return a bool showing if a vol is mapped to a host TFget_lunsvolume)rhost host_lunsluns r/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/infinidat/infinibox/plugins/modules/infini_map.pyvol_is_mapped_to_hostrvs0 I ::  cT|j}|D]}|j|k(syy)z7 Return a bool showing if a vol is mapped to a cluster TFr)rcluster cluster_lunsrs rvol_is_mapped_to_clusterrs3##%L ::  rcddd}|jd}|r?|jD],}||jk(s|j|k(rddd}(ddd}.|S)z7 Return a dict showing if a host lun matches a volume. Flun_usedlun_volume_matchesrT)paramsrrr)modulerr check_result desired_lunhost_luns rfind_host_lun_user(sh %UCL--&K  SHhll*??f,04D#QL04E#RL  S rcddd}|jd}|r5|jD]"}||k(s |j|k(rddd}ddd}$|S)z: Return a dict showing if a cluster lun matches a volume. Fr rT)r#rr)r$rrr%r& cluster_luns rfind_cluster_lun_user+sg %UCL--&K"++- SKk)>>V+04D#QL04E#RL  S rcpd}|j}|D]}|j|k(s|j} |S)z Find a hosts lun Nrrr)rr found_lunlunsrs r find_host_lunr0s>I ==?D  :: I  rcpd}|j}|D]}|j|k(s|j} |S)z Find a cluster's LUN Nr-)rrr.r/rs rfind_cluster_lunr2sAI    D  :: I  rct||}t||}|rt||}|S|rt||}|Sd}|j |S)z_ Create mapping of volume to host or cluster. If already mapped, exit_json with changed False. z4A programming error has occurred in create_mapping()msg)r r create_mapping_to_hostcreate_mapping_to_cluster fail_jsonr$systemrrchangedr5s rcreate_mappingr<sj FF #D&&)G (8 N +FF; NES! Nrc d}t||}t||}|jd}|jd}|jd}t|||}|drd|d|d|d } |j |  |jd} |j s|j || d }|S#t$r?} d t| vr'd|d|dt| d} |j | Yd} ~ |Sd} ~ wwxYw)zW Create mapping of volume to cluster. If already mapped, exit_json with changed False. Frrrr!!Cannot create mapping of volume '' to cluster ' ' using lun ''. Lun in use.r4rTis already mappedCannot map volume '': . Already mapped.N) r r r#r+r8 check_mode map_volumerstr) r$r:r;rr volume_name cluster_namelun_namelun_user5r&errs rr7r7s'G&&)G  'F--)K==+L}}U#H"67F;Gz1+n\NZghpgqqAS!&mmE*     v;  7 N & c#h .' }N<.PSTWX[T\S]]noC     % N &s90B++ C344C..C3c &d}|jj|jd}t||}|jd}|jd}|jd}t |||}|drd|d|d |d } |j |  |jd} |j s|j|| d }|S#t$r?} dt| vr'd|d|dt| d} |j | Yd} ~ |Sd} ~ wwxYw)zT Create mapping of volume to host. If already mapped, exit_json with changed False. Fr)namerrr!r> ' to host 'r@rAr4rBTrCrDrErFN) hostsgetr#r r(r8rGrHrrI) r$r:r;rrrJ host_namerLrMr5r&rNs rr6r6s1G <<  v!6  7D  'F--)K f%I}}U#Hf5Gz1+k)TabjakkyzS!&mmE*   OOF O 4 N & c#h .' {+i[CPSH:UfgC     % N &s0C D4D  Dc Jt||}t||}|jd}|jd}|jd}t||sd|d|d}|j ||r2t ||}||k7r!d|d |d |d |d }|j |d } | S) z Update a mapping to a host rrrVolume '' is not mapped to host ''r4Cannot change the lun from '' to '"' for existing mapping of volume 'rQF)r r r#rr8r0) r$r:rrrJrTr&r5r.r;s rupdate_mapping_to_hostr\s FF #D  'F--)K f%I--&K  . %>ykKS!!$/  #0 6+Npq|p}~IJSITTUVC     %G Nrc Ht||}t||}|jd}|jd}|jd}t||sd|d|}|j ||r2t ||}||k7r!d|d|d |d |d }|j |d } | S) z Update a mapping to a cluster rrrzVolume z is not mapped to cluster r4rYrZr[r?rXF)r r r#rr8r2) r$r:rrr&rJrKr5r.r;s rupdate_mapping_to_clusterr^&s&&)G  'F--&K--)K==+L #FG 4 }$>|nMS!$Wf5  #0 6+Npq|p}~LMYLZZ[\C     %G Nrct||}t||}|rt||}|S|rt||}|Sd}|j |S)z Delete a mapping z4A programming error has occurred in delete_mapping()r4)r r delete_mapping_to_hostdelete_mapping_to_clusterr8r9s rdelete_mappingrb=sj FF #D&&)G (8 N +FF; NES! Nrc d}d}|jsqt||}t||}|jd}|jd}|r/|r- t ||}|j |d}d|d|d|d }n d|d|d}nd}|j||y#t $rD} d t| vr$|jd |d |d t| n d|d|d}Yd} ~ \d} ~ wwxYw)a$ Remove mapping of volume from host. If the either the volume or host do not exist, then there should be no mapping to unmap. If unmapping generates a key error with 'has no logical units' in its message, then the volume is not mapped. Either case, return changed=False. FrrTrVz' was unmapped from host '' freeing lun 'rXhas no logical unitsCannot unmap volume 'z ' from host 'rEz' was not mapped to host '#' and so unmapping was not executedNEither volume 'z ' or host ',' does not exist. Unmapping was not executedr5r;) rGr r r#r0 unmap_volumeKeyErrorrIr8 exit_json) r$r:r;r5rrrJrT existing_lunrNs rr`r`Rs'G C   FF+'mmH- MM&) d {,T6: !!&)  -G {Rabnaoopq$K= I;FrsC g. {)S9$$'<[MW`Vaadehilemdn%op$[M1KI;VyzC  {s +B C%!:C  C%c d}d}|jsqt||}t||}|jd}|jd}|r/|r- t ||}|j |d}d|d|d|d }n d|d|d}nd}|j||y#t $rG} d t| vr'd |d |d t| }|j|n d|d|d}Yd} ~ _d} ~ wwxYw)a* Remove mapping of volume from cluster. If the either the volume or cluster do not exist, then there should be no mapping to unmap. If unmapping generates a key error with 'has no logical units' in its message, then the volume is not mapped. Either case, return changed=False. FrdrrTrVz' was unmapped from cluster 'rerXrfrgz' from cluster 'rEr4z' was not mapped to cluster 'rhNriz' or cluster 'rjrk) rGr r r#r2rlrmrIr8rn) r$r:r;r5rrrJrKrorNs rraravs0G C   FF+ff-mmH- }}Y/ g A/@ $$V,  -J<.Xghtguuvw$K=|nLxyC g. A)S91+>N|n\_`cdg`h_ijC$$$-$[M1N|n\AC  As +B C(!=C##C(c|j}|D]G}|j|jjk(s/t|j}|cStS)z Get mapping fields )id)rget_namerdictrr)rhost_or_clusterr/r field_dicts rget_mapping_fieldsrws]  # # %D ??  3 3 5 566J   6Mrclt|}t||}t||}t||}|jd}|jd}|jd}|s|j d|d|s|sd|d|d }|j ||r t ||s7|r t||s)|r d|d |d }n |r d|d |d }|j |rS|rQt||} t||} | d|d|d| d }td| |} nd|d |d }|j |ni|rS|rQt||} t||} | d|d|d| d }td| |} n0d|d |d }|j |nd}|j |t  } |jdi| y )z Return mapping stat rrrrV ' not foundr4Neither host '' nor cluster '' foundrWrXz' is not mapped to cluster 'Nz' is mapped to host 'r@F)r; volume_lunr5z' is mapped to cluster 'z1A programming error has occurred in handle_stat())r r r r r#r8rrr0rwrtr2rrn) r$r:rrrrJrTrKr5r.rvresults r handle_statrs+  F  'F FF #D&&)G--)K f%I==+L x }K@A ykgNS! -fd;$ykW`VaabcC$F [M)B9+QOC     % \$Wf5 '8  [M)A,}]f\gghiC$F [M)El^STUC     %AS! VZ 0FFvrct|}t||}t||}t||}|jd}|jd}|jd}|s|j dd|d|s$|s"|sd}|sd}|j dd |d |d |rGt ||st||}d|d |d } nmt||}t||} d|d |d| d} nH|rFt||st||}d|d|d } n$t||}t||} d|d|d| d} t } |jdi| y)z Create or update mapping rrrFrVryr;r5z not specifiedrzr{r|z' map to host 'z ' createdz' already exists using lun 'rXz' map to cluster 'Nr~)r r r r r#r8rr<r\r0rr^r2rtrn) r$r:rrrrJrTrKr;r5rors rhandle_presentrs  F  'F FF #D&&)G--)K f%I==+L h{m;,OP 'I*LnYKWcVddk,lm $VT2$VV4G[M 9MC,VVSC/?G+GVIefresstuC  FFvrc Bt|}t||}t||}t||}|jd}|jd}|jd}|r|s |s|j dd|d|d|d y t ||}|j |d y ) z Remove mapping rrrFzMapping of volume z to host z or cluster z already absentrzMapping removedN)r r r r r#rnrb) r$r:rrrrJrTrKr;s r handle_absentr s  F  'F FF #D&&)G--)K f%I==+L $w.@ YW`Vaamnzm{|K-L M 0.?@rc*|jd} |dk(r t|n7|dk(r t|n&|dk(r t|n|j d|t |}|j y#t |}|j wxYw)z3Determine which state function to execute and do sostatestatpresentabsentz'Internal handler error. Invalid state: r4N)r#rrrr8r logout)r$rr:s r execute_staters MM' "E  F?   i  6 " h  & !   #J5'!R  SF# F# s AA55Bc|jd}|jd}|r|rd}|j||s|sd}|j|yyy)zVerify module options are sanerrzCinfini_map requires a host or a cluster but not both to be providedr4z6infini_map requires a host or a cluster to be providedN)r#r8)r$rTrKr5s rcheck_parametersr,s[ f%I==+L\SS! \FS!*9rc Lt}|jttddtddtdgdtdtd  t|d }ts|j t d t|t|y)z Main FN)requireddefaultr)rrr)rchoicesT)rint)type)rrrrr)supports_check_mode infinisdkr4) rupdatertrrr8rrr) argument_specr$s rmainr9s+-M ud3%6y2OP&%  =d CF 1+>?V&r__main__N).__doc__ __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESansible.module_utils.basicrrFansible_collections.infinidat.infinibox.plugins.module_utils.infiniboxrr r r r r rrinfinisdk.core.exceptionsr ImportErrorrrr(r+r0r2r<r7r6r\r^rbr`rarwrrrrrr__name__r~rrrsU F CB * X$ PK    :      ,  8  8  ,  ,  (  /  /F !/ !/H 8v&R A " ", zF{  sB++B32B3