2022.1.4 Maintenance Release

Changelog Overview

• 8 Improvements
• 50 Bug Fixes
• 36 Chores
• 6 Tests
• 100 Total Tickets

Improvements

• adapter-nso:7.8.20-2022.1.11 [11-25-2022] - Added a new task "invalidateDeviceInfoCache" to invalidate caching for a list of devices.
• app-configuration_manager:3.97.6-2022.1.14 [11-10-2022] - Corrected the schema for API importBackup and importGroup.
• app-configuration_manager:3.97.6-2022.1.13 [11-07-2022] - Updated the updateGoldenConfigTree API documentation to include an example payload.
• app-operations_manager:1.171.4-2022.1.45 [11-15-2022] - Adjusted UI element colors to improve legibility.
• app-operations_manager:1.171.4-2022.1.38 [11-07-2022] - Changed the UI contrast ratio in some areas of Operations Manager to comply with accessibility standards.
• app-operations_manager:1.171.4-2022.1.36 [11-04-2022] - Changed the UI contrast ratio in some areas of Operations Manager to comply with accessibility standards.
• network:3.3.17 [10-12-2022] - Removed unused classes and files from the network module.
• pronghorn-core:13.28.27-2022.1.42 [11-11-2022] - Updated example responses and JSON Schema references in the importPrebuilt and updatePrebuilt API documentation.

Bug Fixes

