The following hotfix is available for Appian 21.3.

If you have a self-managed installation, you can view your current Appian version by logging into your Appian environment as a designer or system administrator and clicking the navigation menu > About Appian

This is a cumulative hotfix that includes all resolved issues listed below in a single download and set of instructions. This hotfix is required for any Appian 21.3 installations not currently up to date with the latest hotfixes. After installing, you will be running on Appian 21.3.320.0.

21.3.320.0 Hotfix

See the Installation section at the bottom of this page for instructions on how to install this hotfix.

Resolved issues


  • AN-191925 - Medium
    Fixed an issue that caused user details for null users to be inconsistent across the groups and execution engines.

  • AN-191937 - Medium
    Fixed an issue where an administrator user could not successfully generate a record action when their locale was different from the default locale of the site.

  • AN-192025 - Medium
    Generating a record action no longer configures the generated Users group object as an administrator of itself.

  • AN-188390 - Low
    Custom fields within a record type now work without an error when the custom field references a source field of type float.

  • AN-191081 - Low
    Fixed an issue that caused styling issues in Tempo when using Hebrew language.

  • Security Updates - Low

  • AN-191646 - High
    Fixed an issue which prevented updating custom data types with parent-child relationships due to an error on locked types clean up which caused the types to stay locked longer than expected.

  • AN-191652 - High
    Fixed an issue that would cause /apps portals to not load

  • AN-190627 - Medium
    Fixed an issue where design guidance incorrectly triggered the unused local variable recommendation.

  • AN-190893 - Medium
    For Appian Cloud MariaDB database, guardrail has been introduced to prevent a single query from using a large amount of temporary disk space. tmp_disk_table_size global variable has been set to 10G by default.

  • AN-190952 - Medium
    Fixed an issue which prevented some references to the function fn!isusermemberofgroup from working after upgrade when used in a record type object.

  • AN-191519 - Low
    Fixed an issue that prevented the Appian RPA integration object from passing standard JSON reserved characters into a text parameter of the robotic process.

  • Security Updates - Medium

  • AN-190741 - Low
    Fixed an issue that caused the expression editor to not properly display text when using Hebrew or Arabic language.

  • Security Updates - Low

  • AN-172578 - Medium
    Processes involving users who were renamed can now be safely unarchived while using the 'usermap' parameter in the unarchiving script. Prior to this fix, unarchiving such processes would fail and cause the execution engine to rollback.

  • AN-190514 - Medium
    The "Archived" process status filter on the Process Activity tab under Monitoring View is no longer displayed when there are no archived processes available to display. Currently, archived processes are available under the Process Activity tab for all new Appian Cloud sites started on Appian 21.1 or later versions and will be enabled on existing Appian Cloud sites via a phased approach.

  • AN-190739 - Medium
    Fixed an issue that caused the record summary view to show an expression error for Hebrew, Arabic, and Greek characters.

  • AN-190743 - Medium
    Fixed an issue where evaluation errors in process reports caused export to Excel to fail.

  • AN-191092 - Medium
    Fixed an issue that caused Document Extraction to return a status of ERROR on certain fillable PDF documents.

  • AN-188571 - Low
    Fixed an issue that caused text in rounded dropdowns to be blurry when the browser is not at 100% zoom.

  • AN-191054 - Low
    The Execute Robotic Process smart service no longer fails an execution if the RPA server is unresponsive, but instead waits until the RPA server is responsive to retry the execution.

  • Security Updates - Low

  • AN-189831 - High
    Fixed an issue that caused the Reconcile task for Document Extraction to return an error when opening it via a Related Action.

  • AN-187824 - Medium
    For Appian Cloud sites on MariaDB, innodb_fast_shutdown variable has been disabled in order to make database restarts more robust.

  • AN-189164 - Medium
    Fixed an issue which prevented header content layout's background color from dynamically updating in Sites and Tempo.

  • AN-190319 - Medium
    Connected environments are now temporarily disabled instead of deleted when a 404 error is returned from the connection.

  • AN-190782 - Medium
    Fixed an issue that prevented the application server from starting up due to a Liquibase lock exception.

  • AN-189884 - Low
    Fixed an issue in the export package dialog where the remove icon was not removing objects from the package.

  • AN-190736 - Low
    Exporting or deploying packages that only contain database scripts no longer adds the entire application to the deployment.

  • AN-190174 - High
    Processes can now be deleted successfully without any issues from the Process Activity tab under the Monitoring View. Prior to this fix, deleting several processes in bulk sometimes caused the application server to crash due to generation of redundant threads.

  • AN-190517 - High
    Generating a record action now succeeds for record types that contain a text field with a length limit of over 1000 characters.

  • AN-189179 - Medium
    For Appian Cloud customers on high availability configuration, cloud_db_metrics.csv, cloud_db_schemas.csv, cloud_db_audit_metrics.csv and rdbms-audit.log files on any node are now visible from any other node in the environment.

  • AN-190453 - Medium
    Fixed an issue where record queries that referenced many different related record types could cause a performance degradation.

  • Security Updates - Low

  • AN-190067 - High
    Fixed an issue where launching the record action generation wizard threw an error when there was a schema mismatch between the record type and the data source.

  • AN-189023 - Medium
    Fixed an issue that caused the concurrent session limit to be enforced even for SAML authentication.

  • AN-190068 - Medium
    Fixed an issue that applied an incorrect memory limit to certain record queries and prevented them from completing when run on large data sets.

  • AN-189222 - Low
    The a!isUserMemberOfGroup() function now works as expected when used directly in the process modeler as an exception flow trigger. Prior to this fix, the function would cause an evaluation error and pause the process.

  • AN-189093 - Critical
    New Process Analytics engines can now be added to environments on Appian 21.1 and later without any issues. Prior to this fix, this could cause the site to create numerous large incremental update .l files and eventually run out of disk. This updates behavior to be consistent with Appian 20.4 and earlier.

  • AN-188233 - High
    Fixed an issue where a hidden data type was displayed as a missing precedent that could be added to an application for objects that contained an expression that used a record data type constructor.

  • AN-189419 - High
    Fixed an issue where the PDF Doc From Template Smart Service would not use the checkbox style defined in the PDF template.

  • AN-187458 - Medium
    Fixed an issue where the user record list did not always show all rows when navigating to the last page and then returning to the first page.

  • AN-187502 - Medium
    A data migration of process history from the process execution engine no longer causes the engines to restart. Prior to this fix, a username exception caused the engines to crash and restart frequently.

  • AN-188525 - Medium
    Caching mechanism for data stores has been improved to optimize resource utilization.

  • AN-188590 - Medium
    Fixed an issue where a!queryRecordType() did not return the sync error code when only querying for related record fields and the primary key field of a record type with a failed sync.

  • AN-188784 - Medium
    Fixed an issue that created null users without a UUID and caused the application server deployment to fail.

  • AN-189035 - Medium
    On Appian Cloud MariaDB database, the optimizer_switch variable has been updated to disable derived_merge option.

  • AN-180424 - Low
    Fixed an issue in which the "List of" portion of a data type name was not being translated in an expression rule. This issue occurred when evaluating a list of record maps, so the record map is now appropriately internationalized.

  • AN-187853 - Low
    Charts now correctly update when changes are made in Design Mode if refresh parameters are false.

  • AN-189014 - Low
    Fixed an issue upon site startup where user sync with RPA prevented other activities from occurring.

  • AN-189393 - Low
    Appian tasks are now properly displayed in Microsoft Outlook emails when using the Task Viewer Add-in.

  • Security Updates - Low

  • AN-188886 - High
    Fixed an issue which caused an error to be displayed after completing a record action in a dialog.

  • AN-186759 - Medium
    Fixed an issue where record fields and related record fields with the same name were not evaluated as different field references.

  • AN-186971 - Medium
    CastInvalid error no longer displays for a!gridField() when using a!groupMembers() in the data parameter.

  • AN-188062 - Medium
    The automatic background cleanup of the type cache no longer impacts site performance or user experience.

  • AN-188324 - Medium
    Fixed an issue which prevented updating data types due to an error on locked types clean up.

  • AN-189012 - Medium
    Fixed an issue that caused a potential thread deadlock when writing access log response data to the Health Check zip file.

  • AN-188601 - Low
    Enabled additional Info-level logging for WebService invocation to help troubleshooting.

  • AN-191060 - Low
    Updated logic during WSDL creation to avoid unduly clearing type caches when an error is hit.

  • Security Updates - Medium

  • AN-180216 - High
    A timer which calculates the memory usage of process instances no longer causes errors in the process execution engine. Prior to this fix, the timer would cause the process execution engine to rollback in certain scenarios.

  • AN-187146 - High
    Fixed an issue that caused Db2 database connection string validation to fail during the data source creation in the admin console.

  • AN-187265 - High
    Fixed an issue that prevented self-managed customers from properly configuring Google credentials in the Document Extraction page of the Administration Console.

  • AN-187851 - High
    New Process Execution and Analytics engines can now be added to environments on Appian 21.1 and later without any issues. Prior to this fix, this could cause rollbacks on the newly provisioned engines. This updates behavior to be consistent with Appian 20.4 and earlier.

  • AN-187970 - High
    Resolved an issue that could cause a replica engine to get stuck in a REPLAYING state 2 to 3 months after a site restart.

  • AN-172311 - Medium
    Fixed a race condition during an engine failover and promotion event, that could result in an engine shutting down instead of being promoted to primary.

  • AN-178689 - Medium
    Fixed an issue where export to Excel would fail for record types that have not been updated if no user filters were applied.

  • AN-180918 - Medium
    Fixed an issue where record data sync fails if the primary key field is renamed within the record type for web service backed records.

  • AN-186606 - Medium
    Fixed an issue which could cause forms to erroneously scroll back to the top of the page.

  • AN-187353 - Medium
    Fixed an issue where a process model could not be selected as the source for a record type if any visible process model did not have a name in the user's current language.

  • AN-187950 - Medium
    Fixed an issue in which duplicate rows of data were causing an error on the record list for DSE-backed record types that were created prior to 20.3 and imported into 20.3 or later. Duplicate rows now correctly display without an error.

  • AN-187958 - Medium
    Fixed an issue that caused an error when viewing the record summary of a record with an empty summary interface.

  • AN-188067 - Medium
    Fixed an issue which prevented updating data types due to an error on locked types clean up.

  • AN-136621 - Low
    Increased the maximum number of replicas of an engine from 5 to 9.

  • AN-186217 - Low
    For Appian Cloud database in high availability configuration, additional logging has been introduced to capture information during a database failover.

  • AN-186789 - Low
    Fixed an issue where the missing domain warning triggered too often for expressions containing a function and rule input with the same name, such as "user".

  • AN-186874 - Low
    Fixed an issue that prevented the search server from stopping when installed as a windows service.

  • AN-187231 - Low
    Adding a comment /* at the start of an expression no longer causes an error in interfaces.


Perform the following steps to apply the hotfix:

  1. Stop Appian. See Starting and Stopping Appian for detailed instructions:
    1. Shut down the application server.
    2. Shut down the search server.
    3. Shut down the data server.
    4. Shutdown all Appian Engines, ensuring that the engines are checkpointed upon shutdown.
  2. Back up your existing Appian instance. See Backing Up Your Existing Appian Instance for instructions.
  3. Unzip the contents of the archive into your <APPIAN_HOME> directory.
  4. Run the deleteFiles script (deleteFiles.bat on Windows, on Linux) that is now located in your <APPIAN_HOME> directory.
    • If the script reports that some files were not deleted, address the reason for the failure (common causes listed below), and run it again until it no longer reports failed deletions.
    • Common causes of failed file deletion include:
    • The file is open in another window or process
    • The file is locked
    • You do not have permission to delete the file
  5. Unzip the contents of the archive that is now located your <APPIAN_HOME> directory.
  6. Run the installJdk script (installJdk.bat on Windows, on Linux).
  7. If you maintain customized or overridden Spring Security .xml files, merge them with the associated base files in the /deployment/web.war/WEB-INF/conf/security/ directory.
  8. Delete the deleteFiles scripts, the installJdk scripts, the OpenJDK .tar.gz and .zip files, and
  9. If you are using a Web server, copy the content of <APPIAN_HOME>/deployment/web.war to the folder where the Web server is getting the static resources. See Copy Static Resources to the Web Server for more information.
  10. Run the configure script to deploy your environment's configuration and re-configure any node names previously set by the configure script tools.
  11. Start Appian:
    1. Start the Appian Engines.
    2. Start the data server.
    3. Start the search server.
    4. Start the application server.

To determine if the Appian 21.3 Hotfix is deployed, open the file located in <APPIAN_HOME>/conf/. The contents of this file should match the following code sample:

Open in Github Built: Fri, Oct 22, 2021 (11:11:24 AM)

On This Page