Release Notes

On this page:

2021.2.4 Maintenance Release

2021.2.4 Maintenance Release [2022-05-03]

Changelog Overview

  • 1 New Features
  • 20 Improvements
  • 52 Bug Fixes
  • 4 Security Fixes
  • 5 Chores
  • 1 Deprecations
  • 10 Tests
  • 93 Total Tickets

New Features

  • pronghorn-core:13.15.17-2021.2.69 [04-19-2022] - Added the ability to build user principal objects to AAA adapters.

Improvements

  • adapter-nso:7.8.2-2021.2.9 [04-18-2022] - Added a trace log to fetch models functions and changed the connect process to run serially instead of parallel.
  • app-admin_essentials:3.5.64-2021.2.39 [04-08-2022] - Removed masking from repo configs when vaultProps is set to readOnly.
  • app-admin_essentials:3.5.64-2021.2.38 [04-02-2022] - Added an error banner to the import dialog to indicate if a Pre-built is already installed.
  • app-automation_studio:3.61.22-2021.2.35 [04-19-2022] - Updated the canvas title bar to use the Rodeo-UI PHTitleBar component.
  • app-automation_studio:3.61.22-2021.2.30 [04-11-2022] - Added the PHButtonBar component to the sidebar navigation in Automation Studio.
  • app-automation_studio:3.61.22-2021.2.26 [04-04-2022] - Updated the design for sidebar pagination. A "View All ## Results" button now displays to indicate more items are available.
  • app-automation_studio:3.61.22-2021.2.25 [04-01-2022] - Added getServerTimeZone to the Scheduler Window in the task sidebar.
  • app-configuration_manager:3.90.10-2021.2.38 [04-08-2022] - Converted Titlebar to PHTitleBar.
  • app-form_builder:4.11.7-2021.2.9 [04-04-2022] - Updated the design for sidebar pagination. A "View All ## Results" button now displays to indicate more items are available.
  • app-jst:1.5.18-2021.2.8 [04-11-2022] - Updated the left navigation bar to include a "View all results" button to indicate when more transformations are available than are displayed.
  • app-mop:6.11.8-2021.2.6 [04-07-2022] - Updated the design for sidebar pagination. A "View All ## Results" button will display to indicate more items are available.
  • app-workflow_builder:5.44.8-2021.2.17 [04-15-2022] - Updated the design for sidebar pagination. A View All ## Results button now displays to indicate more items are available.
  • app-workflow_engine:9.12.7-2021.2.39 [04-21-2022] - Added childJobLoopIndex as a job variable for childJob loops. This enables the index value to be referenced within all child jobs.
  • pronghorn-core:13.15.17-2021.2.77 [05-03-2022] - Updated the description for a more clearly defined brokerPrincipal property.
  • pronghorn-core:13.15.17-2021.2.68 [04-18-2022] - Cleaned up the excess data sent in the service module handshake.
  • pronghorn-core:13.15.17-2021.2.67 [04-16-2022] - Updated title and description fields in the Profile schema for consistency. Added missing titles and descriptions, and corrected capitalization and punctuation.
  • pronghorn-core:13.15.17-2021.2.64 [04-15-2022] - Removed the refreshCachedGlobals function from the profiles route.
  • pronghorn-core:13.15.17-2021.2.62 [04-07-2022] - Updated the service module for global configuration to contain core methods.
  • pronghorn-core:13.15.17-2021.2.60 [04-02-2022] - Updated the authorization schema for AWS Integrations.
  • pronghorn-core:13.15.17-2021.2.59 [03-29-2022] - Added a "blocked" status to the RabbitMQ service returned by the Status API. This status will generate an alert on the Profiles page in Admin Essentials notifying users that the queue connections are blocked.

