@itentialopensource/version-compliance v0.0.9-2023.1.0

Version Compliance

Table of Contents

• Overview
• Installation Prerequisites
• Requirements
• Features
• Future Enhancements
• How to Install
• How to Run

Overview

This pre-built provides users with the ability to test whether their devices are compliant with a specific version or set of versions. This is important for users that have many devices across many different device groups and golden configuration trees. This pre-built is able to validate whether or not these devices have fallen out of compliance for a given version(s). This pre-built works completely out-of-the-box and can work with any device connected to IAG.

This solution consists of the following:

• Operations Manager Automation (Version Compliance)
• JSON Form (Version Compliance)
• Jinja2 Template (Version Compliance)
• Workflow (Version Compliance)
• Workflow (Version Compliance - Get Devices)
• Workflow (Version Compliance - Version Data)
• Transformation (version-compliance-ConcatDedupe)
• Transformation (version-compliance-ConnectionObject)
• Transformation (version-compliance-MakeVersionObject)
• Transformation (version-compliance-MergeVersionData)
• Transformation (version-compliance-Sources)
• Transformation (version-compliance-UnreachableDevice)
• Pre-Built Automation (Find Active Host)

Estimated Run Time: Less than 5 minutes

Installation Prerequisites

Users must satisfy the following pre-requisites:

• Itential Automation Platform
  • ^2022.1

Requirements

This pre-built requires the following:

• Device Group containing device(s) that are onboarded onto IAG

Features

The main benefits and features of the pre-built are outlined below.

• Generates a compliance report for all input devices and versions
• Two modes of operation: Zero-Touch and Verbose
• A formatted table to clearly view results in Verbose mode
• Proper outcome variables so that the parent workflow can easily handle the command template results

Future Enhancements

• Add NSO platform support for device version information
• Add ability to parse golden configuration tree for devices

How to Install

To install the pre-built:

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Requirements section in order to install the pre-built.
• The pre-built can be installed from within Admin Essentials app. Simply search for the name of your desired pre-built and click the install button (as shown below).

How to Run

• Navigate to Operations Manager and select the "Version Compliance" automation.
• Select the manual trigger and fill in the JSON form with the desired device groups to monitor compliance for all the devices within those groups.
• Enter one or more pairings of Device Model and Device Version in the Compliant Versions table that you would like to validate the compliance.
• Navigate to active job to monitor progress.