• adapter-automation_gateway:4.26.1-2022.1.5 [11-09-2022] - Improved error messaging in Golden Config for why compliance remediation failed.
• adapter-nso:7.8.20-2022.1.12 [11-29-2022] - Removed 'compliance' from the brokers in pronghorn.json.
• adapter-nso:7.8.20-2022.1.9 [11-17-2022] - The NSO adapter now includes the 'Service' and 'Compliance' brokers by default.
• adapter-nso:7.8.20-2022.1.8 [11-09-2022] - Removed an erroneous space from the NSO adapter's max_cache_entries property.
• adapter-nso:7.8.20-2022.1.7 [11-08-2022] - Fixed the property caching settings defined in propertiesSchema.json.
• app-admin_essentials:3.13.12-2022.1.17 [11-11-2022] - Updated the user management permission checks to use updated API names.
• app-admin_essentials:3.13.12-2022.1.16 [11-04-2022] - An error message now appears if a user attempts to create a tag with a name that already exists.
• app-admin_essentials:3.13.12-2022.1.16 [11-03-2022] - Fixed a bug in the profile description field. All characters are now properly displayed as the user types them into the field.
• app-admin_essentials:3.13.12-2022.1.16 [11-03-2022] - Resolved a config error when the user attempts to view a Pre-built from the local repository.
• app-admin_essentials:3.13.12-2022.1.14 [11-03-2022] - Resolved issues with selected context in the sidebar menu. The menu no longer collapses when an item is selected.
• app-admin_essentials:3.13.12-2022.1.13 [10-31-2022] - Updated JSON Form processing to resolve errors that were thrown during schema checking.
• app-admin_essentials:3.13.12-2022.1.12 [10-31-2022] - Updated the placeholder text in the Pre-Built search bar to indicate that 3 or more characters are required in the search query.
• app-automation_catalog:2.12.11-2022.1.1 [11-22-2022] - The repeat interval of a scheduled automation now maintains its relationship to the original start time when there is an IAP outage.
• app-automation_studio:4.1.2-2022.1.44 [11-22-2022] - Updated documentation link for JSON Forms user guide.
• app-automation_studio:4.1.2-2022.1.43 [11-16-2022] - Pre-builts with a transformation set for a childJob loop now import correctly if the ID of the transformation exists in the database and references the transformation in the correct format.
• app-automation_studio:4.1.2-2022.1.42 [11-15-2022] - Updated the workflow schema that is accepted upon import to account for JST-on-transitions tasks.
• app-automation_studio:4.1.2-2022.1.40 [11-10-2022] - The browser pop-up dialog is now dismissed after the proactive logout notice and the page is re-directed to the login screen.
• app-automation_studio:4.1.2-2022.1.39 [11-09-2022] - Updated migration logic to prevent duplicate function ids and check if thisArgs has properties before indexing.
• app-automation_studio:4.1.2-2022.1.38 [11-08-2022] - Fixed issue where JSTs referenced in pre-builts were sometimes created twice.
• app-automation_studio:4.1.2-2022.1.37 [10-31-2022] - Fixed the unit test for createTemplate API.
• app-configuration_manager:3.97.6-2022.1.12 [11-02-2022] - Removed unintended scrollbars in Firefox.
• app-json_forms:1.34.12-2022.1.4 [11-23-2022] - Fixed an issue that prevented users from importing JSON Forms in which the 'default' key was an array.
• app-jst:1.8.5-2022.1.15 [11-09-2022] - Updated migration logic to prevent duplicate function ids and check that thisArgs has properties before indexing.
• app-jst:1.8.5-2022.1.14 [11-08-2022] - Fixed the encoding and decoding logic in app-jst to resolve run errors in transformations.
• app-jst:1.8.5-2022.1.13 [10-31-2022] - Re-routed the legacy transformation URL to its new location in Automation Studio.
• app-mop:6.11.25-2022.1.6 [11-22-2022] - The device search icon for Command and Analytic templates is no longer hidden.
• app-operations_manager:1.171.4-2022.1.50 [12-06-2022] - Made CSS changes to correct UI inconsistencies under the Job Properties/Task Properties sidebar.
• app-operations_manager:1.171.4-2022.1.47 [11-21-2022] - Updated the useGroups hooks by setting the default limit to "Infinity", which allows all groups existing in the database to be retrieved into the Operations Manager UI.
• app-operations_manager:1.171.4-2022.1.43 [11-14-2022] - Corrected a bug causing event triggers to not run in certain scenarios.
• app-operations_manager:1.171.4-2022.1.42 [11-10-2022] - Users can now vertically scroll through a selected form when creating or editing a trigger.
• app-operations_manager:1.171.4-2022.1.35 [11-03-2022] - Corrected a bug that caused referenced task variables to be displayed incorrectly for looping child jobs.
• app-operations_manager:1.171.4-2022.1.34 [10-31-2022] - Implemented a trigger control to prevent users from clicking the Run button on the Run Automation panel more than once while a file upload is active.
• app-service_management:2.24.9-2022.1.3 [11-17-2022] - Enabled formatting for white space and newline characters in the Device Modifications results dialog.
• app-workflow_builder:5.44.64-2022.1.21 [11-22-2022] - The magnifying glass icon in the search box of the ChildJob task now correctly renders.
• app-workflow_builder:5.44.64-2022.1.20 [11-11-2022] - The browser pop-up alert no longer appears in Workflow Builder after the proactive logout notice.
• app-workflow_builder:5.44.64-2022.1.19 [11-09-2022] - Changed migration logic to prevent users from uploading JSTs containing duplicate function IDs. Also added a check to ensure thethisArgs object has properties before it is indexed.
• app-workflow_engine:9.13.31-2022.1.26 [12-07-2022] - Reverted breaking changes that affected the makeData task.
• app-workflow_engine:9.13.31-2022.1.25 [12-03-2022] - The makeData API is now able to handle multi-line variable input.
• app-workflow_engine:9.13.31-2022.1.24 [11-30-2022] - The deepMerge task no longer returns an error on inputs that are not objects.
• app-workflow_engine:9.13.31-2022.1.23 [11-17-2022] - Made the 'eventlistener' test case more robust.
• database:1.11.6 [11-16-2022] - Fixed encoding to no longer encode undefined values in arrays.
• pronghorn-core:13.28.27-2022.1.47 [12-07-2022] - Fixed an issue that prevented Configuration Manager from displaying devices.
• pronghorn-core:13.28.27-2022.1.46 [12-05-2022] - Made code changes to ensure the user object is stored and passed into brokered calls to build the principal on expiration.
• pronghorn-core:13.28.27-2022.1.45 [11-23-2022] - Users are signed out correctly when using the sign out button in legacy applications.
• pronghorn-core:13.28.27-2022.1.43 [11-11-2022] - Updated API method names to fix pronghorn.json generation errors.
• pronghorn-core:13.28.27-2022.1.41 [11-11-2022] - Changed the default status code for login errors from 500 to 401.
• pronghorn-core:13.28.27-2022.1.40 [11-09-2022] - Updated the default syslog value to error.
• pronghorn-core:13.28.27-2022.1.39 [11-08-2022] - Added a sortHelper to modify the order of pre-built components so that transformations are imported before workflows.
• pronghorn-core:13.28.27-2022.1.37 [11-04-2022] - Pre-builts containing both integrations and integration models can now be imported via the importMap variable.
• pronghorn-core:13.28.27-2022.1.35 [10-26-2022] - Updated documentation for the checkIndexes API to include the 'external' key.

Chores