Bug Fixes

  • adapter-nso:7.8.2-2021.2.10 [04-21-2022] - Modified the Xpath expression to resolve a multi-adapter crash issue.
  • adapter-nso:7.8.2-2021.2.8 [04-01-2022] - Fixed the issue that testInstances task that does not return data in xml format.
  • app-admin_essentials:3.5.64-2021.2.42 [04-22-2022] - Moved the Advanced View button from the Logging tab to the Configuration tab.
  • app-admin_essentials:3.5.64-2021.2.41 [04-19-2022] - Fixed scrolling on the Profile Configuration page.
  • app-admin_essentials:3.5.64-2021.2.37 [04-02-2022] - Added a banner to notify users that RabbitMQ is unavailable due to blocked queues.
  • app-automation_catalog:2.11.10-2021.2.12 [04-13-2022] - Corrected a bug that caused the applications sub-menu to not appear.
  • app-automation_studio:3.61.22-2021.2.41 [04-23-2022] - Updated the authorization checks to display all transformation data and JST settings based on the current user's role permissions.
  • app-automation_studio:3.61.22-2021.2.40 [04-23-2022] - Fixed the View All Results sidenav logic for workflows.
  • app-automation_studio:3.61.22-2021.2.39 [04-22-2022] - Fixed an issue in which the Gen 2 job canvas would crash when multiple tasks were selected.
  • app-automation_studio:3.61.22-2021.2.38 [04-22-2022] - Improved error handling by making error objects accessible in subsequent tasks in a Gen 2 workflow.
  • app-automation_studio:3.61.22-2021.2.37 [04-20-2022] - Changed notification behavior to display a single notification when deleting a workflow group in Automation Studio.
  • app-automation_studio:3.61.22-2021.2.36 [04-19-2022] - Fixed the ability to search a workflow, form, template, and transformation collection by tags.
  • app-automation_studio:3.61.22-2021.2.33 [04-15-2022] - Importing multiple documents no longer opens the first imported document. In addition, the transformation option is now pre-selected when you open the import dialog from the Transformation tab of the Collections Dialog.
  • app-automation_studio:3.61.22-2021.2.32 [04-14-2022] - Fixed export functionality for forms, templates, and transformations when exporting via the top toolbar button in the Collections dialog.
  • app-automation_studio:3.61.22-2021.2.31 [04-14-2022] - Gave JSON Forms access to core endpoints for dynamic dropdowns.
  • app-automation_studio:3.61.22-2021.2.29 [04-08-2022] - Sorting sets nullish values at the end of the Card Collection list. This fix allows existing transformations to be filtered and sorted based on the date created.
  • app-automation_studio:3.61.22-2021.2.28 [04-07-2022] - Restored the ability to search for JSTs by ID in Automation Studio using the side navigation menu and Collections view.
  • app-automation_studio:3.61.22-2021.2.27 [04-04-2022] - A JSON form with a missing JST no longer crashes the UI.
  • app-automation_studio:3.61.22-2021.2.24 [03-30-2022] - The JSON Form Collection modal now closes after the user clicks the form edit button.
  • app-configuration_manager:3.90.10-2021.2.49 [04-25-2022] - Fixed an issue that prevented parsers from being seeded into the database upon launching IAP.
  • app-configuration_manager:3.90.10-2021.2.48 [04-22-2022] - Fixed the Show Variables and Show Execution Log button color scheme for light and dark mode in Template Designer.
  • app-configuration_manager:3.90.10-2021.2.46 [04-21-2022] - An error message now displays when the View Config Difference fails to load.
  • app-configuration_manager:3.90.10-2021.2.45 [04-20-2022] - Passing invalid variables in the runCompliance task now properly yields an error.
  • app-configuration_manager:3.90.10-2021.2.43 [04-13-2022] - The left side of the Golden Configuration editor is no longer cut off.
  • app-configuration_manager:3.90.10-2021.2.42 [04-13-2022] - Updated the success notification in Template Designer to reference the current template name when saving a Config Manager template.
  • app-configuration_manager:3.90.10-2021.2.41 [04-11-2022] - Fixed an issue affecting the use of severity and warning tags with comments in Golden Configuration.
  • app-configuration_manager:3.90.10-2021.2.40 [04-08-2022] - Fixed comment behavior for ALU-SR devices that would cause nested lines to report compliance incorrectly.
  • app-configuration_manager:3.90.10-2021.2.39 [04-08-2022] - Resolved issue with preview option for JSON type configurations. The preview button is no longer stuck in a disabled (grayed out) state.
  • app-configuration_manager:3.90.10-2021.2.37 [03-29-2022] - Fixed a migration script error to prevent duplication of an existing CM_Configs collection in the database.
  • app-form_builder:4.11.7-2021.2.8 [03-30-2022] - Workflow groups have been added to the app-form_builder navbar. Also added the ability to delete and edit a workflow group.
  • app-json_forms:1.33.5-2021.2.10 [04-28-2022] - Importing a prebuilt with a form no longer assigns a new id.
  • app-json_forms:1.33.5-2021.2.9 [04-07-2022] - Made the JSON Form task dialog wider and added padding around the form elements.
  • app-mop:6.11.8-2021.2.5 [03-29-2022] - Workflow groups have been added to the app-mop navbar for Command and Analytic Templates. Also added the ability to delete and edit a workflow group.
  • app-operations_manager:1.135.13-2021.2.41 [04-27-2022] - Fixed a UI error that occurred when a user clicks the Start/End task or a task that has not yet run.
  • app-operations_manager:1.135.13-2021.2.39 [04-26-2022] - Improved the clarity of the TypeError message given when a connection to RabbitMQ fails.
  • app-operations_manager:1.135.13-2021.2.35 [04-19-2022] - Fixed a bug which prevented the auto-work feature in Operations Manager from obtaining tasks in child jobs.
  • app-operations_manager:1.135.13-2021.2.33 [04-08-2022] - Fixed a bug that prevented invalid form data from being saved to manual triggers. This fix supports the use case of saving partial or draft form data to a manual trigger before running it.
  • app-operations_manager:1.135.13-2021.2.32 [04-01-2022] - Added a permission boundary for automations and jobs.
  • app-workflow_builder:5.44.8-2021.2.19 [04-22-2022] - Updated the authorization checks to display all transformation data and JST settings based on the current user's role permissions.
  • app-workflow_builder:5.44.8-2021.2.18 [04-20-2022] - Workflow references are removed from Workflow Groups when a workflow is deleted.
  • app-workflow_builder:5.44.8-2021.2.16 [04-14-2022] - Job variables in the ChildJob task now display in the dropdown.
  • app-workflow_engine:9.12.7-2021.2.42 [05-09-2022] - Assigned a default value of 25 to the "limit" property and a maximum value of 50.
  • app-workflow_engine:9.12.7-2021.2.41 [05-09-2022] - Updated the network dependency in app-workflow_engine to the latest version.
  • app-workflow_engine:9.12.7-2021.2.40 [05-03-2022] - Fixed an issue where the inputLimit was not being defined, thereby causing apps to crash.
  • app-workflow_engine:9.12.7-2021.2.35 [04-15-2022] - Made several fixes to reduce the number of schema prongJson pipeline errors.
  • pronghorn-core:13.15.17-2021.2.76 [04-29-2022] - Updated the activeSync comparison. The Out of Sync warning banner will disappear after restarting an app or adapter.
  • pronghorn-core:13.15.17-2021.2.75 [04-27-2022] - Fixed FormBuilder to stop reloading a form after each user input.
  • pronghorn-core:13.15.17-2021.2.73 [04-25-2022] - Updated dependency modules to rectify failed tests.
  • pronghorn-core:13.15.17-2021.2.71 [04-20-2022] - Updated network and service dependencies to fix an issue with the new readOnly Vault property in Itential-utilities. Also updated Itential utilities to support the readOnly Vault property.
  • pronghorn-core:13.15.17-2021.2.66 [04-15-2022] - Fixed the referrer cookie to clear on successful login and not persist on future logins.
  • pronghorn-core:13.15.17-2021.2.63 [04-13-2022] - Added a public API to retrieve a simplified list of authorization groups.
  • pronghorn-core:13.15.17-2021.2.61 [04-04-2022] - Updated service module dependency to the latest version.

