Empirum 22.0 - Step by Step Update Guide
Matrix42 Empirum v22.0.x
This Empirum ISO provides the following installation and update options:
- Complete new installation of Matrix42 Empirum v22.0.x
- Update from Matrix42 Empirum v21.0.3 LTSB
- Update from Matrix42 Empirum v21.0.x
- Update from Matrix42 Empirum v20.0.3
Consider the changed system requirements.
Before each update, check if there is a Hotfix Installer available in the Matrix42 Marketplace at the time of installation that affect the version you are installing.
For information on known issues, see the Known Issues list for this version.
Backup
An up-to-date backup of the Empirum master server and the Empirum site database is strongly recommended.
Data cleanup
Matrix42 recommends cleaning up older log and application data that is no longer needed at regular intervals to ensure consistent system performance. Perform these cleanups after a database backup, as all data is backed up in case of accidental deletion.
Stop all services that access the database. All Empirum services can be stopped using the script Start-Stop-Remove_EmpirumServices.cmd in the .\Empirum\Empirum DBUtil directory.
- Delete via the Empirum Management Console (EMC) according to their requirements the older log entries via the menu Info -> Delete Log of the respective category.
- Open the Inventory History via the Info menu and delete the older history entries according to your requirements.
- Open the AUT logs via the menu Info and delete the older AUT entries (Application Usage Tracking) according to your requirements.
- In the Audit section of EMC, open the Data -> Delete menu and delete the older audit entries according to your needs.
- Database Scrips:
- Run the following scripts from the .\Empirum\Empirum DBUtil\Scripts\SQL Server\Custom directory via DBUtil -> Run SQL Script:
- PM_Delete_SuperSeded_Patches_from_PatchGroups.sql - deletes all patches created by the vendor by a newer version.
- PRO_EAI_Cleanup.sql - deletes all processed entries created by active filters and external actions (EAI).
UEM Agent Update
Adjust the Agent Update settings of the computers before the update.
The Empirum 22.0 ISO contains a new version of the UEM Agent SFR Release. Please check the Auto Update settings as the Agent is set to "Released" and will be rolled out to all computers which are configured for update to the latest release of the Standard Feature Release version. For more details of the update configurations see the UEM Agent help.
Executing the update to Matrix42 Empirum v22.0
- Mount the ISO on the master server and start the update by double-clicking the Autorun.exe file. If User Account Control (UAC) is active, Autorun.exe must be run as administrator (context menu > Run as administrator).
- Select the desired installation language.
- Select the Update option and also in the following window.
The installation wizard opens. - Confirm with Yes.
- Confirm all the following windows with Next.
- Select the existing installation directory and click Next.
- Click Finish.
After the update, you will receive a message that the installation was completed successfully. - Restart the server.
First actions via Matrix42 DBUtil
When updating the database, the sysadmin SQL server role is no longer required. Only the dbo role (database owner) is needed.
During the initial creation of databases (EmpLocations, location database), the server permission CREATE ANY DATABASE or the dbcreator role is also required.
Make sure that the databases EmpLocations and the locations are used with the same authentication method in DBUtil.
This does not affect the login to the Matrix42 Management Console, where both methods can be used mixed.
Update EmpLocations Database
- After restarting the server, you can start Matrix42 DBUtil via the desktop icon
DBUtil, or via Start > Programs > Empirum > Tools > Matrix42 DBUtil to log in to the EmpLocations database. - You receive a message that the structure of the location table is outdated. Confirm the message with Yes.
The main window of Matrix42 DBUtil appears.
Update Location Database(s)
- Click on the location you want to update and log in to the location database.
- Click the Update tables icon
on the toolbar.
Note that virus scanners can greatly extend the update process. - If a backup of the location database has not yet taken place shortly before the update, you must absolutely confirm here with Yes!
- The location database has been updated, confirm the message with OK.
Please note that all databases must have version 22.00 / 4-0-0 after the update in order to work error-free with the Matrix42 Empirum v22.0 version!
If you have multiple locations, you must repeat this procedure to update each individual location.
Install/Update Services
After updating to Matrix42 Empirum v22.0, all services must be reinstalled.
- Click the Install/Configure services
icon in the toolbar. - Select the services (except PXE, TFTP, DeviceDiscovery) that are required for your environment and then click the Install button. After successful installation of the selected services, you will receive a message that all services have been installed or updated.
- Install the PXE and DeviceDiscovery service (if used) on the master server from the Install context menu.
- Install the Empirum ServiceBus service (if used) on the master server to benefit from the new feature enhancements. Make sure that the Service Bus settings are set
- Install the DeviceDiscovery service on all other servers where DeviceDiscovery is installed using the Install context menu.
All PXE/TFTP services on the Empirum Depot servers are to be installed via the software package Subdepot PXE Service.
- If you have more than one location to choose from, repeat the procedure to update services for each location.
Further actions after updating the Empirum server
Update Reports
Update the Matrix42 Reports via DBUtil:
DBUtil > Actions > Configure Reporting Services > Install.
If necessary, adjust the port, SSL, and database authentication settings.
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 adjustments, delete 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.
Check PXE Activation
In the Matrix42 Management Cosnole (EMC) > Administration, check the filter PXE > Enabled and correct any entries you do not want.
Check Versions
Perform a Check Versions of the software packages: EMC > Configuration > Software Management > Depot > Extras > Check Versions and confirm the changes.
Update the Infrastructure Packages
Update the following packages on the depot servers:
Überprüfen sie ihre bestehenden ODBC Verbindungen und aktualisieren diese mit dem neuen ODBC Treiber 17.9.1!
- Empirum Subdepot 22.0
- Empirum Subdepot Webservice Configuration 22.0 (if used)
- Empirum Subdepot PXE Service 22.0 (if used)
- Empirum Subdepot WOL Service 22.0 (if used)
Update Matrix42 Management Console
Update the Matrix42 Management Console on the appropriate workstations.
Update Web Console
Update the Empirum Web Console via the appropriate package.
Reinstall Client Components
When updating to Matrix42 Empirum v22.0, all client components on the managed computers must be updated. Please refer to the document Update of the Client Components - Best Practice.
The UEM Agent is registered as not released in the depot after the update to prevent automatic rollouts when using the autoupdate feature. Only computers configured with the MX42_UEM_Agent / Auto Update / Yes - Use latest available version (Pilot rollout) option receive the new UEM Agent automatically. Release the UEM Agent as soon as it is to be rolled out generally.
The Empirum Packaging Center 22.0 package can only be installed successfully if older versions of the package have been uninstalled before.
WinPE Configurations
Create new WinPE boot configurations to take advantage of the new feature enhancements.
The latest PreOS packages are NOT automatically imported when updating to Empirum v22.0. You will find the latest PreOS packages in the known directory and can import them via the EMC import as usual.
If you have manually made changes under .\EmpInst\Sys\Images\WinPE (e.g. adjustment to the BCD), these changes must be made again.
The previous folder will be saved under the name "WinPE_Backup" during the update.
Please check the latest available Addon components:
- UEM Agent: https://marketplace.matrix42.com/details/uem-agent-windows-release/
- WinPE: https://marketplace.matrix42.com/de/details/winpe/
- UUX for SUEM: https://marketplace.matrix42.com/unified-endpoint-management/uux-for-uem/
- Matrix42 SDK: https://marketplace.matrix42.com/de/details/empirum-software-development-kit-sdk/
- Matrix42 Package Robot: https://marketplace.matrix42.com/details/package-robot/