The following hotfix is available for Appian 21.2.

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.2 installations not currently up to date with the latest hotfixes. After installing, you will be running on Appian 21.2.510.0.

21.2.510.0 Hotfix

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

Resolved issues


  • Security Updates - Low

  • AN-190453 - Medium
    Fixed an issue where expressions with references to many different record types with data sync enabled could cause a performance degradation.


  • 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.


  • Security Updates - Low

  • 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.


  • Security Updates - Medium

  • 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-188525 - Medium
    Caching mechanism for data stores has been improved to optimize resource utilization.

  • AN-189656 - Medium
    File upload fields no longer produce an error when a percent (%) character is present in the filename of an uploaded file.

  • AN-189739 - Medium
    Fixed an issue that could cause the screen to flicker on Chrome when using character limit on text and paragraph fields

  • 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.


  • Security Updates - Medium

  • 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-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-189035 - Medium
    On Appian Cloud MariaDB database, the optimizer_switch variable has been updated to disable derived_merge option.

  • 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.


  • 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-189188 - High
    Local variables referenced within a!aggregationFields() for the field parameter of a!queryRecordType() are now correctly refreshing with refreshOnReferencedVarChanges.

  • AN-189420 - High
    The Deploy to Another Environment action no longer triggers an error when you reuse a deployment related to an application with associated packages.

  • 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-188784 - Medium
    Fixed an issue that created null users without a UUID and caused the application server deployment to fail.

  • 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.


  • Security Updates - High

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

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

  • 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-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-188062 - Medium
    The automatic background cleanup of the type cache no longer impacts site performance or user experience.

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

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

  • AN-188661 - Medium
    TrimTables script now allows you to trim excess table entries from the Content engines in order to reduce memory usage and improve performance.

  • 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-185257 - Low
    Fixed an issue to address high memory utilization in a server-side component.

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


  • 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-185653 - Medium
    Improved grid load time in response to grid field pipelines showing a slowdown of 200ms to 260ms.

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

  • 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-187231 - Low
    Adding a comment /* at the start of an expression no longer causes an error in interfaces.


  • Security Updates - Low

  • 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-186747 - Medium
    Fixed an issue which caused the union function to return an error when provided a list of maps.

  • AN-187090 - Medium
    Fixed an issue where clicking the cancel button multiple times for an edit expression dialog in the interface designer would cause an error to occur.

  • 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-186874 - Low
    Fixed an issue that prevented the search server from stopping when installed as a windows service.


  • Security Updates - Low

  • AN-186025 - Medium
    Records-powered grids created with the interface designer now show the correct expression for the record type after switching to expression mode.

  • 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-177356 - Low
    Improved email security.


  • 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-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-182753 - Medium
    Show generic error messages for errors encountered during user authentication.

  • AN-186938 - Medium
    A type of crash of the process design engines caused by an error with a specific activity class parameter type in a process is now prevented.

  • AN-184062 - Low
    Record response time and record sync status metrics on the Health Dashboard are now reported regardless of record count.

  • Security Updates - Low

  • AN-185288 - Low
    Resolved an issue with RedisCache trying to unlock a lock that it never acquired that caused repetitive logged errors.

  • AN-185115 - Low
    Updated error message when attempting to import a patch/deployment that contains a record type with a reference to an unpublished data store.

  • Security Updates - High

  • AN-182515 - High
    Fixed an issue that caused non-synced entity-backed record types that were manually updated to versions 20.4 and above to fail upon export to Excel. The impacted record types were those containing complex data structures (i.e., nested custom data types).

  • AN-185647 - High
    Repeated wildcard queries caused in pickers and search boxes no longer cause site performance issues.

  • AN-52587 - Medium
    Provided a configuration to increase the size of the email messages that can be sent out.

  • AN-181512 - Medium
    The automatic background cleanup of old transient system files no longer impacts site performance or user experience. For self-managing customers, if you had previously set conf.content.max.temporary.uploaded.files.age in, you should now remove that setting. Appian Cloud customers do not need to take any action.

  • AN-184459 - Medium
    Fixes an issue where closing the settings window from the Tempo news feed would reset the scroll position to the top of the page.

  • AN-185856 - Medium
    Fixed an issue where date fields showed the improper format for the Swedish locale.

  • AN-186125 - Medium
    EN-GB locale now displays the correct format in the Date component.

  • AN-115868 - Low
    Searching by Process Model ID in Appian Designer now correctly returns the matching process model

  • Security Updates - Low

  • AN-176614 - High
    Upgraded OpenJDK to version 8u292b10.

  • AN-182130 - High
    Multiple CDTs with a parent-child relationship can now be edited and saved at the same time without any issues. Prior to this fix, making changes and saving these CDTs at the same time would result in an error.

  • AN-184317 - High
    Fixed an issue on self-managed Appian systems that prevented syncing records after restoring from a backup if a sync occurred less than 10 minutes before an unplanned outage.

  • AN-182677 - Medium
    Fixed a race condition which occasionally caused outdated expression design guidance to appear on High Availability environments.

  • AN-182784 - Medium
    A data migration of process history from the process execution engine is now faster and optimized for performance.

  • AN-182887 - Medium
    Fixed an issue where each field was marked as unique in a synced record if multiple columns were included in a unique index in the database.

  • AN-182898 - Medium
    The performance of browsing to tables from Oracle when selecting a source for synced records has been improved.

  • AN-183364 - Medium
    Fixed an issue that caused the content engines to stop in some scenarios when the content logger is configured to output log entries at the DEBUG level.

  • AN-183865 - Medium
    Clicking on a Document Download Link component now properly refreshes the idle timeout.

  • AN-183875 - Medium
    Design guidance for sites and web APIs is now properly re-calculated when a precedent object is modified.

  • AN-184600 - Medium
    Fixed an issue that caused some users to not be able to log in to Appian.

  • AN-185226 - Medium
    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 frequent errors and rollbacks on the newly provisioned engines. This updates behavior to be consistent with Appian 20.4 and earlier.

  • AN-185842 - Medium
    On-premise customers can re-enable TLS 1.0 and 1.1 support for Tomcat.

  • AN-182814 - Low
    Task emails no longer fail when an invalid locale is provided.

  • AN-185013 - Low
    Fixed the validations on the color picker component for Design Mode so that it no longer renders duplicative validation messages.

  • AN-185040 - Low
    Fixed an issue with the display of event nodes in process model documentation.

  • AN-185400 - Low
    Selecting related record data via relationship references no longer incorrectly errors in certain scenarios.

  • AN-185431 - Low
    Fixed an issue where the design_errors.csv log file could have multiple headers.

  • Security Updates - Critical

  • AN-184783 - High
    Fixed logging issues when using Oracle

  • Security Updates - Critical

  • AN-182771 - High
    Memory optimizations for migrating process history from the process execution engines. Prior to these optimizations, the migration could cause an out of memory error.

  • AN-184729 - High
    Fixed an issue that resulted in submission of certain forms with uploaded files to be slow.

  • AN-183790 - Medium
    Compare and deploy no longer triggers an OutOfMemory error when inspecting large deployments.

  • Security Updates - Medium

  • AN-143471 - Medium
    Interfaces no longer break when typing an incorrect format into a date component.

  • AN-182668 - Medium
    Users will now see the appropriate error, instead of an internal error, when a record view contains an image to which the user doesn't have at least 'viewer' permission.

  • AN-183012 - Medium
    Improved performance when syncing record data from Oracle, IBM DB2, and SQL Server.

  • AN-184083 - Medium
    Improved performance in record action dialogs that contain a grid with data sourced from a record type.

  • AN-184470 - Medium
    In web API expressions, the "invalid parameter" design guidance no longer incorrectly triggers for evolved functions. 

  • AN-182704 - Low
    Fixed an issue that resulted in document extraction tables opening to the incorrect page.

  • AN-183516 - Low
    Component Plugins now appear disabled on unassigned tasks.

  • Security Updates - Low

  • AN-182083 - High
    Fixed a performance issue where related action start forms would re-query the record data on every interface evaluation.

  • AN-182179 - High
    Execution of processes with very large process variables now use less memory. Prior to this fix, such operations could cause the site to go out of memory in certain scenarios.

  • AN-182195 - High
    Fixed an issue that prevented the application server from starting up due to an error in acquiring change log lock

  • AN-180764 - Medium
    Fixes a bug that caused double slashes '//' to be interpreted as single slashes '/' in the URL of HTTP integrations.

  • AN-180967 - Medium
    Updated Apache PDFBox to 2.0.23 to address the out of memory exception experienced when loading certain PDF files.

  • AN-181036 - Medium
    In Internet Explorer, the in-line design guidance banner now displays correctly when the language is set to Arabic.

  • AN-181111 - Medium
    Fixed an issue with metric collection process

  • AN-181252 - Medium
    Upgrade Zookeeper to 3.7.0

  • AN-181352 - Medium
    Sort icons now display for legacy record list grids created with Appian 20.2 and earlier.

  • AN-181881 - Medium
    When a plug-in is selected in the precedents view of an object, the option to "Remove from Package” is now rightly disabled.

  • AN-181942 - Medium
    The stability of the process execution engine has been improved. Prior to this fix, certain actions like starting a process, archiving or unarchiving a process could cause the engine to rollback, causing a temporary service outage for process execution.

  • AN-182236 - Medium
    Fixed an issue that prevented the OAuth Provider from redirecting back to the mobile app after authorizing the user.

  • AN-183783 - Medium

  • AN-41128 - Low
    Fixed an issue with the process calendar which marked the wrong non-working days with en_GB locale

  • AN-178286 - Low
    Fixed an issue which caused outdated validation errors to appear when uploading an XSD to create a new version of a data type.

  • AN-179783 - Low
    Fixed an issue where inline documentation did not display in instructions or tooltips when editing the grid-style record list in the record type designer.

  • AN-181051 - Low
    Mid-tone accent colored text no longer changes to black on light colored backgrounds.

  • AN-181060 - Low
    Fixed an issue where a paging grid did not automatically return to the first page when refreshOnReferencedVarChange was false and a referenced variable in refreshOnVarChange was changed.

  • AN-182313 - Low
    Fixed an issue where the unused rule input recommendation was incorrectly triggering in a specific case where the input was used as a rule reference.


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.2 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: Tue, Sep 14, 2021 (11:54:22 AM)

On This Page