PRODUCT
K2 Five 5.3
K2 Five (5.3) June 2023 Cumulative Update
Important steps before installing the K2 Five (5.3) June 2023 Cumulative Update
NOTE: If you install the R4 Build (5.0004.1000.4), you must also install the CU too.
Admin consent recommended before upgrading with Nintex K2 Five (5.3) June 2023 Cumulative Update
Microsoft is deprecating Azure AD Graph API in June 2022, and as of June 30th, 2020, stopped adding new features to the API. See these Microsoft articles for more information:
- Migrate Azure Active Directory (Azure AD) Graph apps to Microsoft Graph
- Azure Active Directory (Azure AD) Graph to Microsoft Graph migration FAQ
Microsoft strongly recommends upgrading to Microsoft Graph API to access Azure AD APIs as well as APIs from other Microsoft services. K2 OAuth resources requiring access to the https://graph.windows.net API (AAD Graph), must be upgraded to use https://graph.microsoft.com (Microsoft Graph) as part of the migration from AAD Graph to Microsoft Graph. Nintex K2 Five (5.3) June 2023 Cumulative Update includes the code fixes necessary for this migration. For more information on migrating apps, see the Microsoft article App migration planning checklist.
After the installation of the Cumulative Update, the OAuth resources that require access to AAD Graph API will be updated to use Microsoft Graph API instead. This will affect the workflows using the Azure Active Directory broker. These workflows can enter a failed state if the workflow executes a step that uses the broker after upgrade, but before a Global administrator in your organization re-consents to the Microsoft Graph permissions. These workflows will have to be manually repaired after upgrade and re-consent.
See the following topics for more information:
K2 Five (5.3) June 2023 Cumulative Update
The K2 Five (5.3) June 2022 Cumulative Update contains updates and fixes for issues reported in K2 Five (5.3). K2 recommends keeping your K2 environment updated by installing the latest cumulative update, and that you test this update before you deploy to a production environment.
Prerequisites and Dependencies
This cumulative update is only compatible with K2 Five (5.3). Each new cumulative update contains the updates and fixes that were included with the previous cumulative updates. The cumulative update does not require any previous cumulative updates or fixes to be installed, and no additional cumulative update is required to fully update a K2 environment. If you have installed individual code fixes included in this cumulative update, those code fixes are not changed unless a newer version of the code fix is available for the update.
Before you install this cumulative update, please check the K2 Product Releases and Build Numbers article to verify that this is the latest cumulative update available and that you have a current backup of your K2 database.
Database owner permissions are required to install this cumulative update or any of the fix packs.
Getting and installing the update
You can download the K2 Five (5.3) June 2023 Cumulative Update on Nintex Customer Central.
To install the cumulative update, run the cumulative update installer on every machine in your environment where a K2 product or component is installed, including desktop machines that have K2 Studio or K2 Designer for Visual Studio installed. The same installer is used to update the specific K2 products and components that are installed on that machine. To determine which cumulative update or fix pack has previously been installed in your environment see https://help.k2.com/kb000426.
Install Instructions
- Backup your K2 database.
- Download the K2 Five (5.3) June 2022 Cumulative Update.zip
- Extract the .zip file to access the .exe file.
- Double click the .exe file and select a location to extract the installation files.
- The Update window opens. Click Change if you need to change the K2 database. Select the correct information and click Accept. Click Update to start the installation.
- A warning is displayed if a backup of the K2 database is not found. Create a backup before selecting OK. Click OK on the warning window to continue with the update. Click Cancel if you want to create a backup first.
- After creating the backup, you can click Update again on the Install window. If a backup for the K2 database was recently performed, the installer shows you the date and time of the last backup.
- Click OK to continue with the update.
- Wait for the update to complete, and then click Finish.
Rollback Instructions
- To rollback the K2 Five (5.3) June 2023 Cumulative Update, uninstall K2 from your environment.
- Re-install K2 Five (5.3).
- Re-install the Fix Pack you had installed prior to this rollback.
- Delete the database created when you re-installed.
- Restore the K2 database using the backup made before the update.
You can also restore the K2 database before re-installing K2. When you re-install, you can just point to the restored K2 database.
Considerations for Rollback
If you had K2 4.7 installed before any of the K2 Five versions, and you make use of the client tools that was installed with K2 4.7, you need to start the re-install with K2 4.7 before you can re-install the K2 Five version.
Included in this Update
This cumulative update includes the following fixes:
Previous Fix Pack fixes
- Load data on IOS and Android [Part 2]_5.3
- Rich Text control for PDF converted_5.3
- K2 Five 5.3 FP - Update K2Api Issuer URL in the web.config to not display localhost and to display the value of the {smartFormsRuntimeServer} as we do with the Realm
- Code Fix: An error occurs Executing Azure Active Directory/SharePoint service instance
- Code Fix: Customized K2 Workspace slow performance
- Code Fix: Validation Pattern reverts to default
- Code Fix: SmartObject method ignores filter and returns entire collection
- Code Fix: K2 for SharePoint Online List lookup not working
- Code Fix: An error occurs in K2 for SharePoint Registration and Activation Wizards
- Code Fix: K2 Integration with DocuSign presents error
- Code Fix: Integrating K2 with Exchange Online using OAuth
- Code Fix: Values missing after upgrading
- Code Fix: Error occurs when logging on using Forms STS
- Code Fix: Unable to run the Reset Validation for license in K2 Management
- Code Fix: K2 Workflow error occurs when sending emails
Considerations
There are no known considerations at the time of writing the notes, except for those mentioned for some of the fixes listed above.
Ensure you read the "Important steps before installing the K2 Five (5.3) June 2023 Cumulative Update" listed at the top of this article.
