Forge Home

aix_vios_facts

Collects structured facts about whether an AIX system is a VIO server and what version

2,452 downloads

82 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.3.4 (latest)
  • 0.3.3
  • 0.3.2
  • 0.3.1
  • 0.3.0
released Jul 9th 2024
This version is compatible with:
  • Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2021.7.x
  • Puppet >= 7.24 < 9.0.0

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'cryssoft-aix_vios_facts', '0.3.4'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add cryssoft-aix_vios_facts
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install cryssoft-aix_vios_facts --version 0.3.4

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

cryssoft/aix_vios_facts — version 0.3.4 Jul 9th 2024

aix_vios_facts

Table of Contents

  1. Description
  2. Setup - The basics of getting started with aix_vios_facts
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Description

The cryssoft-aix_vios_facts module populates the $::facts['aix_vios'] hash with a few values that are of interest if you're using Puppet to manage both VIO servers and clients. Relying only on $::facts['osfamily'] and the like can get you into trouble, so look deeper to see if your rule is attempting to update an AIX 6.1 system or a VIOS 2.2 system, an AIX 7.2 system or a VIOS 3.1 system.

Setup

Put the module in place in your Puppet master server as usual. AIX-based systems will start populating the $::facts['aix_vios'] hash with their next run, and you can start referencing those facts in your classes.

What aix_vios_facts affects

At this time, the cryssoft-aix_vios_facts module ONLY supplies custom facts. It does not change anything and should have no side-effects.

Setup Requirements

As a custom facts module, I believe pluginsync must be enabled for this to work.

Beginning with aix_vios_facts

If you're using Puppet Enterprise, the new fact(s) will show up in the PE console for each AIX-based node under management. If you're not using Puppet Enterprise, you'll need to use a different approach to checking for their existence and values.

Usage

As notes, cryssoft-aix_vios_facts is only providing custom facts. Once the module and its Ruby payload are distributed to your AIX-based nodes, those facts will be available in your classes.

Reference

$::facts['aix_vios'] is the top of a small hash. That's it.

Limitations

This should work on any AIX-based system. If it's not a VIO server, it will say so. If it is a VIO server, it will say so and give you some extended version info in the hash.

NOTE: Updated 2024/07/09 - This module works properly with VIOS 2.2, 3.1, and 4.1

Development

Make suggestions. Look at the code on github. Send updates or outputs. I don't have a specific set of rules for contributors at this point.

Release Notes/Contributors/Etc.

Starting with 0.3.0 - Pretty simple stuff. Not sure if this will ever morph into a control/configuration module with types/providers/etc. to actually do anything meaningful about controlling VIO servers.