Skip to main content
Matrix42 Self-Service Help Center

Empirum 22.0 Update 1 - Release and Update Notes

About This Document

This document describes functional changes, bug fixes, known issues, modified behaviors and changed platform support that have been added since the last update. 

Please find the installation files of this version on Matrix42 Marketplace

System requirements, integration guides and instructions for installation and update are available in the Matrix42 Help Center

Software Management

UEM Agent

The latest agent with all details and information about the new features can be found here: Matrix42 Marketplace

OS Installer

If you use only WinPE and no longer EPE to install your operating systems, you can delete all imported WADK and WAIK (Configuration > OS Installer > Import) permanently.

Old or unneeded PreOS packages should be deleted from the EMC and locally from the hard disk.  

Please check here in the EMC in the tab Configuration - Software Management - Depot - Matrix42 PreOS Packages and delete all unneeded PreOS packages.

Locally you can delete the same PreOS packages from the hard disk in the directory "%EmpirumServer%\Configurator$\PackageStore\PreOSPackages".

The v22.0.1 ISO has the latest WinPE 1.8.14 integrated. The latest PreOS packages are NOT automatically imported.

Further details and information about WinPE can be found here: WinPE

Common Changes/Enhancements

EWC

Update of Apache TomCat and Java components.

  • Apache Tomcat: 9.0.65 
  • Java: 18.0.2.1+1-1

WOL

With 22.0.1, the WakeOnLan (WOL) service has been extended in online and offline mode. The old functionality is still given and is read out. The extension is that the "Magic packet" is sent to all MAC addresses of existing network cards in the inventory. A "Directed Broadcast" is sent as soon as the IP address and subnet mask is known. We support the following scenarios:

  • No Inventory data available
  • All known MACs from NICs
  • Client DHCP Connection
  • Client DHCP Options
  • Static IP address

Patch Management

Patch Management now supports hybrid environment scenarios in which patches are not downloaded to the master server, but are available on sub depots. This functionality requires UEM Agent SFR 2209.1.2 or newer. More details are available as part of the agent documentation.

Enterprise Service Bus

The functions of the Enterprise Service Bus have been extended with version 22.0.1. The ESB deletes the variable configurations and Boot Configurations from the UUX and Empirum. 

The Enterprise Service Bus is now extended to send and receive messages. Therefore it is very important that all participants like Empirum, EgoSecure and Silverback use their own subscription / queue as described in the Service Bus configuration help. If they all use the same subscription / queue, messages will be consumed the fastest and may not reach the correct consumer.

Notification of extended maintenance period (LTSB)

Empirum version 21.0.3 is declared as LTSB version. Customers who are entitled to Matrix42 Premium Support thus receive an extended maintenance period beyond the release of version 23.0.0 at the end of April 2023.

Solved Issues

Problem ID Description
EMC
PRB35941 With group rights the PXE activation option is not enabled at clients in search result list
PRB36783 Missing right for role EMP_C_DEPOT to update table ActivationQueue_SWM on deletions
PRB36809 Problem with the BootConfigs
Inventory
PRB36825 Inventory service move InvFiles to the error folder: "Invalid Data in Inventory File"
Patch Management
PRB36422 Patches are not moved from test groups and blocking queue
Misc
PRB36721 Packaging Center: Package Wizard doesn't start
PRB36758 MAC Address disappear from computer properties during OS deployment
PRB36804 Vulnerability in OData Library can be exploited for Denial of Service attack
PRB36851 Empirum service bus writes persistent program errors to the log file
PRB36820 Security issue: Local Privilege Escalation via PBackupVSS
PRB36914 Container Cloud Tenant AgentConfig.xml: $ Sign missing in path in SMB Section

Known Issues

Problem ID Description
OS Installer
  The feature "WinPE http/s Support" has current restrictions and don't support the client certificate from the agent template. Also Disk Imaging is not possible over http/s.

Changed or no longer supported Features and Platforms

  • Advanced Agent is not supported anymore.
  • UEM Agent older than version 2003.x are not supported with protocol http(s) anymore.
  • The SubDepot package no longer sets the null session shares
  • Due to performance optimizations of the PXE service, the following behavior has changed when booting computer objects known in Empirum. If the checkbox "PXE enabled" is not set when creating a computer object, the checkbox is NOT automatically set when booting the client from v21.0!

Announcements for Version V23.0

  • Windows 7 is no longer supported. The extended Support from Microsoft for Windows 7 ends in 01/2023

Discontinuations for Version v22.0 Update 1

  • nothing

Preliminary actions before installation


When you are downloading a Matrix42 hotfix or patch, the downloaded file may have a 'Zone.Identifier' information attached (depending on your browsers security configuration).
Please remove this 'Zone.Identifier', otherwise some problems with these files can occur (files are not loading correctly):

  1. Right-click the blocked file, and then click Properties.
  2. In the General tab, click Unblock.

