IBM Power Systems AIX

Getting Started

  • Installation
  • Quickstart

References

  • Modules
    • Module reference
      • _nim_upgradeios – Use NIM to update a single or a pair of Virtual I/O Servers.
      • aixpert – System security settings management.
      • alt_disk – Alternate rootvg disk management.
      • backup – Data or system volume group backup management.
      • bootlist – Alters the list of boot devices available to the system.
      • bosboot – Creates boot image.
      • chsec – Modify AIX stanza files
      • devices – Devices management.
      • emgr – System interim fixes management.
      • errpt – Run the AIX errpt command to report logged system errors.
      • filesystem – Local and NFS filesystems management.
      • flrtvc – Generate FLRTVC report, download and install security and HIPER fixes.
      • geninstall – Generic installer for various packaging formats.
      • getconf – Reports system configuration variable values as facts.
      • group – Manage presence, attributes and member of AIX groups.
      • hdcrypt_auth – Controls authentication methods
      • hdcrypt_conv – Encrypt/Decrypt logical and physical volumes.
      • hdcrypt_facts – Displays encryption/decryption related information
      • hdcrypt_pks – Adds PKS authentication method and manages PKS keys
      • inittab – Manage inittab entries on AIX.
      • install_all_updates – Updates installed software to the latest level on media and verifies the current recommended maintenance or technology level.
      • installp – Installs and updates software.
      • lku – Performs live kernel update
      • lpar_facts – Reports logical partition (LPAR) related information as facts.
        • Synopsis
        • Requirements
        • Notes
        • Examples
        • Return Values
        • Status
      • lpp_facts – Returns installed software products or fixes as facts.
      • lvg – Configure AIX LVM volume groups
      • lvm_facts – Reports LVM information as facts.
      • lvol – Configure AIX LVM logical volumes
      • mkfilt – Activates or deactivates the filter rules.
      • mktcpip – Sets the required values for starting TCP/IP on a host.
      • mktun – Creates, activates, deactivates and removes tunnels.
      • mount – Mounts/unmounts a filesystem or device on AIX.
      • mpio – Returns information about MultiPath I/O capable devices.
      • nim – Performs NIM operations - server setup, install packages, update SP or TL.
      • nim_backup – Uses NIM to manage backup of LPAR or VIOS clients.
      • nim_flrtvc – Use NIM to generate FLRTVC report, download and install security and HIPER fixes.
      • nim_resource – show/define/delete NIM resource object(s).
      • nim_select_target_disk – verify/autoselect a disk used for alternate disk migration role.
      • nim_suma – Use NIM to download fixes, SP or TL from IBM Fix Central website.
      • nim_updateios – Use NIM to update a single or a pair of Virtual I/O Servers.
      • nim_vios_alt_disk – Uses NIM to create/cleanup an alternate rootvg disk of VIOS clients.
      • nim_vios_hc – Check if a pair of VIOSes can be updated.
      • nim_viosupgrade – Use NIM to upgrade VIOS(es) with the viosupgrade tool from a NIM master.
      • nmon – Health Monitoring
      • pagingspace – Manage Paging space
      • password_hash – Encrypt password with AIX encryption methods
      • password_rules_policies – Manages password rules and policies
      • reboot – Reboot AIX machines.
      • route – Manage routes on IBM AIX systems.
      • smtctl – Enable and Disable Simultaneous MultiThreading Mode
      • snap – Run snap command on AIX.
      • suma – Download/Install fixes, SP or TL from IBM Fix Central website.
      • sysdumpdev – Manage system dump settings
      • tunables – Modify/Reset/Show tunables for various components on AIX.
      • tunfile_mgmt – Save/Restore/Validate/Modify tunables configuration file for various components on AIX.
      • user – Create new users or change/remove attributes of users on AIX.
      • vmstat – Run the AIX vmstat command to report system stats.
  • Playbooks
  • Roles

Community Guides

  • Contributing
  • Helpful Links

Requirements

  • Requirements
IBM Power Systems AIX
  • Modules
  • lpar_facts – Reports logical partition (LPAR) related information as facts.
  • Edit on GitHub

lpar_facts – Reports logical partition (LPAR) related information as facts.

  • Synopsis

  • Requirements

  • Notes

  • Examples

  • Return Values

  • Status

Synopsis

Lists and reports information related to logical partition (LPAR) in Ansible facts.

Requirements

The below requirements are needed on the host that executes this module.

  • AIX >= 7.1 TL3

  • Python >= 3.6

Notes

Note

  • You can refer to the IBM documentation for additional information on the lparstat command at https://www.ibm.com/support/knowledgecenter/ssw_aix_72/l_commands/lparstat.html.

Examples

- name: Retrieve the LPAR related information
  lpar_facts:
- name: Print the LPAR related information
  debug:
    var: ansible_facts.lpar

Return Values

ansible_facts (always, complex, )

Facts to add to ansible_facts about LPAR related information.

lpar (always, dict, )

Reports logical partition (LPAR) related information.

