[draft] SP-9033 Active k4.lic fails license check post upgrade/hotfix with error code "upd"

Symptoms

After upgrading Appian, Data Server is not able to startup even though the license is still active
The following error is shown in <APPIAN_HOME>/logs/data-server/watchdog.log, indicating that the license can not be validated

{"level":"ERROR","time":"YYYY-MM-DDTHH:MM:SS.MSZ","logger":"watchdog","caller":"QLicenseManager.java:54","thread":"main","msg":"An unexpected error Failed to start and connect to q. cfg=Config{script=lib/ut.q, hostAndPort=localhost:5406, args=[]} occurred during K4 license validation. For an updated license, please contact Support."}
java.lang.IllegalStateException: Failed to start and connect to q. cfg=Config{script=lib/ut.q, hostAndPort=localhost:5406, args=[]}

Upon k4.lic license check, error code upd is shown in the output

<APPIAN_HOME>/data-server/engine/bin/q/l64$ QHOME=.. ./q 

'YYYY.MM.DDTHH:MM:SS.MS license error: upd

Cause

This indicates that the current k4.lic does not support the version of q that is present in the upgraded version due to a change in q version between your initial Appian version and the upgraded Appian version. Your k4.lic license needs to be updated if the version of Appian you are upgrading to has a version of q that was released later than when your license was last updated.

Action

In order to start the Appian components, utilize the license app to request for temporary licenses
Open a support case to request for refreshed licenses.

Affected Versions

This article applies to all self-managed versions of Appian.

Last Reviewed: August 2023