mpio – Returns information about MultiPath I/O capable devices.
Synopsis
Returns information about MultiPath I/O capable devices.
Requirements
The below requirements are needed on the host that executes this module.
AIX >= 7.1 TL3
Python >= 3.6
Parameters
- device (optional, str, None)
Specifies the logical device name of the target device whose path information is to be returned.
- parent (optional, str, None)
Indicates the logical device name of the parent device whose paths are to be returned.
Examples
- name: Gather paths to all MultiPath I/O capable devices
mpio:
register: mpio_info
- name: Print the paths
debug:
var: mpio_info.mpio_facts.paths
Return Values
- msg (always, str, Successfully retrieved mpio facts. Check mpio_facts for more details.)
The execution message.
- cmd (always, str, /usr/bin/manage_disk_drivers -l)
The command executed.
- rc (always, int, )
The command return code.
- stdout (always, str, )
The standard output of the command.
- stderr (In case of error, str, lspath: 0514-546 Invalid parameter - ansibleNegativeTest.)
The standard error of the command.
- mpio_facts (always, complex, )
Facts about paths to MultiPath I/O capable devices.
- mpio (, dict, )
Contains information about drivers and paths.
- drivers (always, dict, {‘drivers’: {‘IBMFlash’: {‘option’: ‘NO_OVERRIDE’, ‘options’: [‘NO_OVERRIDE’, ‘AIX_AAPCM’, ‘AIX_non_MPIO’]}}})
Maps driver name to driver supported and selected options.
- option (always, str, )
Option currently selected.
- options (always, list, )
Supported driver options.
- paths (always, dict, {‘paths’: {‘hdisk0’: {‘fscsi1’: {‘500507680b215660,0’: {‘path_id’: 0, ‘path_status’: ‘Available’, ‘status’: ‘Enabled’}, ‘500507680b215661,0’: {‘path_id’: 1, ‘path_status’: ‘Available’, ‘status’: ‘Enabled’}}}}})
Maps device name to parent devices and connections.
Status
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by community.