nodename (always, str, )

Node name.

lpar_name (when available, str, )

Partition name.

lpar_number (when available, int, )

Partition number.

lpar_type (always, str, )

Type.

lpar_mode (always, str, )

Mode.

entitled_capacity (always, float, )

Entitled capacity.

group_id (when available, int, )

Partition Group-ID.

pool_id (when available, int, )

Shared Pool ID.

online_vcpus (always, int, )

Online Virtual CPUs.

max_vcpus (always, int, )

Maximum Virtual CPUs.

min_vcpus (always, int, )

Minimum Virtual CPUs.

online_memory (always, float, )

Online Memory.

max_memory (always, float, )

Maximum Memory.

min_memory (always, float, )

Minimum Memory.

ps_16G (when available, int, )

16GB Page Memory.

variable_weight (when available, int, )

Variable Capacity Weight.

minimum_capacity (always, float, )

Minimum Capacity.

maximum_capacity (always, float, )

Maximum Capacity.

capacity_increment (always, float, )

Capacity Increment.

max_pcpus_in_sys (always, int, )

Maximum Physical CPUs in system.

pcpus_in_sys (always, int, )

Active Physical CPUs in system.

pcpus_in_pool (when available, int, )

Active CPUs in Pool.

shcpus_in_sys (when available, int, )

Shared Physical CPUs in system.

max_pool_capacity (when available, int, )

Maximum Capacity of Pool.

entitled_pool_capacity (when available, int, )

Entitled Capacity of Pool.

unalloc_capacity (when available, float, )

Unallocated Capacity.

pcpu_percent (always, float, )

Physical CPU Percentage.

unalloc_weight (when available, int, )

Unallocated Weight.

vrm_mode (when available, str, )

Memory Mode.

ent_mem_capacity (when available, float, )

Total I/O Memory Entitlement.

var_mem_weight (when available, int, )

Variable Memory Capacity Weight.

vrm_pool_id (when available, int, )

Memory Pool ID.

vrm_pool_physmem (when available, float, )

Physical Memory in the Pool.

hyp_pagesize (when available, str, )

Hypervisor Page Size.

unalloc_var_mem_weight (when available, int, )

Unallocated Variable Memory Capacity Weight.

unalloc_ent_mem_capacity (when available, float, )

Unallocated I/O Memory entitlement.

vrm_group_id (when available, int, )

Memory Group ID of LPAR.

desired_vcpus (always, int, )

Desired Virtual CPUs.

desired_memory (always, float, )

Desired Memory.

desired_variable_capwt (when available, int, )

Desired Variable Capacity Weight.

desired_capacity (always, float, )

Desired Capacity.

ame_factor_tgt (when available, float, )

Target Memory Expansion Factor.

ame_memsizepgs (when available, float, )

Target Memory Expansion Size.

psmode (when supported, str, )

Power Saving Mode.

spcm_status (when supported, str, )

Sub Processor Mode.

servpar_id (when available, int, )

Service Partition ID.

num_lpars (when available, int, )

Number of Configured LPARs.

inc_core_crypto_capable (always, bool, )

Capability of In-Core Crypto Acceleration.

inc_core_crypto_enabled (always, bool, )

Enablement of In-Core Crypto Acceleration.

nxcrypto_acc_capable (always, bool, )

Capability of NX Crypto Acceleration.

nxcrypto_acc_enabled (always, bool, )

Enablement of NX Crypto Acceleration.

full_coredump (always, bool, )

Full core dump status.

proc_imp_mode (always, str, )

Processor Implementation Mode.

proc_type (always, str, )

Processor Type.

oslevel (always, dict, )

Operating system level.

oslevel (always, dict, “oslevel”: { “build”: 2147, “sp”: 3, “tl”: 2, “base”: “7.2.0.0” })

OperatingSystemBaseVersion TechnologyLevel ServicePack Build (vrmf).

IBM.MCP_info (always, dict, )

lsrsrc IBM.MCP command’s output

resource list (always, dict, {‘resource 1’: {‘ActiveCommMode’: ‘1’, ‘ActivePeerDomain’: ‘’, ‘ConnectivityNames’: ‘{127.0.0.1}’, ‘HMCAddIPs’: ‘’, ‘HMCAddIPv6s’: ‘’, ‘HMCIPAddr’: ‘127.0.0.1’, ‘HMCName’: ‘Va87f6d*XXXXXXX’, ‘IPAddresses’: ‘{127.0.0.1}’, ‘KeyToken’: ‘somehmc’, ‘MNName’: ‘127.0.0.1’, ‘NodeID’: ‘12622478031XXXXXX’, ‘NodeNameList’: ‘{somedomain.com}’, ‘RMCKey’: ‘64b686a1XXXXXXXX’}})

Resource Persistent Attributes for IBM.MCP

Status

  • This module is not guaranteed to have a backwards compatible interface. [preview]

  • This module is maintained by community.

Authors

  • AIX Development Team (@pbfinley1911)

Previous Next

© Copyright 2020, IBM.