Security Fixes

  • app-configuration_manager:3.90.10-2021.2.47 [04-22-2022] - Updated the Ramda dependency to version 0.27.2 to fix a security vulnerability.
  • app-configuration_manager:3.90.10-2021.2.44 [04-19-2022] - Updated Recharts to version 2.1.3 to address a Regular Expression Denial of Service vulnerability.
  • app-workflow_engine:9.12.7-2021.2.38 [04-15-2022] - Updated dependencies to reduce the number of npm audit pipeline security warnings.
  • pronghorn-core:13.15.17-2021.2.65 [04-15-2022] - Updated the WebServer to obfuscate token values in logs.

Chores

  • app-automation_studio:3.61.22-2021.2.34 [04-18-2022] - Updated the jst and jst-designer dependencies in app-automation_studio to the latest version.
  • app-jst:1.5.18-2021.2.10 [04-23-2022] - Updated the jst-designer dependency to the latest version.
  • app-jst:1.5.18-2021.2.9 [04-18-2022] - Updated the jst and jst-designer dependencies in app-jst to the latest version.
  • app-workflow_engine:9.12.7-2021.2.36 [04-15-2022] - Updated the itential-utils dependency to enforce a 255 character limit for Job Variables in workflows.
  • pronghorn-core:13.15.17-2021.2.74 [04-27-2022] - Fixed pronghorn.json schema errors.

