- 10 Jul 2024
-
DarkLight
-
PDF
Configuration for IAG
- Updated on 10 Jul 2024
-
DarkLight
-
PDF
This article provides information on configuring the properties file for Itential Automation Gateway (IAG), including its web server, associated integrations, and custom content supplied by end users.
System Configuration
The System Configuration user interface (UI) is used to administer IAG properties. The UI provides a simple and straightforward way to view and modify the IAG server configuration.
Figure 1: Configuration UI
All configuration parameters, except those that reside in the System and Databases section of the properties file, can be modified via UI. Only properties in the UI that have a lock icon next to them can be changed via properties.yml
. The changes made via UI take effect dynamically without rebooting the IAG server. Changes made to properties.yml
do require a reboot. With RBAC, configuration changes are restricted to users who are members of the admin group.
⚠ Breaking changes to the data types of certain configuration parameters can be found here: IAG Breaking Changes in Product Notices.
Click here for the Configuration UI in an earlier version.
IAG 2022.1
Backup Database
The IAG server configuration is saved in the database, automation-gateway.db
. Therefore, it is very important to take 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 injected into the database. This applies to both newly created property files as well as pre-2021.2 property files being utilized to upgrade. All subsequent reboots of the server will use the configuration stored in the database. Any changes to the configuration parameters after the first server boot are required to be made from the Configuration UI. The only exception to this paradigm are parameters found in the System and Databases sections of the properties.yml file. Those parameters are still modified by editing the properties file and restarting the server.
Save Config
To modify the configuration for a subsystem, (i.e., Ansible, Nornir, Scripts), click the appropriate subsystem needed in the left sidenav menu and edit the properties (Ansible is used in the example below). Once changes are ready to be saved, click the save icon button on the top left corner and verify the success dialog appears on the top right corner of the page.
Figure 2: Save Config UI
System Configuration
The System Configuration menu option is read-only. The page is only to be used to view System Configuration parameters and cannot be edited.
Figure 3: System Configuration UI
Audit Log
If the audit
in config file is set to true, audit logging is enabled. It is enabled by default. To disable it, set it to false
. For more details, refer to Audit Log.
Password Reset Functionality
If the password_reset_enabled
flag is set to true (enabled), admin and users have the ability to recover username or reset the password rather than getting locked out of IAG server.
For more details on first time login with password reset functionality enabled, refer to Installation Validation.
Figure 1: Forgot Username/Password
Figure 2: Password Reset