Release Notes for Enterprise Service Management and Digital Workspace Platform 10.0 Update 4
About this Release
Known Issues
Fail on Data Gateway update
After installing the 10.0.4 the Data Gateway Windows Service can fail and goes to termination in an attempt to start the Windows Service. In Event Viewer the following error can be found for Data Gateway Application:
Exception Info: System.IO.FileNotFoundException
To workaround it, the files need to be copied from the folder "<ApplicationFolder>DataGateway\Apps\Matrix42.DataGateway.Core\" to folder "<DataGatewayFolder>/DataGateway\Host\Apps"
Schema scripts not executed on update to 10.0.4
Due to an inconsistency, of schema script versions, it might happen that new schema scripts are not executed during the update. Not executed schema scripts will result in issues after the update; the update itself will not be affected.
This issue will only appear in case the Marvin extension version 2.1.20210412.1 was installed. This version was already removed from our Matrix42 Extension Gallery!
To avoid the issue from happening below script needs to be executed prior to an update; execution will not result in downtime.
- 02-95-1210 UpdateVersion.post
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 95
WHERE Major = 3
AND Minor = 103
AND Build = 1210
-- 02-95-1221 Add OutboundSystemUrl.class
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 95
WHERE Major = 3
AND Minor = 105
AND Build = 1221
-- 02-96-1221 AddFragmentsGlobalSystemSettingsDialogAdministration.dat
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 96
WHERE Major = 3
AND Minor = 106
AND Build = 1221
-- 02-96-1221 AddFragmentsGlobalSystemSettingsDialogAdministrationMarvin.dat
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 96
WHERE Major = 3
AND Minor = 106
AND Build = 1221
-- 02-97-1221 UpdateData.post
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 97
WHERE Major = 3
AND Minor = 107
AND Build = 1221
-- 02-98-1221 AddFragmentsGlobalSystemSettingsDialogAdministrationMarvin.dat
UPDATE dbo.SchemaScripts
SET Major = 2,
Minor = 98
WHERE Major = 3
AND Minor = 108
AND Build = 1221
Updating the Marvin extension after executing the script is not required.
Functional Changes
This release provides a couple of functional changes - new features and improvements :
Highlights:
Enterprise Service Management
- SAM Engines support serialized activation
SAM engines support new platform capability, to run engines in a serialized way, so that customers are able to improve execution of their overnight processing in a secure and efficient way.
Digital Workspace Platform
- Running Engines in a sequence
It is possible to configure a dependency between Engines configured within a single Engine Activation item, in order to start some engines only after the dependent engine finished processing. Especially recommended for Engines that import the same Configuration items - Push Notifications in a Browser
Real-time push notifications not only grab the attention of the users but also gives an urgent call-to-action, which may trigger instant action from the user, like reacting on System e-mail, Reacting on Approval request, etc - Import Definitions support Cloud Data Providers
Import data from Cloud Drives like Google, OneDrive, etc using Import Definitions - Service Connections
Service connections enable you to connect to external and remote services to execute tasks in a job. For example, you may need to connect to your Google Drive to import Tickets that are collected with some google form, or use REST API in the Workflow Studio Activity like HTTPSend.
Azure Active Directory & Active Directory Data Providers
With 10.0 Update 3, we have changed the matching mechanism for Persons and Accounts to avoid duplicates. When Active Directory and Azure Active Directory are connected with AD Sync, and both Data Providers are activated - the system will create only one Person for both Accounts. Because of that change, custom settings for matching Accounts and Users will be overwritten and needs to be configured again.
It is highly recommended to configure a list of extended attributes in configurations of Active Directory Data Provider and Azure Active Directory Data Provider at the same time when both data providers are in use!
Replacing the Data Gateway Technology
The Data Gateways are being replaced with a new Technology. The change will be effective with the Q4/2021 Release and the migration will happen automatically in the background for all Data Gateways except Remote Data Gateways.
Remote Data Gateways can be replaced with the new Technology after the update to the Q2/2021 Release 10.1.0 and have to be replaced until the Update to the Q4/2021 Release 11.0.0.
Matrix42 will provide a help article linked in the 10.1.0 and following Release Notes with a Step by Step Guide to replace the Remote Data Gateways, which are running on other servers than the Application Server. Non-remote Data Gateways running on the Application Server are being migrated automatically in the background.
The new Technology is based on the Matrix42 Worker Technology. A free subset of the Matrix42 Worker Technology will automatically be made available to all customers with and without the Digital Workspace Platform (DWP) Subscription with the Q3/2021 Release.
No additional license certificates have to be installed.
For Customers with the Digital Workspace Platform (DWP) Subscription additional features are available beyond the ones based on the soon to be discontinued technology.
Q2/2020 (10.0.1) | All Data Gateways tasks (except Inventory of Citrix XenServer, Inventory of Microsoft Hyper-V, Inventory of VMware vCenter, LIS - Online Update, Unix Inventory, Windows Inventory) are running by default on the new Technology. |
Q4/2020 (10.0.2) | All new Data Gateway Tasks are being executed in the background automatically with the new Technology. |
Q2/2021 (10.1.0) |
All Customers are being asked to migrate their Remote Data Gateways to the new Technology. A dedicated help article linked in the Release Notes is being provided as a step-by-step guide.
|
Q3/2021 (10.1.1) |
Local Data Gateways are being migrated automatically in the background to the new Technology for all Customers with and without the Digital Workspace Platform (DWP) Subscription. Remote Data Gateways that are not migrated to the new Technology are highlighted in the administrative area, the System Diagnostics, and in the Setup Wizard, but are still supported and will work after the update to 10.1.1. New installations done with 10.1.1 will fully run on the new technology only. |
Q4/2021 |
The Data Gateway Service is being discontinued and removed from the product. All Remote Data Gateways have to be migrated to the new Technology before running an update according to the help article provided with the 10.1.0 Release Notes. |
Secure Token Service as a default mechanism for authentication
The Secure Token Service is the only available option for authentication. STS will be automatically enabled for existing installations. There will be no possibility to deactivate the option. In addition, Force SSL option will be set. It means that when someone opens the console or the portal with the HTTP URL, they will be redirected to the HTTPS URL.
New Workflow Engine
Matrix42 introduces a new Workflow Engine to execute the Workflows to replace Microsoft AppFabric. Workflows don't have to be adjusted and the migration will happen automatically in the background. For more details please check Workflow Engine.
The new Technology is based on the Matrix42 Worker Technology. A free subset of the Matrix42 Worker Technology will automatically be made available to all customers with and without the Digital Workspace Platform (DWP) Subscription with the Q3/2021 Release.
No additional license certificates have to be installed.
For Customers with the Digital Workspace Platform (DWP) Subscription additional features are available beyond the ones based on the soon to be discontinued technology.
Q1/2020 |
(Technical Preview) Migration of the Custom Workflows and Custom Workflow Activities should be started. See the Workflows Migration help article for a step-by-step guide. |
Q2/2020 |
The new Workflow Engine can be used for Production Systems for Customers with a Digital Workspace Platform (DWP) Subscription. |
Q4/2020 (10.0.3) |
All Workflow Activities provided with the standard Matrix42 products are fully compatible with the Worker Technology. |
Q3/2021 (10.1.1) |
The Matrix42 Worker Technology is effectively the standard execution engine for all Workflows. All Workflows that have compatible Worker Workflow Activities are automatically running on the new Technology for all Customers with and without the Digital Workspace Platform (DWP) Subscription. Workflows containing incompatible Activities are highlighted in the administrative area, the System Diagnostics, and in the Setup Wizard. Microsoft AppFabric will be still used to execute them as a fallback. See the Workflows Migration help article for a step-by-step guide in case a Workflow is highlighted to you containing Workflow Activities that are not compatible with the new Worker Technology. For new installations, Microsoft AppFabric is no longer required. |
Q4/2021 |
The discontinued Workflow Execution Engine based on Microsoft AppFabric will be removed. All non-compatible custom Workflow Activities have to be migrated to the Worker Technology before running an update. Workflows containing incompatible Activities are highlighted in the Setup Wizard. Follow the guide on Workflows Migration to prepare your Matrix42 Systems for the update. |
New e-mail Engine for standard e-mail Notifications.
New Email Engine has replaced Alerting Engine. Now the new Email Engine is used by default for processing all standard email notifications defined in the Compliance Rules. These changes are not applied to customized and custom Compliance Rules used in pair with the legacy Alerting Engine.
Please make sure that the customized and custom Email Descriptors are manually adjusted and corresponding Compliance Rules are switched to the new Email Engine as the Alerting Engine will be smoothly discontinued.
The Alerting module will be discontinued in the following schedule:
Q3/2019 (9.1.2) |
Default not-customized Mail Notification uses the new Email Engine |
Q1/2020 |
All Compliance Rules are automatically switched to use New Email Engine with the possibility to fallback. |
Q4/2021 |
New Email Engine is the only way to send emails. (Alerting will be fully removed from the product together with the Q4/2021 release) |
Learn more on how to adjust Email Descriptors and migrate Compliance Rules to the new Email Engine.
End Of Sales - Classic UI
Since product version 10.0.0 the classic user interface can no longer be installed. However, to ensure backward compatibility, it can still be used on existing installations. In agreement with our support terms and conditions, the classic user interface will be supported until September 2021. After that point in time, the components for classic user interface will be completely removed from product releases.
If you need support or do have any particular questions, please reach out to the Matrix42 product management team.
March 2020 |
End of ‘Classic UI – End of Sale’ - The classic user interface can no longer be installed. |
Q4/2021 |
A complete shutdown of classic UI. (Classic UI will be removed from the product with Q4/2021 release) |
End of Live - Address Book
Development on the address book, available as an optional item in the Self Service Portal will no longer be continued. The functionality will be set End of Live and removed from the product based on the below timeline.
April 2021 |
No further development on the address book functionality in Self Service Portal (Fixes will be applied until the functionality is removed). |
Q4/2022 | All components supporting the Self Service Portal address book will be removed. |
Updating from previous versions
Important and Breaking Changes
Please review important or breaking changes that have been made since your currently installed version has been released.
Solved Problems
Please check solved problems that are relevant to you since your currently installed version has been released.
Database Schema Changes
Please check database schema changes that have been made since your currently installed version has been released.
Supported Versions
The setup program can be used to update existing installations of product version 8.0.2 or higher.
Please refer to this article for more information about the support status of previous product versions.
Updating from Version 8.1.0.1649
If you are updating from version 8.1.0.1649, you must remove the following files from folder <setup folder>\root\web\bin before updating to this version:
- extensibility.dll
- update4u.Templates.VS2010.Addin.Workflows.dll
- update4u.Templates.VS2010.Core.dll
Please note that if you want to update from any version before 8.1.7 directly to a 9.1.x version you need to take an intermediate step to 8.1.7.
Expired Maintenance for Version 9.0
Please note that with general availability of version 10.0 the maintenance for “Workspace Management 9.0” (latest update version provided is 9.0.4) has expired.
We strongly recommend that systems with this version are updated to a supported product version as soon as possible.
Dependencies with Add-ons
At least following add-ons must be updated for compatibility reasons:
If you have any other add-ons from Matrix42 Marketplace installed, please check compatibility with the corresponding publisher before installing this version.
General Information and Resources
Available information and resources about the product:
Technical Information
- System Requirements
- Hardware Sizing Recommendations
- Installation and Configuration Instructions
- Product Download (Matrix42 Marketplace)
Make sure to install latest hotfix, available on product download page on Matrix42 Marketplace (see above)
Help and Training
- Online Help Software Asset Management
- Online Help Service Management
- Online Help SolutionBuilder
- Training Material (Matrix42 Campus)
- User Forum
Support
If you experience any problems regarding this version, please contact our support team:
Matrix42 Help Desk
Web: https://support.matrix42.de/SPS/Portal
Mail: helpdesk@matrix42.com
Phone: +49 (69) 667 738 222
General information about Matrix42 support services can be found here: https://www.matrix42.com/en/customer-success/support
Other Resources
- Product Improvement Community (Matrix42 Idea Portal)
- Guideline for Product Usage incl. Maintenance Status (Matrix42 Website)