Deprecations

  • app-operations_manager:1.135.13-2021.2.31 [03-31-2022] - Replaced the deprecated API call to deleteJobGroups with replaceJobGroups.

Tests

  • app-operations_manager:1.135.13-2021.2.40 [04-26-2022] - Adds test coverage for verifying that getJobs returns unique jobs across pagination.
  • app-operations_manager:1.135.13-2021.2.38 [04-25-2022] - Reorganized the API, database, common and exported schema representations of the different triggers to avoid schema validation errors.
  • app-operations_manager:1.135.13-2021.2.37 [04-22-2022] - Adds getTask to task GBAC testing.
  • app-operations_manager:1.135.13-2021.2.36 [04-21-2022] - Adds more test cases to manageJobs.js test file.
  • app-operations_manager:1.135.13-2021.2.34 [04-18-2022] - Backports API tests.
  • app-workflow_engine:9.12.7-2021.2.37 [04-15-2022] - Completed the api refactor for the POST/ workflow_engine/finish Task.
  • app-workflow_engine:9.12.7-2021.2.34 [04-11-2022] - Added unit tests for proxy feature.
  • app-workflow_engine:9.12.7-2021.2.33 [04-07-2022] - Refactored pauseJob API test.
  • pronghorn-core:13.15.17-2021.2.72 [04-22-2022] - Completed the API refactor for test/functional/test/login.test.js.
  • pronghorn-core:13.15.17-2021.2.70 [04-19-2022] - Added unit tests for proxy feature.

2021.2.4 Release Versions

Automation Platform Versions

component version
@itential/adapter-automation_gateway 4.24.1-2021.2.4
@itential/adapter-azure_aaa 1.3.2-2021.2.5
@itential/adapter-email 4.2.2-2021.2.5
@itential/adapter-ldap 2.13.1-2021.2.4
@itential/adapter-local_aaa 4.3.1-2021.2.3
@itential/adapter-nso 7.8.2-2021.2.10
@itential/adapter-radius 2.1.1-2021.2.2
@itential/app-admin_essentials 3.5.64-2021.2.42
@itential/app-ag_manager 1.16.1-2021.2.2
@itential/app-automation_catalog 2.11.10-2021.2.12
@itential/app-automation_studio 3.61.22-2021.2.41
@itential/app-configuration_manager 3.90.10-2021.2.49
@itential/app-form_builder 4.11.7-2021.2.9
@itential/app-json_forms 1.33.5-2021.2.10
@itential/app-jst 1.5.18-2021.2.10
@itential/app-mop 6.11.8-2021.2.6
@itential/app-nso_manager 2.23.0-2021.2.2
@itential/app-operations_manager 1.135.13-2021.2.41
@itential/app-service_catalog 3.11.1-2021.2.2
@itential/app-service_management 2.24.3-2021.2.4
@itential/app-template_builder 2.6.2-2021.2.1
@itential/app-workflow_builder 5.44.8-2021.2.19
@itential/app-workflow_engine 9.12.7-2021.2.42
@itential/pronghorn-core 13.15.17-2021.2.77
@itential/search 1.1.18-2021.2.4
@itential/tags 3.1.5-2021.2.2
@itential/itential-utils 2.9.0

Automation Gateway Versions

component version
automation_gateway 3.176.0+2021.2.19

NSO Manager Versions