To avoid the 'Zone.Identifier' in future please add the address 'https://m42marketplacemediathek.blob.core.windows.net' as a 'trusted zone' in the Internet Explorer.

Installation Steps

  1. Log on to the Matrix42 Empirum Master Server using an administrative account.
  2. Make sure, that a backup of your location database and your installation directory (e.g. D:\Empirum) does exist.
  3. Copy the Matrix42_Empirum_22.0.1.iso to a temporary folder of the Empirum Master Server.
  4. Run the Matrix42_Empirum_22.0.1.iso with elevated rights (Run as administrator).
  5. If the system requires a reboot, please reboot.

All necessary Empirum Services on the Master Server will be uninstalled during the installation.

Post-installation Steps


Due to changes on variables all INI files are rewritten.
The hashes of the Matrix42 software packages will be recreated.

  1. Start Empirum DBUtil and logon to EmpLocation and your location database.
    Confirm the location table structure update.
  2. Update your location DB using the Update Tables action.
  3. Select the services (except PXE/TFTP, DeviceDiscovery) which are required for your installation and then click Install.
  4. Now install the services PXE/TFTP, DeviceDiscovery (if used) on the master server.
  5. Reinstall the DeviceDiscovery service on all Empirum depot servers (if used).
  6. If the Empirum ServiceBus service is used and installed, you must now reinstall it again.
  7. On the Empirum Server run EMC > Configuration > Software Management > Depot > Tools > Check Versions to apply the changes of updated package properties (Personal Backup and Patch Management).
  8. Reinstall all Empirum Subdepot and Empirum Subdepot PXE services (if used) on existing Empirum depot servers. You can use the Subdepot PXE Service package instead of updating the services via DBUtil manually.
  9. Reinstall the Empirum package Empirum Management Console 22.0 (EMC) on all affected computers. The EMC will be updated on your Empirum master server automatically during the update.


ODBC Driver Update to "ODBC Driver 13 for SQL Server" is only necessary when using Microsoft SQL Server 2012-2017:
https://www.microsoft.com/en-us/download/details.aspx?id=50420

ODBC driver update to "ODBC Driver 17 for SQL Server" is only necessary when using Microsoft SQL Server 2019 / 2022:
https://www.microsoft.com/de-de/download/details.aspx?id=56567

Matrix42 Empirum v22.0 Directory Structure 

The following files are stored with the extension *.new:
Post-command for OS-Installation:

  • Configurator\User\EmpirumAgent.bat    → Configurator\User\EmpirumAgent.new
  • Configurator\User\UEMAgent.bat          → Configurator\User\UEMAgent.new

If you have made adjustments in the original batch files, transfer them to the *.new file. Then delete the *.bat file and rename the *.new file to *.bat.
If you have not made any adjustmentsdelete the *.bat files and rename the *.new files to *.bat.

Check if the Inv_scan_XML.bat file was manually updated and does not use an older version of Empirum Inventory.

The following files are stored with the extension *.000, *.001 etc. 

Files with this extension are only stored if there is already a file with the same name in the destination.

  • EmpInst\Wizard\Strings\Keyboard.ini
  • EmpInst\Wizard\Strings\Language.ini
  • EmpInst\Wizard\Strings\LanguageId.ini
  • EmpInst\Wizard\Strings\Modemstrings.ini
  • EmpInst\Wizard\Strings\MuiLang.ini
  • EmpInst\Wizard\Strings\scsi.ini
  • EmpInst\Wizard\Strings\Timezone.ini
  • Empirum DBUtil\Empirum DBUtil.ini

If you have made adjustments in these files, you must transfer the changes from the backup files (*.000) to the new files listed above. After that, all files with the extension *.000 etc. can be deleted.
During the update, the contents of the Manual directory will be moved to Empirum > Manual_Backup.

Updated Software Packages

The following Empirum software packages are updated but are not assigned a new version number. You need to update (reinstall) the following packages:

Infrastructure Packages:

  • Empirum Subdepot 22.0
    • Sync Templates: ESubdepot_OS, ESubdepot_OS_QuickSync_Day & ESubdepot_OS_QuickSync_Night
  • Empirum Subdepot PXE Service 22.0
  • Empirum Subdepot WOL Service 22.0

Client Packages:

  • Empirum AUT Service 22.0
  • Empirum Inventory 22.0
  • Empirum Management Console 22.0
  • Empirum Packaging Center 22.0
  • Empirum Personal Backup 22.0
  • Empirum Web Console 22.0
  • Matrix42 Patch-Management Client Scan 22.0
  • Matrix42 Patch-Management Client Fix 22.0

 

  • Was this article helpful?