• adapter-automation_gateway:4.26.1-2022.1.6 [11-22-2022] - Moved itential-utils from a dependency to a peerDependency.
• adapter-azure_aaa:1.4.2-2022.1.2 [11-16-2022] - Moved itential-utils from a dependency to a peerDependency.
• adapter-email:4.2.8-2022.1.5 [11-16-2022] - Moved itential-utils from a dependency to a peerDependency.
• adapter-ldap:2.13.8-2022.1.1 [11-16-2022] - Moved itential-utils from a dependency to a peerDependency.
• adapter-local_aaa:4.3.6-2022.1.1 [11-15-2022] - Moved itential-utils and database from dependencies to peerDependencies.
• adapter-nso:7.8.20-2022.1.10 [11-23-2022] - Moved itential dependencies to peer dependencies.
• adapter-radius:2.1.7-2022.1.1 [11-16-2022] - Moved itential-utils from a dependency to a peerDependency.
• app-admin_essentials:3.13.12-2022.1.18 [11-16-2022] - Moved itential-utils and database from dependencies to peerDependencies.
• app-ag_manager:1.18.3-2022.1.4 [11-22-2022] - Moved itential-utils and database from dependencies to peerDependencies.
• app-automation_catalog:2.12.11-2022.1.2 [11-23-2022] - Converted itential dependencies to peer dependencies.
• app-automation_studio:4.1.2-2022.1.45 [11-23-2022] - Moved core modules to peer dependencies.
• app-automation_studio:4.1.2-2022.1.41 [11-10-2022] - Updated the jst-designer dependency to the latest version.
• app-configuration_manager:3.97.6-2022.1.15 [11-21-2022] - Moved core Itential modules to peer dependencies.
• app-form_builder:4.11.26-2022.1.3 [11-22-2022] - Moved itential dependencies to peer dependencies.
• app-json_forms:1.34.12-2022.1.5 [11-23-2022] - Converted itential dependencies to peer dependencies.
• app-jst:1.8.5-2022.1.16 [11-22-2022] - Changed the itential-utils and database components from dependencies to peer dependencies.
• app-nso_manager:2.23.3-2022.1.1 [11-23-2022] - Changed the itential-utils component from a dependency to a peer dependency.
• app-operations_manager:1.171.4-2022.1.49 [12-01-2022] - Updated encode path.
• app-operations_manager:1.171.4-2022.1.48 [11-23-2022] - Moved core modules to peer dependencies.
• app-operations_manager:1.171.4-2022.1.45 [11-21-2022] - Added cypress grep as a development dependency to allow for test filtering via tags.
• app-operations_manager:1.171.4-2022.1.41 [11-10-2022] - Improved test infrastructure.
• app-operations_manager:1.171.4-2022.1.40 [11-08-2022] - Updated JST dependency to capture fixes and updates.
• app-operations_manager:1.171.4-2022.1.32 [11-01-2022] - Removed workflow rule from CI/CD yaml file.
• app-service_catalog:3.12.0-2022.1.1 [11-23-2022] - Changed the itential-utils and database components from dependencies to peer dependencies.
• app-service_management:2.24.9-2022.1.4 [11-23-2022] - Moved itential-utils from a dependency to a peerDependency.
• app-template_builder:2.6.7-2022.1.1 [11-22-2022] - Removed an unnecessary database dependency.
• app-workflow_builder:5.44.64-2022.1.22 [11-22-2022] - Moved itential dependencies to peer dependencies.
• app-workflow_engine:9.13.31-2022.1.22 [11-15-2022] - Converted itential dependencies to peer dependencies.
• audit-trail:1.4.9 [02-03-2022] - Moved project to the improved, main, pipeline.
• event-system:1.1.26 [11-07-2022] - Updated the event-system module to work in peer dependency environments.
• logger:2.1.12 [11-04-2022] - Updated logger module to work in a peer dependency environment.
• pronghorn-core:13.28.27-2022.1.38 [11-08-2022] - Converted core Itential modules into peer dependencies.
• pronghorn-core:13.28.27-2022.1.36 [10-28-2022] - Updated the service dependency to remove unnecessary validation.
• search:1.1.25-2022.1.1 [11-18-2022] - Changed the itential-utils and database components from dependencies to peer dependencies.
• service:2.10.13 [11-07-2022] - Updated the service module to work in a peer dependency environment.
• tags:3.1.12-2022.1.1 [11-11-2022] - Moved itential-utils and database from dependencies to peerDependencies.

Tests

• app-operations_manager:1.171.4-2022.1.44 [11-15-2022] - Added test cases to verify creating of default schemas and schema updates.
• app-operations_manager:1.171.4-2022.1.41 [11-11-2022] - Adds component tests for AccessControl component.
• app-operations_manager:1.171.4-2022.1.39 [11-08-2022] - Writes test cases to verify $schema are handled appropriately.
• app-operations_manager:1.171.4-2022.1.37 [11-04-2022] - Added new api tests verifying use of JSTs with event triggers.
• app-operations_manager:1.171.4-2022.1.33 [10-31-2022] - Adds test for clone api to verify endpoint trigger will run route of enabled trigger.
• pronghorn-core:13.28.27-2022.1.44 [11-15-2022] - The test case relating to the index API was updated to connect to the database using environment variables.

Release Versions

Automation Platform Versions

Automation Gateway Versions

NSO Manager Versions

Engine Versions

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app):

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO:

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Customer Success Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.10.7
* 2.9.27

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.6
* 5.7
* 5.8
* 6.0
* 6.1

NSO NED Versions:

VTS Versions:

* 2.6.2

VTS NED Versions:

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 17.02.01r
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This feature release was tested against the following browser versions:

* Firefox 103.0.2
* Chrome 104.0.5112.79
* Edge 104.0.1293.47