Checking for Incompatibilities between Version 12.1 and 12.2
As a system administrator, you need to check incompatibilities between consecutive versions before upgrading your system.
The tables below list new features that might lead to compatibility issues or should be taken care of when upgrading; they do not list all new features of this AE version. New features are described in full in the Release Highlights and Release Notes.
More information:
To provide a better overview, the tables are categorized by the severity of the issue. There are three different categories:
- Critical: Issues that must be addressed, otherwise the system will not work
- Behavior change: Functionality changes in existing features that might have an impact on your system
- Advisory: Different issues you should be aware of but might not have an impact on your system
The columns display the following information:
- Topic: Name of the general topic or new feature
- Changed behavior: What has been changed
- Possible incompatibilities: Impact the change may have
- Actions/Countermeasures: What can be done to identify and/or remove possible incompatibilities
Compatibility Issues
Critical
There are no critical issues when upgrading from version 12.1 to version 12.2.
Behavior Change
|
Topic |
Changed Behavior |
Possible Incompatibilities |
Actions/Countermeasures |
|---|---|---|---|
| AE REST API extension | New INI file parameters have been introduced. |
There are no incompatibilities, as the upgrade version works with the existing INI file. However, as the new parameters are not included in the existing INI files, they cannot be configured manually. |
Add the new parameters to the existing INI files so that they can be configured properly. The following parameters are new in the REST section:
You can copy these parameters from the default INI file shipped with the new AE version. You do not have to change their default values if there is no explicit reason to do so. |
| ServiceManager communication based on TLS 1.2 |
A new parameter has been added to the UC_SYSTEM_SETTINGS: SMGR_SUPPORT_LEGACY_SECURITY = Y/N Y = Not secure communication with legacy ServiceManagers still supported by the AE This is the default setting during upgrades from versions < 12.2.0. N = Only secure communication (TLS 1.2) between the AE and ServiceManagers is supported. This is the default setting for new installations and the recommended setting after a successful upgrade from versions < 12.2.0 and roll out of CAPKI on all concerned computers. |
All components are backwards compatible. The SM-Dialog indicates whether a connection is a secure one or not. Important! Secure communication mode currently not available for components running on:
|
CAPKI must be installed in all computers where either a Service Manager, or one of its clients is supposed to run, see CAPKI - Securing the ServiceManager. |
| Retrieve password from vault | Passwords for agents are no longer stored in the database of the Automation Engine. | You can use agents with long passwords, which are not compatible with Automation Engine versions older than 12.1. | Long passwords for agents are supported as of version 12.1. |
| Task default status (Workflow dependencies) | When creating a task, the Status in the Time & Dependencies tab of the task properties is undefined (blank) by default. It no longer is set to ANY_OK. | Existing workflows are not affected. However, if you modify the Workflow and/or add a new task you must check the status of the relevant tasks. | You can change the task status manually or you can change the status that you want to use by default. For more information, see Default Task Status for Workflow Dependencies . |
Advisory
|
Topic |
Changed Behavior |
Possible Incompatibilities |
Actions/Countermeasures |
|---|---|---|---|
|
General DB change Note: Information and the checking instructions apply to all versions, between your existing installation and the latest you want to upgrade to, respectively. |
The DB scheme/structure has been changed. |
Custom SQL queries on AE DB do not work anymore. |
|