Docs4dev
Docs
ansible / 2.10 / collections / community / general / aix_devices_module.html

community.general.aix_devices – Manages AIX devices

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_devices.

Synopsis

  • This module discovers, defines, removes and modifies attributes of AIX devices.

Parameters

Parameter Choices/Defaults Comments
attributes
dictionary
A list of device attributes.
device
string
The name of the device.
all is valid to rescan available all devices (AIX cfgmgr command).
force
boolean
    Choices:
  • no ←
  • yes
Forces action.
recursive
boolean
    Choices:
  • no ←
  • yes
Removes or defines a device and children devices.
state
string
    Choices:
  • available ←
  • defined
  • removed
Controls the device state.
available (alias present) rescan a specific device or all devices (when device is not specified).
removed (alias absent removes a device.
defined changes device to Defined state.

Examples

- name: Scan new devices
  community.general.aix_devices:
    device: all
    state: available

- name: Scan new virtual devices (vio0)
  community.general.aix_devices:
    device: vio0
    state: available

- name: Removing IP alias to en0
  community.general.aix_devices:
    device: en0
    attributes:
      delalias4: 10.0.0.100,255.255.255.0

- name: Removes ent2
  community.general.aix_devices:
    device: ent2
    state: removed

- name: Put device en2 in Defined
  community.general.aix_devices:
    device: en2
    state: defined

- name: Removes ent4 (inexistent).
  community.general.aix_devices:
    device: ent4
    state: removed

- name: Put device en4 in Defined (inexistent)
  community.general.aix_devices:
    device: en4
    state: defined

- name: Put vscsi1 and children devices in Defined state.
  community.general.aix_devices:
    device: vscsi1
    recursive: yes
    state: defined

- name: Removes vscsi1 and children devices.
  community.general.aix_devices:
    device: vscsi1
    recursive: yes
    state: removed

- name: Changes en1 mtu to 9000 and disables arp.
  community.general.aix_devices:
    device: en1
    attributes:
      mtu: 900
      arp: off
    state: available

- name: Configure IP, netmask and set en1 up.
  community.general.aix_devices:
    device: en1
    attributes:
      netaddr: 192.168.0.100
      netmask: 255.255.255.0
      state: up
    state: available

- name: Adding IP alias to en0
  community.general.aix_devices:
    device: en0
    attributes:
      alias4: 10.0.0.100,255.255.255.0
    state: available

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_devices_module.html