component version
itential-tools 1.23.35.2021.2.1

Engine Versions

component version
policy-engine 1.10.7+2021.2.1

Dependencies

Automation Platform Server

Package Supported
nodejs >=14.17.3 <15.0.0
npm >=6.14.15 <7.0.0
python >=3.9.5
pip supported
pip >=20.2.4
textfsm >=1.1.2 <1.2.0
Jinja2 >=2.11.3 <2.12.0

The gcc-c++ and make packages should be installed from your OS distribution.

MongoDB Server

Package Supported
mongodb >=5.0.0 <5.1.0

RabbitMQ Server

Package Supported
rabbitmq >=3.8.14 <3.9.0
erlang >=22.3.0 <25.0.0
elixir >=1.10.0 <1.11.0
dedup >=0.5.0 <0.6.0

Redis Server

Package Supported
redis >=5.0.12 <6.0.0

The gcc-c++ and make packages should be installed from your OS distribution.

Hashicorp Vault

Package Supported
vault >=1.0.0 <2.0.0

Automation Gateway

Package Supported
python >=3.9.5 <4.0.0
openssl >=1.1.0 <=1.2.0
haproxy >=2.0.0 <3.0.0

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package Supported
pip 20.2.4
ansible >=2.9.0 <2.11.0
terraform >=0.12.0 <0.13.0
nornir >=3.0.0 <4.0.0
netmiko >=3.0.0 <4.0.0

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

NSO/Itential Tools

Package Supported
java >=1.70 <1.9.0

The ant package should be installed from your OS distribution.

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.17
* 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.4.4
* 5.5.1
* 5.6

NSO NED Versions:

ned 5.4.4 5.5.1 5.6
a10-acos 3.18 3.18 3.18
adtran-aos 4.0.6 4.0.6 4.0.6
alu-sr 8.13.4 8.13.4
8.13.3
8.13.3
6.13.4
8.21
arista-dcs 5.20.2 5.20.2
5.20
5.20.2
5.23
checkpoint-gaiaos_rest n/a 1.10.7
1.10.6
1.10.7
1.10.6
1.10.22
ciena-acos 6.2.5 6.2.5
6.2.4
6.2.4
6.2.5
6.4
cisco-aireos 3.7.2
3.7.1
3.7.2
3.7.1
3.7.1
3.7.2
3.9.3
cisco-asa 6.12.4 6.12.4
6.12.3
6.12.3
6.12.4
6.13.6
cisco-gss 2.1.1 2.1.1 2.1.1
cisco-ios 6.69
6.68.2
6.69
6.68.2
6.68.2
6.72.2
6.74.11
cisco-iosxr 7.33 7.33
7.32.5
7.32.5
7.33
7.36
cisco-nx 5.21.1 5.21.1
5.21
5.21.1
5.22.1
cisco-qps 5.1.3 5.1.3 5.1.3
5.1.7
cisco-staros 5.34.6
5.34.5
5.34.6
5.34.5
5.34.5
5.34.6
5.41.1
ericsson-sgsnmme 1.0.7 n/a n/a
f5-bigip 3.17
3.16
3.17
3.16
3.16
3.17
3.21.1
fortinet-fortios 5.4.21 5.4.21
5.4.20
5.4.20
5.4.21
5.5
huawei-usn 1.2.1 n/a n/a
huawei-vrp 6.17.4
6.17.3
6.17.4
6.17.3
6.17.3
6.17.4
6.26.8
juniper-junos 4.6.19
4.6.17
4.6.19
4.6.17
4.6.19
4.6.23
4.6.33
paloalto-panos_cli 4.8.2
4.8.1
4.8.2
4.8.1
4.8.2
4.8.1
4.8.8
radware-alteonos 2.4.1 2.4.1
2.4
2.4.1
2.4
unix-bind 2.1.0 2.1.0 2.1.0
2.1.3

VTS Versions:

* 2.6.2

VTS NED Versions:

ned 2.6.2
cisco-iosxr 6.6
cisco-ncs5500 1.0
cisco-nx 5.1.4

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 maintenance release was tested against the following browser versions:

* Firefox 89
* Chrome 91.0.4472.77
* Edge 91.0.864.37
* Internet Explorer 11