Itential Automation Gateway
  • Dark
    Light
  • PDF

Itential Automation Gateway

  • Dark
    Light
  • PDF

BREAKING CHANGE for 2021.2

The following are breaking changes for the 2021.2 release.

Automation Gateway directory path environment variables must now be arrays/list

In the 2021.2 release, IAG added the Configuration UI feature which allows users to make changes to the running configuration without having to restart the server. As part of this effort, IAG introduced a breaking change by converting the data type from a string to a list for many of the configuration properties that contain directory paths. The following is a list of properties impacted by the change:

  • extended_device_role_path
  • module_path
  • role_path
  • collection_path
  • playbook_path
  • nornir_module_path
  • script_path
  • terraform_path

What should I do?

If any of these properties are set as environment variables, they are required to be changed to an array/list data type. For example:

"['devtools/nornir/modules','container_support/sample_content/nornir/modules']"

Backup Database Changes

Properties are migrated to MongoDB and read on first boot only from properties.yml

Starting in 2021.2, the IAG server configuration is saved in the database automation-gateway.db. It is important to make a backup of this file before doing any upgrades. During the first boot of the server, the configuration parameters found in the properties file are inserted into the database. Any changes to the configuration parameters after the initial server boot are required to be made from the Configuration UI. The only exception are for parameters found in the System and Databases sections of the 2021.2 properties file. Those parameters are still modified by editing the properties file and restarting the server.