K2 blackpearl (4.7) April 2022 Cumulative Update
Important steps before installing the K2 blackpearl (4.7) April 2022 Cumulative Update
Admin consent recommended before upgrading with Nintex K2 blackpearl (4.7) April 2022 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 blackpearl (4.7) April 2022 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:
- Nintex K2 migration to Microsoft Graph.
- Admin consent recommended before upgrading with Nintex K2 K2 blackpearl (4.7) April 2022 Cumulative Update.
K2 blackpearl (4.7) April 2022 Cumulative Update
The K2 blackpearl (4.7) April 2022 Cumulative Update contains updates and fixes for issues reported in K2 Five (5.4). 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 blackpearl (4.7). 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.
Getting and installing the update
You can download the K2 blackpearl (4.7) April 2022 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.
-
- Backup your K2 database.
- Download the K2 blackpearl (4.7) April 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.
-
- To rollback the K2 blackpearl (4.7) April 2022 Cumulative Update, uninstall K2 from your environment.
- Re-install K2 blackpearl (4.7).
- 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.
Included in this Update
This cumulative update includes the following fixes:
- KB003431 - Code Fix: An error occurs when you start a K2 Workflow instance on a Cluster environment
- KB003432 - Code Fix: When multiple events occur on the K2 Server, errors occur in the K2 Server logs
- KB003441 - Code Fix: When a profile %temp% folder contains more than 65000 .tmp files, slow performance occurs when executing a SmartObject method
- KB003445 - Code Fix: Critical security vulnerability when Forms STS is configured for authentication
- KB003462 - Code Fix: Validation applied to Read-Only Text Box Control
- Feature enhancement: KB003363 - K2 and upcoming changes to Exchange Online authentication
- KB003511 - Code Fix: Item not deleted from the People Picker control when you use the delete keyboard key
- KB003523 - Code Fix: An error occurs when you add a user to a group
- KB003533 - Code Fix: An error occurs when you attempt to complete functions for a SharePoint list
- Code Fix: Exchange Administration Enable Mailbox error since Exchange April 2021 is installed.
- Code Fix: Unable to adjust column width after Chrome browser update to version 91.
- Code Fix: There is a 36-character restriction when adding a new license key via K2 Management.
- Code Fix: Some users are not able to action any K2 Workflows.
- Code Fix: Smartforms environment fields are exposed.
- Code Fix: K2 (4.7) December 2019 Cumulative Update Fix Pack 12 removes WebService URL field.
- Code Fix: High risk security issue in the general SmartObject framework.
- Code Fix: An error occurs when searching for a SmartObject in Management.
- Deprecation of Dynamics 365 Regional Discovery service
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 blackpearl (4.7) April 2022 Cumulative Update" listed at the top of this article.