Contact Us
If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.
toni.tolvanen@matrix42.com
Article
Last Month
Use this function to change the value of a variable for a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 2, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an ex
Allows you to change the services server password for the selected database (e.g., sa). Select Actions > User Management… The dialog box User Management appears. Select the database sure (e.g., sa) and click Edit.The dialog box Modify user appears. Enter the old password of the selected database user under Old password and the new password under
Use this function to delete an assigned Empirum server class from a configuration group. Empirum Interface Service: ActionType = 6, ActionCode = 81, TargetObjectType = 11 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentNa
Please note that the objects (software packages and operating system templates) of a group are inherited by the subordinated groups. Example: In this example, the special groups are hidden. The software package Adobe Acrobat_Reader and the operating system template XP_PRO_DEMO have been assigned to the group Accounting and are inherited to the subgr
Allows you to search for a software. Right-click Configuration Groups and select Search Software... from the popup menu.The Search results dialog box appears. Enter the name of the software you want to search for. If you do not know the exact name, use wildcards for searching. Example : If you search for Adobe%, you will find the software Adobe, Ado
The feature EndOfLife Management allows you as Empirum User to fully and simply erase all managed computers. The erasing comprises the local hard drive of the computer according to configurable standards and the optional removal of the computer object from the Empirum database and - if desired - from the directory service (ADS or NDS). A template mu
Enter the ports to be scanned, separated with commas: Ports are address components used in network protocols to assign data segments to the correct services (protocols).A port number has a size of 16 bits, i.e., its value can range between 0 and 65535. Certain applications use fixed port numbers that are assigned by IANA and are generally known. In
How to deactivate an object: Right-click the object you want to deactivate, and select Deactivate... from the pop-up menu. For descriptions of the individual parameters, see Deactivate (PULL) and Deactivate (PUSH).
In the middle part of the Administration tab, the configuration of the groups is indicated. Configuration Groups: Every configuration group is split into 3 special groups. The special groups can be shown and hidden individually (see the Showing or Hiding Special Groups section below). Computers: In this group, computers, operating system templates,
The Empirum Automation Interface (EAI) tables can be found in the database of the respective Empirum location. In order to use the interface, two tables with corresponding tasks and parameters have to be filled out, and after the processing with Empirum, to be deleted again. A description of all possible parameters, as well as common examples can be
After selecting the network adapter(s), select the Create PXE Image icon. The name of the PXE image corresponds to the name of the stored floppy disk configuration. It is limited to 8 characters. The PXE image was up to Empirum version 15.1 Patch 08 stored in the .\Empirum\EmpInst\Wizard\Image\PXEImages\ directory. From the Feature Pack 01 (patch 09
OR classes are very suitable for constellations as shown in the picture. Software can only be installed when Adobe Acrobat Reader is installed, any of the specified version can be installed If they are included in an OR class, the OR class is specified as dependency for this package. To create/configure an OR class: Go to the Depot tab in the Config
Creating a New Action How to create a new action for alarm management. Right-click an existing configuration (e.g., Distribution > DIST_ERROR) and select New action from the pop-up menu.The Edit Action dialog box appears. Editing an Existing Action How to edit an existing action for alarm management. Right-click an existing action, and select Edi
This setting is only required for an Empirum Agent template on a Citrix server. The Matrix42 Agent automatically detects when it is installed on a Terminal Server. In this case, no kiosk is displayed. It is also not possible to display the kiosk for testing purposes. If you want to update a Citrix server where several users might be logged in you ne
Overview FastViewer acts as the secure endpoint execution layer for approved remediation tasks triggered from Proactive Device Insights. It becomes the trusted bridge between portal recommendations and endpoint remediation. Key Capabilities Execute scripts, commands, or policy actions remotely on the target device. Verify device availability before
This is how you add an entry to a table: Click anywhere in the table. Select the menu Edit > Add or click in the icon bar or in the context menu on the symbol. Depending on the respective section of the configuration, a dialog appears, in which you can now enter the desired values for the new entry. Then confirm with OK. The new entry now appears
Updates an existing database (Empirum 2005 PFP R2 and higher) to the current version. Select the location of the database. Select Actions > Update Tables.The following inquiry appears: Confirm this message with Yes.After the successful update, the success message will be displayed. Confirm this message with OK.The selected location database is no
Use this function to activate the software and the operating system of a configuration group. Empirum Interface Service: ActionType = 6, ActionCode = 20, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + Pare
Go to Actions > Configure Reporting Services or click the icon in the toolbar. Enter the Server Name under Reporting Server (e.g., SERVER). Enter ReportServer_Empirum in the Virtual Directory field if the SQL server has been installed via the Empirum DVD. Enter this value in the Virtual Directory field. Enter the <Domain>\User and Password
This function assigns a software package to an existing system. Therefor a new configuration group is created, which receive the specified group name or the name of the computer. This function assigns a software package to an existing system. Empirum Interface Service: ActionType = 5, ActionCode = 16, TargetObjectType = 2 Parameter Parameter Example
Overview The Self Service Portal offers a redesigned landing page that gives end users faster access to the information, services, and actions most relevant to them. It is built on the Matrix42 Reporting Toolkit, replacing the legacy widget framework with a reusable, configurable layout foundation. The new landing page is an alternative landing expe
File New Opens a new configuration (template) with the default settings. Open Opens a window where all Empirum Agent templates stored in the database are listed. Mark the template to be edited and click Open. Import Opens a window where you may, for instance, import a template created on another Empirum Server. Save All changes to the current Empiru
For the unattended installation of a client there are different Empirum pre-installation environments available. The configuration of these environments is shown in the sections below: The installation via Empirum Preinstallation Environment is explained in the chapter Installation Type Empirum Preinstallation Environment. The Installation Type CD_B
This tab is used to specify the settings required for creating an installation disk. The File Menu New. Creates a new disk configuration, a new boot template, or a new operating system configuration. Open. Opens an existing disk configuration. Select File > Open. Select a file name and click the Open button. or Select File > Recent Disk Config
This function allows you to assign a PM class or a PM test class to a configuration or assignment group. Empirum Interface Service: ActionType = 5, ActionCode = 10, TargetObjectType = 15 Parameter Parameter Example Variants General PMGroupID 15 {PMGroupName + PMGroupType} <GroupConfig><PMGroupName>Win8_atches</PMGroupName><PMGro
The "Matrix42 Empirum Subdepot" package must be installed, unless you want to synchronize via SMB protocol. We recommend to always install the Empirum Master server to prepare the server for any protocols. To configure the Empirum Master Server: Launch the Empirum Management Console and go to Management > Administration in the navigation pane. Dr
Use this function to delete the value of a variable from a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 3, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an e
With the Sync Monitor, remote Sync Services can be addressed. Information are displayed in real time, as if the Sync Monitor were started locally. It is possible to monitor the window and to start/stop single jobs. The starting of the Sync Configurator is not possible. This is how you access remote Sync Services: Right-click the computer, for which
How to deactivate a computer, a user, or group: Right-click the computer, user, or group you want to deactivate and select Deactivate from the context menu.The Deactivate dialog box appears. Define your settings and confirm them with Finish. Distribution Command Software Distribution Remove Software from configuration file (DDC). The corresponding d
The actions and events which have been defined on the interface as well as actions and events on the Empirum clients are recorded in log files. How to display the file SWDepot.log, for instance: Right-click Computers, one of the filters (e.g. Not assigned), or an already created computer, and select Show Log... from the popup menu.The Log for Group:
Shows the documentation file defined for this package. The following settings have to be made to display the documentation file: The complete path to the documentation file must be entered in Software Management > Depot > right-click Software > Properties> View > Docu file. If you only enter the file name of the documentation file, th
"case sensitive" must not be enabled for the installation of SQL Server!If "case sensitive" is enabled on an existing server and the Empirum EmpLocations database is created on this server, it will not be possible to log on to the EmpLocations database! No further location databases can be created. How can I find out on an existing SQL server if "ca
Software classes are defined in the Configurator module > Depot tab > Classes exclusively. In the Manager module, you can assign these classes to the configuration groups. To increase the usability, you can click Show Content… to display the content and a description of a software class in the context menu of this class or the respective confi
Shows the selection of the user of the installation (DOS log-on), the IP configuration of the boot disk and the log-in information for the Empirum server - domain or workgroup. Under Client Properties on the Boot Disk > Disk Configuration tab, enter the user name and password of the installation user and specify the network properties of the Empi
The following sections describe how to customize a software depot to individual requirements. Cutting Objects How to cut selected objects Select the objects. Select the menu Edit > Cut. The cut objects are stored in the clipboard and can be pasted into other documents. You can only cut objects that may also be deleted. Copying Objects How to copy
The following computers are distinguished: Not Assigned Cmputers The color of the computer / server icon is red. Computers which have not yet been assigned to a group. Not assigned computers which can be booted via PXE. Servers which have not yet been assigned to a group. Not assigned servers which can be booted via PXE. Assigned Computers The color
This function is used to activate the operating system assigned to a computer. Empirum Interface Service: ActionType = 4, ActionCode = 20, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + Pare
Empirum works based on the "desired state" model, which means that the administrator uses configuration and assignment groups to define the target state of each system or user regarding the objects managed via Empirum, for instance, software packages and operating systems. General definitions are specified only once through the hierarchical inherita
Displays an overview of the configuration groups that the software packages are assigned to. Right-click Configuration Groups and select Show Software... from the pop-up menu.The Assigned Software to Group: Configuration Groups dialog box appears. The software packages and the configuration groups the software is assigned to will be displayed. By cl
The DHCP options defined herein are read out after a DHCP request from a client and are written into the environment of the respective client by SwDepot.exe. Start Matrix42 DBUtil and log into your location database. Select the Menu Actions > Install/Configure Services.. > click the right mouse key on Empirum-PXE and select DHCP Options. The D
Use this function to assign an existing system to an existing configuration group and activate the assigned operating system. Empirum Interface Service: ActionType = 4, ActionCode = 55, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1
The SQL Server Desktop Engine (MSDE) is delivered along with Empirum. The MSDE is a fully functional MS SQL Server.MSDE has no graphical user interface and has some more restrictions, which do not, however, affect the functionality of Empirum.Like every database server, MSDE needs regular maintenance including a backup.You can find the files PRO_Bac
Action Filters Empirum Action Filters are filters on whose elements (computers, handhelds, unknown devices) specific actions can be executed at definable intervals. The service Empirum Policy is responsible for executing Empirum Action Filters. This service continually checks whether a programmed action is to be executed. The service writes the task
When the EAI Interface Service is concerned, the numerical values are summed up, i.e., „3“ corresponds to the distribution command „install + update“. Empirum Interface Service Short description 1 Install 2 Update 4 Always enforce 8 Uninstall 16 User can Postpone 32 Enforce machine part 64 Enforce client part 128 Enforce uninstallation after time la
Displays an overview of the configuration groups the computers are assigned to. Right-click the Configuration Group and select Show Computers... from the pop-up menu.The Assigned Computer to Group: Configuration Groups dialog box appears. The computers and the configuration groups the computers are assigned to will be displayed. By clicking the colu
Folder. The folder and all subfolders are excluded from the file search. Example: %TEMP% %Desktop%\%HKCR,Briefcase% %InternetCache%
To work with the Empirum Management Console, you need to identify yourself with your user name and password. Double-click the Matrix42 Management Console icon on the desktop or select Start > Programs > Matrix42 Management Console to launch the Matrix42 Management Console.The Empirum Login dialog box appears. Enter your Username and Password,
To create a new group: Right-click on a configuration group and select New Group. Enter the name and a description (optional) of the group. Under Special Configuration Group currently only the "Type of Group" Standard can be specified. Standard: This configuration type is used for general configuration settings. Subordinated groups inherit their inf
If the additional information of the computers of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported and select Export
Represents the interface between Empirum and the previously used Inventory solutions for the data of the computers. You can define via this dialog, how the data from the previous Inventory database are to be imported into the Empirum database. The import of the data takes place via a text file (.csv), which has a certain structure and predefined sep
Allows you to search for a computer within a configuration. Right-click one of the filters (e.g. Not assigned computers) and select Search Computers... from the popup menu. Enter the name of the computer you want to search for. If you do not know the exact name of the computer, use wildcards for searching. Example: If you search for PC%, you will fi
From EPE version 01.051 onward it is possible to integrate your own logos into the EPE browser. The following steps must be performed to show the modified logos: The name top2.gif must be used for the top right picture in the EPE browser. The picture must have the following size: width 393 pixels max., height 135 pixels max. The name bottom_small.gi
This function allows you to delete a software package from an existing configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 11, TargetObjectType = 2 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + Parent
How to rename an object: Right-click the object you want to rename. Select Edit > Rename.The name of the object is placed in a black rectangle. Enter the new name of the object in the black rectangle, and confirm your entry by hitting ENTER or by clicking your mouse.
How to display the help topics: Select the ? > Help Topics menu. How to display the version information: Select the ? > Info menu.
How to display the properties of an operating system template, or change them directly: Right-click an operating system template, and select Properties... from the popup menu.You are led to the tab of the selected operating system template on the OS Installer tab. This dialog box displays the desired properties of the operating system template. Yo
Shows the selection of the user of the installation, the IP configuration of the boot disk and the log-in information for the Empirum server - domain or workgroup. Under Client Properties on the Boot Disk > Disk Configuration tab, enter the user name and password of the installation user and specify the network properties of the Empirum installat
In order to import additional information, you first have to create an import profile. Start the Empirum Management Console (EMC), change to the Manager module and click on Menu File > Import Computers... or click on the symbol in the toolbar. Via the Open button, select the file to be imported as source. Click on the New/Edit button. Source. Her
A sync template allows you to synchronize files or whole directories (a source and one or several destinations). Several predefined sync templates are available for standard synch tasks. To create a new sync template, right-click Sync Templates in Management > Administration tab and select New… Sync-Templates - Template name, Source and Target pa
BIT VALUE RIGHT REM 0 1 administrative Includes all other rights 1 2 insert computer 2 4 insert user 3 8 insert software 4 16 insert OS template 5 32 insert PXE template 6 64 view in webconsole 7 128 create subgroups 8 256 delete subgroups 9 512 activate Requirement for activate PXE and reinstall 10 1024 edit distribution commands
If you select the installation type Empirum PE, besides the dialogs described in the Section General Properties, you will additionally have the following settings possibilities: In the navigation bar switch to Configuration > OS Installer > Bootdisk > Disk Configuration. Select the Installation type Empirum PE. You can select various EPE ve
Example 1 Assign a computer to a configuration group through the helpdesk system. Table EmpExtSubscribers ID Name ExpirationDate 1 HelpDesk 09.10.2008 Table EmpTaskQueue ID ID_EmpExtSubscribers Priority Name ActionType ActionCode TargetObjectType 42 1 NULL Client1 5 10 1 Status AllOrNothing InsertTimeStamp ErrorCode ErrorText LastUpdate 1 NULL 16.11
How to copy a user: Right-click the user you want to copy and select Copy from the popup menu. Users can only be added in the middle section of the Administration tab.
After installing Matrix42 on the server, the EmpLocations database must be created first. By clicking the Create... button, you will create the EmpLocations database with the appropriate DSN. The EmpLocations is required to create a location database or additional location databases. The EmpLocations database serves to manage the locations. This d
Launching the remote control as a helper application (example for FastMaster) An entry must be integrated into the registry for the helper application: [HKEY_CLASSES_ROOT\FastMaster] @="URL:FastMaster Protocol" "URL Protocol"="" [HKEY_CLASSES_ROOT\FastMaster\shell] [HKEY_CLASSES_ROOT\FastMaster\shell\open] [HKEY_CLASSES_ROOT\FastMaster\shell\open\co
Creates or resets the schema in the database, which releases the licenses that had been entered for this location. The location database must be assigned licenses again. Select Actions > Create Tables…The following inquiry appears: Confirm this message with Yes. Enter the name of the Empirum server for the source files of this location, and confi
Creates an overview of all Empirum Inventory data for the selected computer.
This page provides a complete description of how to configure DDSCompare with the new parameters (/include, /exclude). The description is based on the /include parameter, including the use of the %PACKAGEDIRLIST1% variable. The process is identical for the /exclude parameter. To ensure the correct synchronization source > destination, the prerequ
This function is used to disable a system’s operating system. Empirum Interface Service: ActionType = 4, ActionCode = 30, TargetObjectType = 1 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit {GroupNam
Use this function to assign an existing system to an existing configuration group and activate the assigned software and the assigned operating system. Empirum Interface Service: ActionType = 6, ActionCode = 55, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} Group
This software package is used to configure a Windows computer as depot server. Installs the Windows EmpSync service and the assigned Sync templates as well as the iperf (bandwidth determination) and rsync (alternative protocol) services. To do so, the SUBDEPOT variable must be configured accordingly.
Empirum Subdepot Services Package Starting with version 16.1 Update 1 the functionality of the Subdepot Services package was transferred into two separately installable packages: Empirum Subdepot PXE Service Empirum Subdepot WOL Service
ESM Platform – Configuration Projects – Bulk Object Selection and Updates: https://docs.matrix42.com/en_US/1065197_configuration-packaging/3460475_configuration-project-development/ Workflow Designer – Execute Workflow Studio Workflows: https://docs.matrix42.com/1112979_ai-native-workflow-designer/3625251_workflow-designer-actions#run-subworkflow-13
This function is used to set the distribution options for software. Empirum Interface Service: ActionType = 5, ActionCode = 23, TargetObjectType = 2 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit {Gr
This function can be used to delete a user from the database. Empirum Interface Service: ActionType = 2, ActionCode = 0, TargetObjectType = 5 Parameter Parameter Example Variants General UserID {LoginName + Domain} ID of the user Read also: Examples of How a Job is Created Variants
There are no more software groups in Empirum v14. They have been replaced by the new assignment concept with Configuration and Assignment Groups and are migrated into standard assignment groups during the update. Update from Empirum v12 R2 to Empirum v14: The system migrates all software groups into standard assignment groups. A subordinated assignm
External systems must be known to the Empirum Interface Service before they can use this service, i.e., they must be entered into the table EmpExtSubscribers. Each system that is controlled by Empirum through this automation interface is assigned a unique ID and a description. The ID ensures that each job is assigned to one external system only and
For the selected location database, the server name is changed in all database tables. This makes sense, if the Empirum server is exchanged, changed or newly installed with a new name and the old database is used. This feature also allows you to rename a database that is imported from another location/server to your location/server. Flag Local or en
If the EmpLocations database has been created with Windows User Authentication, you can add users and groups to the location database via the Browse button. In order to add a user, in the Matrix42 DBUtil main window, click on Actions > User Administration... in the Users tab, on the New button, and then on the Browse button.You get to the window
Displays for the selected group a list of all activated push-tasks which are executed on Software Depot or are still running. Date: Specifies the date and time when the Software Depot push will be executed. Computer: Specifies the name of the computer on which the Software Depot push will be executed. Package: Specifies the name of the software pack
In order to import users, you first have to create an Import Profile. Start the Empirum Management Console (EMC), change to the Manager Module and click on Menu File > Import Users... or click on the symbol in the toolbar. Via the Open button, select the file to be imported as source. Click on the New/Edit button. Source. Here you can enter the p
The specified files are excluded from the Application Usage Tracking (AUT). Filename Example: Outlook.exe Version Example: 10.0 File size. Exact file size. Example: 61440
AND classes are very suitable for software that is dependent on multiple packages. You can categorize these different packages in an AND class and specify it as a dependency for the software. Adding a package to an assigned AND class for a "fully activated" system: The font color of the computer in the administration changes to brown. The DDC is not
On the right side of the Administration tab, the views, the software packages, software classes, variable configurations, patch -management, operating system templates, operating system imports, language pack imports, PXE boot images, sync templates agent templates and disk image classes are shown. They can be assigned to the corresponding configura
This function assigns an existing system to an existing configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 10, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + Parent
Use the scheduler to define the duration (start and end time), the frequency (per day, within a time frame) and the recurrence pattern (interval) for the synchronization. Click OK when all settings have been defined. Duration Start. Start time for the command. End after "n" occurrences. Synchronization is performed "n" times. End by: From this time,
The custom scripts in the directory Empirum DBUtil\Scripts\SQLServer\Custom (.sql) on the ISO file have been cleaned, and the naming of the scripts has been updated. Thus it is clear at the first glance for which module the script is intended. There is a unitary header in each script, which among other things explains what exactly the script does. T
This function is used to assign a software class to an existing system. If this system is not assigned to a configuration group, a new configuration group will be created; it has either the allocated group name or the name is made up of „Domain\ComputerName“. Empirum Interface Service: ActionType = 5, ActionCode = 16, TargetObjectType = 8 Parameter
Each job includes suitable parameters, which are stored in the table EmpTaskParam. An ID connects the respective task to the related parameters. All mandatory fields must be set to be able to execute the job. Name Description/Value Typ ID Unique ID E ID_EmpTaskQueue Foreign key of the respective job from the EmpTaskQueue table M Name Name of the par
This function is used to activate a user. Empirum Interface Service: ActionType = 5, ActionCode = 20, TargetObjectType = 5 Parameter Parameter Example Variants General UserID 102 {LoginName + Domain} ID of the user GlobalActivation 1 0 = Local activation (default). Only locally assigned packages are activated. 1 = Global activation. All assigne
This function is used to assign a software class to an existing system and activate this software class. If this system is not assigned to a configuration group, a new configuration group will be created; it has either the allocated group name or the name is made up of „Domain\ComputerName“. Empirum Interface Service: ActionType = 5, ActionCode = 58
This function is used to deactivate all systems of a configuration group, including the assigned software. Empirum Interface Service: ActionType = 5, ActionCode = 30, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {Gro
Shortcuts to change the navigation pane: ALT+M > Management ALT+K and ALT+C > Configuration ALT+S and ALT+L > Locations ALT+T > to the next tab (e.g.: from Management > Configuration) ALT+SHIFT+T > to the previous tab (e.g.: from Configuration > Management) It is also possible to jump to the last view: ALT + > (last tab) &g
This function is used to delete a configuration group from the database. Empirum Interface Service: ActionType = 2, ActionCode = 0, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit
Select the menu View > Software Groups. The software groups are displayed in the middle window. The software groups are not displayed in the middle window.
Rollout Coordination How to open the Rollout Coordination... dialog box: Select the menu Info > Rollout Coordination... The Rollout Coordination... dialog box will be displayed. For additional information, see RollOut Termination. Push Tasks How to open the Push Tasks... dialog box: Select the menu Info > Push Tasks... The Push Tasks... dialog
Each task to be executed via the Empirum Interface Service requires certain parameters, which must be entered into the three tables in the Empirum database. Alternatively, these actions can also be allocated via an XML file. The tables of the Empirum Interface Service are stored in the database of the respective Empirum location. To execute an actio
This function is used to delete a user from a configuration group. Empirum Interface Service: ActionType = 2, ActionCode = 11, TargetObjectType = 5 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit {Gro
Adds an Empirum server to the selected configuration group or filter. This setting is required for Empirum Sync. Adding another Empirum servers creates the complete structure beginning with the directory .\Empirum\Configurator\Values\ for this server to allow for the distribution of software packages, synchronizing only the distribution commands (*d
To insert a new tab: Select Add > Register… Select the respective tab in the dialog box. Change the settings and click OK or Apply. Tabs help you to categorize software, e.g., default, development, printers. Register Properties – View Edits a tab view. Name. Specifies the internal name of a tab. This name has to be unique within the software depo
Provides detailed information about enabled Empirum Sync jobs. Event viewer. Here, detailed information will be displayed per job or for all jobs to be synchronized. Black font color. A directory or status message was created. Blue font color. File has been synchronized. Red font color. An error has occurred; the exact description of the error is pr
This function is used to create new file or computer data sources, modify, remove or test existing ones.
Empirum's configuration and assignment groups provide various options to define the target state for system- and user-specific software management. Groups combine computer and user objects with Empirum's configuration objects. By combining computer objects with common Empirum templates (for instance, for operating system configurations, patch assign
Menu File > Exit: Exits Matrix42 DBUtil. Menu View > Symbol Bar: Shows/masks the symbol bar. Menu View > Status Bar: Shows/masks the status bar. Menu ? > Help: Opens the online help.
This section defines the version, the layout, and the installation parameters of the software of the SwDepot. Version=<Version number> Specifies the version of SwDepot.exe for which the configuration file was written. If this entry is missing, version 3.0 is presumed. The current version can also process files which were written for an earlier
Select your WMI settings in this group field: Use custom queries. As with Empirum Inventory, you may use this option to include User-Defined WMI Queries by activating the respective checkbox and clicking the button . Exclude classes. Use this option to exclude certain classes.
This function assigns an existing user to an existing configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 10, TargetObjectType = 5 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an expli
To create a floppy disk with you configurations follow these steps: Click Create floppy disk. The Save Configuration dialog box appears: Enter a name for the disk configuration (maximum 8 characters) and click Save. Insert an empty floppy disk into the disk drive of your PC. The disk inserted into the disk drive will be formatted. All data still on
To support current hardware - keyword Skylake - you can download the EPE 4 via the Matrix42 Marketplace. For more detailed information, such as the EPE 4 is to be used, please refer to the how-to (PDF format). Serves to selecting the installation type which configures the way the operating system will be installed. To create an installation disk, pl
Use this function to create a new configuration or assignment group Empirum Interface Service: ActionType = 1, ActionCode = 0, TargetObjectType = 3 Parameter Parameter Example Variants General GroupPath GroupLevel1\GroupLevel2\NewGroup {GroupName} or {GroupName + ParentPath}or {GroupName + ParentName} or {GroupName + ParentID} GroupType AssignmG
Here you can make changes to the security settings for some files. To use the following settings, you have to have a valid X.509 certificate and its thumbprint. Generic information to those certificates can be found on https://en.wikipedia.org/wiki/X.509. On the server, you need the certificate with its private key. For clients with UEM Agents up to
This function is used to assign a Empirum server to a configuration group. Empirum Interface Service: ActionType = 6, ActionCode = 10, TargetObjectType = 11 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an expl
Settings for proxy servers can be made in this tab. Some Empirum modules (Patch Management, Download Latest UEM Agent, Download Latest WinPE Support Package) use the settings made here. Only Basic proxy authentication is supported Adress (http)Enter the adress of the proxy server for usage of the http protocol. Adress (https)Enter the adress of the
This function is used to assign a Empirum server to a client. Empirum Interface Service: ActionType = 6, ActionCode = 16, TargetObjectType = 11 Parameter (Only for the Empirum Interface Service) Parameter Example Variants General ClientName Name of the computer ClientDomain Name of the domain of the computer ServerName Name of the subdep
User-defined filters allow you to define a customized overview of the computers and users. How to configure a user-defined filter: Right-click Computers or User and select Filter... from the popup menu.The Filter-Owner dialog box appears: If an existing filter is opened to be edited, the title bar displays the filter owner. Define the filter name an
With Empirum Sync, you can synchronize the data stocks (Empirum packages, source files for Empirum Installer, etc.) on one or several locations. The source and the destination can be any available (network) directory. For instance, the central Empirum Software Depot can be synchronized automatically for further locations. It is not relevant whether
The properties of a computer can be modified after having imported or created the computer. How to edit the properties of a computer: Select the computer whose properties you want to edit. Right-click, and select Properties from the popup menu.The Properties for Computer: <Computer name> dialog box appears. The General Tab Shows the parameters
Settings, which are selected here applied for all services, as far as explicit no other logon information for the relevant service is registered. Service Server: Names of the server on which the services are to be installed. Operating System Login Name: User Account to install the services on the services server. If UAC (User Account Control) is ena
Allows you to create a data source (DSN) or to assign it to a new or existing location. To edit the data source of a location, you must proceed as follows: Select the location. Select Actions > Edit location… DSN: The data source has to be selected here Database Username: Name of the database user for logging on to the database server (e.g., "sa"
The actions and events which have been defined on the interface as well as actions and events on the Empirum clients are recorded in log files. How to display the file SwDepot.log, for instance: Right-click on Computers, one of the filters (e.g. Unassigned Computers) or an already created computer, and in the context menu select Show Log… The Log fo
This is how you create a new device type: In the menu Extras > Settings > select Miscellaneous Devices. You get to the Properties dialog: Click on the symbol for creating a new device type. Enter the name for the device type in the Device type field (e.g. Projector). Change icon…: Here you can set any icon for a device type from a file. Variab
Defines the commands of a tab as well as additional properties. Properties are defined by adding a leading '.'. Every property should only be defined once, but there can be as many command definitions as you like. .TabIcon=File name[, Number] Defines the small icon displayed to the left of the tab. Number defines the index in the icon file File name
Unmanaged devices can be integrated into the Empirum database: Manually via the Empirum interface By importing an external file This is how you add a new unmanaged device: Select menu File > New Device..., or right-click Miscellaneous Devices, one of the filters (e.g. All devices) or an already added device, and select New Device... in the contex
Allows the user to specify a dedicated service user account for logging into a Microsoft operating system (from Windows NT 4.0). The default account is the system account. If the database logon takes place via the ADS authentication, no system account is to be selected for the service logon. The authentication has to take place via the setting This
You can show or hide the status bar at the bottom of the Empirum Management Console via the View > Status Bar menu. While you move through the menus with the help of the ARROW KEYS, the left part of the status bar describes the function of the menu entries. Accordingly, you can receive descriptions of the toolbar functions by pressing and holding
In this tab, you may assign attributes or default values from the directory service (ADS or NDS) to the variables of the Matrix42 location database. Synchronization is done through the Empirum LDAPSync service. Explanations of the directory attributes can, for instance, be found on the Microsoft MSDN page. Adds the marked directory attribute in the
Matrix42 Administration is a module of the Matrix42 Workplace Management suite. All important PC and user configuration data are stored in a central place (SQL server). Based on this information, an extensive management of machine- and user-specific configuration components becomes possible. By linking the individual modules of the Matrix42 Workplac
Filters allow you to better organize the user view and to customize the view. There are predefined Default Filters, but you can also configure your own Custom Filters.
This function is used to deactivate all systems of a configuration group, including the assigned operating system. Empirum Interface Service: ActionType = 4, ActionCode = 30, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath}
Filters allow you to better organize the computers and/or users and to customize their view. There are predefined Default Filters, but you can also configure your own Custom Filters.
The MIB Browser is opened in the Administration view via the context menu in the filter Miscellaneous Devices > MIB Browser : The MIB Browser can also be found under Overview of SNMP Rules and Mappings. The following dialog is displayed: In the upper window you see the directory tree where all OIDs are displayed in a hierarchical order. MIB Infor
The properties of an unmanaged device can be modified subsequently, after adding or import. This is how you edit the properties of an unmanaged device: Right-click the device, for which the properties are to be edited and in the context menu click Properties… You get to the dialog Properties for Device: <Name>: General tab. Shows the parameter
A package can only be defined as a dependency in other packages, when it has been saved at least once, since the SoftwareID that has been created during the first save process is used for the assignment. To define dependencies for a software package: Right-click on the software package for which a dependency shall be defined and select Properties… S
The MIB Browser is opened in the Administration view via the context menu in the filter Miscellaneous Devices > MIB Browser : The MIB Browser can also be found under SNMP Rules and Mappings. The following dialog is displayed: In the upper window you see the directory tree where all OIDs are displayed in a hierarchical order. MIB Information. In t
This function allows you to delete the variable values of a user. Empirum Interface Service: ActionType = 5, ActionCode = 3, TargetObjectType = 5 Parameter Parameter Example Variants General UserID {LoginName + Domain} VariableName VarMSR1 VariableType UserVariable VariableValue TestWert Read also: Examples of How a Job is Created
In version 22.0, providing jobs via XML Files is disabled with a hotfix. Instead of filling the tables directly, it is also possible to hand over jobs via an XML file. The default location for XML files to be used by the initiator is the directory Configurator\Log\EAI_Jobs on the server, on which the Empirum Interface Service runs (normally, the Emp
This is how a new location is created, i.e. a new Empirum Database is created under SQL: Select Menu Actions > Create Location... or click on the icon .You get to a dialog for entering the location parameters: Database server: Enter the name of the server, on which the new Empirum database is to be created. Database user name: Name of the databas
The properties of a Miscellaneous Device can be modified after detection, creation or import. To edit the properties of a Miscellaneous Device, right-click the device and select Properties... in the context menu. The Properties for Device: Name will be displayed: The above screenshot shows the properties for a device in the Administration View. If t
How to refresh the trees: Right-click on an object in the tree you want to refresh and select Refresh Tree from the popup menu. or Press the <F5> key to refresh all trees. Depending on how extensive the configuration is, refreshing trees may take some time.
The Device Discovery - Log tab displays all messages of the service: The Device Discovery Service must be installed on the select computer, otherwise is in the Device Discovery log nothing shown. Further information about this topic you will find under Show Log.A log is always bound to a client. To show the log in the Empirum Management Console, the
This chapter describes all the dialog boxes required to edit the users. How do you create a user in the Empirum Manager interface? Which parameters can be assigned to a user? How do you import users? We will concentrate exclusively on the Users group on the left side of the Administration tab.
By modifying the file SwDepot.dds or the file you pass to the software depot, you can customize the contents of the tabs during the software installation. You can define up to 100 tabs and include tabs from other files (not Empirum) of local or remote servers. The configuration file is specified directly when launching SwDepot.exe (see Launching the
Here, you can define general options for the Empirum Sync service. General Event Log Flags (Start/Stop Events). 0 = do not show start/stop events in the event log 1 = show start/stop events in the event log Check Interval. Interval (in seconds), in which the service searches for activated tasks which are to be executed. Service status. Shows the st
Executes .sql files (e.g., custom scripts) for the selected location database. These files do not have to be personalized, i.e., database name, database user, and password are entered individually. Select Actions > Execute SQL scripts.... Select a SQL script file and confirm with Open. The file is now executed.
Overview You can switch between three display modes for Neo Agentic Assistant, based on your preferences, available screen space, and current task. Display Modes Side Panel: keeps Neo visible alongside the current application, letting you interact with the assistant while working with tickets, reports, workflows, or other business objects. Floating
Defines an application Check=File | Directory Defines the file or directory for which the user has to have read permission to install the application. If the value is empty, all strings from CmdLine will be checked. If CmdLine consists of multiple parameters (file names), this check will be faster. Further below, it can also be accessed via %Check%.
This function is used to compare the data of the respective Setup.inf (master) to those in the database. In case of inconsistencies, an alert is sent, and you can decide how you want to proceed. If no error message is displayed when this action is performed, your data are consistent. To compare the versions in the software depot with the setup scrip
If the data of the users of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported, and select Export to File... Specify t
Allows you to assign or remove (release) licenses to/from the selected location. Enter the number of licenses for the location. Double-click on the relevant location and confirm with OK. To apply the settings, click the Apply button in the License Overview dialog box. Assigned: Specify ho many licenses shall be assigned to the selected location. Tot
This chapter describes all the dialog boxes required to edit the configuration groups. How do you create a group in the Empirum Manager interface? How do you add computers, users, software, and operating system templates? We will concentrate exclusively on the middle part of the Administration tab. Context menu Configuration Groups > Group Under
The Depot - Server name dialog box displays a list of all the software components in the defined software tabs available for installation. You will be shown only those software packages for which you have access rights. Select one or more software packages from the list.The Propose and Install buttons are displayed with a specific mode only. Click o
This is how you delete a device type: Select the menu Extras > Settings > Miscellaneous Devices. You get to the Properties dialog: Select the desired device type. Click on the symbol , for deleting the device type.The following message is displayed: Confirm with Yes, for deleting the device type and all assigned devices of this type. The devic
To delete an existing Empirum database, please proceed as follows: Select the location. Select Actions > Delete location…A security query will be displayed: Confirm the security query with Yes. The selected database will be deleted. Select the desired option and click the Finish button. The location/instance is deleted.
This function allows you to delete a software package completely from the database. Empirum Interface Service: ActionType = 2, ActionCode = 0, TargetObjectType = 2 Parameter Parameter Example Variants General SoftwareID {PackageName} Read also: Examples of How a Job is Created Variants
By right-clicking with the mouse on a service, you receive the following context menus: Install: Installs the selected Matrix42 service. Uninstall: Uninstalls the selected Matrix42 service. Change service server password...: Opens the Update Services Password dialog box. In this dialog box, you may change the password for database users. For more de
After installing Empirum on a server, first the EmpLocations database has to be created. Here you have now the possibility, to log on to the database server via the database authentication, as before (do not tick the checkbox in front of Use Windows Authentication), but also via the new Windows Authentication. The Windows Authentication can only be
The flexible Empirum assignment construct allows for the multiple assignment of objects. For most assignable objects only one instance per system or user can be relevant. This affects for example software packages, OS templates, OS imports or agent templates. Empirum must determine the relevant assignment when these objects are activated, for the sa
In order to successfully install the Empirum ServiceBus service, the configuration steps in Matrix42_RabbitMQ_Step_by_Step_Install_Guide_EN.pdf must be carried out first! The Empirum Service Bus Service exchanges meta-data with the Empirum depots via the Service Bus and also monitors changes to computers, software packages and installation status in
If the Inventory execution parameter /WMI is used, only the ticked WMI classes are selected. The classes themselves cannot be changed.
In this section, variables and registry entries can be specified, from which user-defined values are to be read. Name. Name of the entry in Empirum Inventory. Example: EmpirumServer CurrentNTVersion Value. Environment variable or registry key. Example: %LogonServer% %HKLM,"SOFTWARE\Microsoft\Windows NT\CurrentVersion","CurrentVersion&
Empirum Inventory now allows for the importing of entire files into the Empirum database. In case of regular gathering of inventory data, the most recent file in the database is always saved. Via the Empirum Management Console, the file can be opened and saved. For the imported files, Inventory History is available. Filename. Name and path of the fi
This is how you delete an entry in a table: Select the desired entry in the table. Select the menu Edit > Delete. The entry is now deleted from the table.
This is how you modify an existing Inventory configuration: Select the menu File > Open.... You get to the dialog Open Configuration: Select the desired configuration and click on Open. You can now customize each section, for changing the result of the Inventory scan. This is how you save the configuration: Select the menu File > Save..., for
In case of the file search, all subfolders are queried. If when executing Inventory (EmpInv.exe), the switch /V is used, then the version number can be read additionally. Each property of the software is read automatically, but it can also be edited. Filename. File name of the software. Example: Outlook.exe Developer. Software developer Example: Mic
The specified files are included in the Application Usage Tracking (AUT). Filename Example: Outlook.exe O*.exe
File. The file will be excluded during the file search. Examples: *.tmp *.swp ~*.*
With the use of filters, the display of filters can become more clear, and it can be customized better to the own needs. There are predefined default filters, and there is the possibility of configuring user-defined filters.
Version. BIOS Version, for which no DMI execution is to take place. Example: SATELLIT* v1.8* *Thinkpad*
In this section, software can be included into or excluded from the scan. Software. Name of the software developer. Example: Microsoft* Status Include. Filters the software found. This lists just the specified software of the developer. When executing Empirum Inventory, the parameter /F has to be used for that. Exclude. The software of this develope
Queries can be specified in this section, which read any WMI class. They are shown under WMI Custom in Empirum Inventory. WMI query. Specifies the WMI query Example: Read the memory size of each memory bank: SELECT DeviceLocator,Capacity, PositionInRow, Tag FROM Win32_PhysicalMemory Enumerate. Specifies whether the results of a WMI query are to be r
With the Inventory Configuration it is possible to configure Empirum Inventory via an interface in the Empirum Management Console. An unlimited number of configurations can be saved and edited. There is an individually customizable configuration available for each operating system. Furthermore, there is the possibility of setting entries to inactive
This is how you edit an entry in a table: Select the desired entry in the table. Select the menu Edit > Edit. Depending on the respective section of the configuration, a dialog appears, in which the selected entry can be edited. After changing the entry, click on OK, for confirming the changes. The modified entry now shows up in the table.
Scope. Select the scope that will be excluded from scanning. Delete existing data. Mark the scopes, and all existing data will be deleted. The Exclude Scan Scopes could be overridden with the command line parameter /DMI and /WMI.Do not combine Exclude DMI or WMI with the command line parameter.
The folder, in which the configuration files from the Empirum database are to be written, is set in DBUtil when configuring the Inventory service.
The following Inventory Properties can be defined. Filter for Software Detection. You can define which software is to be listed by Empirum Inventory: Empirum. Lists the software which has been installed with Empirum. MSI. Lists the software which has been installed via an MSI package. File scan. Lists the software which has been defined in the &quo
Depending on the operating system, a different number of settings can be made. This is why, depending on the operating system for which the configuration file is to be created, a different number of sections is displayed. The following sections are available: Configuration Name Properties Software File Scan Registry Scan Exclude Directory Trees Excl
This is how you import the EmpInv.ini files: Select the menu File > Import. You get to the dialog Import File: Select the file you wish to import. Confirm with OK. The files read from the INI file are now available in the interface and can be edited and saved.
Name. The specified network card will be excluded from the inventory. Example: *VMWare* *Loopback*
Entries can be activated or deactivated. The deactivation of entries allows the testing of various settings, without having to delete the entries. This is how you activate/deactivate an entry in a table: Click on the box set before an entry. The Entry is now activated/deactivated. Activated entries in a table are preceded by a ticked checkbox. Deact
Device Discovery is a service that can be configured independently; it is used to automatically detect and inventory heterogeneous devices in a network, including the following: Computers Network printers Switches Routers IP phones etc. To detect these devices, Empirum Device Discovery uses the following scan methods: Ping SNMP DNS Port scan WMI Int
This is how you delete an Inventory Configuration: Select the menu File > Delete.... You get to the dialog Delete Configuration: Select the configuration you wish to delete and click Delete. You get to the dialog Empirum Inventory Configuration: Confirm with OK if you wish to delete the configuration. The configuration is now deleted.
The Inventory configuration allows you to create an unlimited number of Inventory configurations for various operating systems. For each operating system for which a certain Inventory configuration file can be created, there already exists a default configuration in the format EmpInvScan_[OS].xml (e.g. EmpInvScan_WINDOWS.xml). It already contains ce
The following settings can be made in this section: Name. This field displays the configuration name. If the configuration has not been saved yet, then this field is empty. Description. Any text can be entered here as description of the configuration. Version. This field cannot be modified. It contains the Empirum XML file version. Operating system.
This is how you create a new Inventory configuration: Select the Menu File > New.... You get to the dialog New Configuration: Select the operating system, for which you wish to create a new configuration. Confirm with OK. You can now customize each step for for controlling the result of an Inventory scan. This is how you save the configuration:
In order to view the current status of a software package with the computers assigned to it, please proceed as follows: Right-click on a software package and in the context menu select Display Status… The window displays the current status of the selected software for all computers to which this software has been assigned. The status of the computer
The configuration of Empirum Device Discovery can be found under the Device Discovery tab in the navigation section under Configuration > Inventory. The following screen shot shows the first view of the Empirum Device Discovery configuration: The left tree can be used to make additional settings. To do so, left-click the respective item. The tree
The following basic steps are required for a successful inventory of network devices: Install the Empirum Device Discovery service via Empirum DBUtil on a server. Create a Configuration. Alternatively, you may also use the supplied standard configuration; in this case, you can skip point 3. Create a job. Activate the job. Assign the configuration to
If you go to SNMP Rules and Mappings in the directory tree, the following overview is displayed: All available SNMP Rules and Mappings are displayed in the directory tree in the right window. Device Discovery distinguishes between SNMP Rules and SNMP Mappings. SNMP Rules are always marked with the icon. They help to detect a network device and serve
Here you must enter the General Configuration settings for a configuration: Configuration name (mandatory). Enter a unique name for the configuration. Description. In this field you can enter a short description for the user to help better distinguish individual configurations. Max. simultaneous Jobs. Specify the maximum number of jobs to be execute
Use this function to create a new user in the database. Empirum Interface Service: ActionType=1, ActionCode=0, TargetObjectType=5 Parameter Parameter Example Variants General LoginName J. Doe {LoginName} Max. 40 characters Domain TestDomain {Domain} Specification of the domain: Max. 15 characters LastName Doe Max. 40 characters Optional Parameter
Here, the logon information for the Empirum Sync service is entered. Startup type Automatic. The service is started automatically after the operating system start. Manual. The service can be started manually after the operating system start. Disabled. Prevents the service from being started by the system, a user, or an independent service. Local Sys
Use the Configurations context menu to manage the following settings: Context Menu Description New Job Creates a new job for the selected configuration. Start All Starts all jobs of the configuration manually (prerequisite: the jobs are enabled and the configuration is assigned to a server). Pause All Interrupts all jobs of the configuration manuall
Use this dialog to manage users for the WMI authentication: Add. Click Add to create a new user. The following dialog is displayed: Enter a User and a Password to create a new user. For the WMI authentication select local or domain users. Domain user. You always indicate the complete user name here. Example: matrix42\administrator Local user. It is
How to delete a user: Right-click the user you want to delete, and select Delete from the popup menu. If a user is deleted on the left-hand side of the Administration tab, the complete data set will be deleted from the Empirum PRO database. If a user is deleted from a group, he is deleted from the group in the middle section of the Administration ta
Use this dialog to manage users for the Intel AMT authentication: Add. Click Add to create a new user. The following dialog is displayed: Enter a User and a Password to create a new user. Delete. Click the Delete button to delete an existing user. Delete all. Click Delete all to delete all existing users. Edit. Click Edit to modify an existing user.
SNMP Mappings are based on defined SNMP Rules used to read out or assign source values; if a device is detected, these values are written into Empirum Inventory. SNMP Rule. The SNMP Rule displayed in this group field is the basis for the SNMP mapping. Type. Specifies the device type. Vendor. Specifies the vendor of a created network device. Model. S
If the data of the computers of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported, and select Export to File... Speci
Each standard group may be assigned the "self-provisioning" property, which allows you to install computers completely on-site at the user's workplace. You can specify various groups with descriptive and meaningful names; they can be displayed on the systems, depending on the respective user rights. No running operating system on the computer is req
SNMP rules are used to detect a device type, vendor or model. They also serve as a basis for SNMP Mappings. To set up an SNMP rule, right-click the required level in the directory tree. Type Vendor Model Then, select New Type, Vendor, or Model in the context menu. Depending on the level, the following dialog is displayed (in the following screenshot
The Tools menu has the following options: Change Password This option is used to change the password for the logged-on database user. Select the menu Tools > Change Password. Enter the current password and the new password, confirm the new password, and click OK.The password for the logged-on user has been changed. Select Locations How to select
Use this function to set the distribution options for a software class. Empirum Interface Service: ActionType = 5, ActionCode = 23, TargetObjectType = 8 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit
Jobs are managed through the context menu. They can be activated, deactivated, paused, stopped or deleted. Depending on the job status (activated/deactivated) the context menu changes as follows: If a job is deactivated, it cannot be started, paused or stopped. Each Job can be managed individually via the context menu. The following options can be s
Save. Writes all changes in the Depot tab into the database.To ensure the consistency of the depot, all modified packages are automatically prepared for validation and a version check is executed. If you move all packages from one tab to another tab and directly delete this tab without saving the packages (after the move!), all packages of this tab
The Empirum Interface Service is an interface that allows users to execute various jobs via external systems automatically; for instance, it is possible to assign computers to configuration groups, create and delete systems or assign software packages. The Empirum Automation Interface is based on defined tables in the Empirum database and can be use
The icons and the icon text on the Empirum Administration interface change their color and their symbols according to the settings you have made. In order to provide a quick overview of the different variants, all options are indicated with their meanings in this chapter. For descriptions of the individual actions, refer to the respective sections i
A job is assigned to a Configuration on a lower hierarchical level, and a Configuration may be assigned any number of jobs. A job can be Activated or Deactivated. The job status is managed via the Context Menu. A job will only run on a server if it is Activated in the configuration and if the configuration is assigned to a server. Example: The follo
Change Password This option is used to change the password for the logged-on user. Check Versions This function is used to compare the data of the respective Setup.inf (master) with that in the database. In case of inconsistencies, an alert is sent, and you can decide how you want to proceed. If no error message occurs when this action is performed,
Start the Matrix42 Management Console, go to Management > Administration in the navigation pane. Right-click on a configuration group (Training), select New Group (subordinated) in the context menu and enter a name (Client) for the new configuration group. Assign a computer (CLIENT7) from the filter Not assigned computers via the drag & drop
Activate the Use scheduler option in this dialog to use the scheduler for a job. If the checkbox is already enabled, you can click Set up... to open the scheduler. The Scheduler dialog: Action One time. Setting for jobs. The schedule for this job can only be defined under Schedule, all other settings are grayed out. The job is executed once. Recurri
Allows you to specify an installation user account for the selected service to log into a Microsoft operating system. Service Server: Name of the server where the service is to be installed (Do not enter the IP adress). Operating System Login Name: Administrative user account that is used to install the service. Password: Password for the operating
The WMI Query Language (WQL) is an SQL variant for WMI queries (Windows Management Instrumentarium). This dialog can be used to add, edit or delete user-defined WMI queries: To become effective, user-defined WMI queries must be activated by checking the Activate box. Add. Click Add to create a user-defined WMI query. Edit. Click Edit to modify a use
This function deletes the computer from the configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 11, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {Grou
The user and rights management is based on the user and rights management of the underlying database management systems (MS SQL Server). For Matrix42, database roles to execute specific actions are created. These roles have the necessary rights for the database objects. A user must be assigned at least one role in order to be able to perform tasks i
In this group field you can select the scan method: Scan Method Description Results Ping Activates the Ping scan. The Ping method checks if a specific host in an IP network is available and responds. Entry with IP address as unknown device, if a response is determined. DNS Activates the DNS scan. Device Discovery tries to determine the domain of the
Sets up a link to various programs for the remote control of computers. The icon lets you select the corresponding file directly from the directory structure. Name. Allows you to enter a name for the remote control in order to select it later on (see Remote Control of Computers). Path to remote control. Allows you to specify the path to the executab
This function can be used to assign a software package to an existing configuration group. The distribution options are set to „INSTALL UPDATE”. Empirum Interface Service: ActionType = 5, ActionCode = 10, TargetObjectType = 2 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentI
In the SNMP Routes group field you can select the allowed IP addresses and the number of hops: Allowed IP Addresses. Enter IP subnets, IP sections or individual IP addresses to limit the inventory of devices to be scanned. Allowed IP addresses function as a whitelist or positive list, i.e., you specify the IP subnets, IP sections or individual IP ad
Select the SNMP settings in this group field: Use standard communities. In the superordinate configuration, SNMP communities have already been entered; they are basically effective for a job. If you do not want to use the SNMP communities specified in the configuration, disable the respective box. This activates the custom communities box. Use custo
To create a new role, proceed as follows: Select the Actions > User Management... menu and go to the Roles tab. Click New.The Modify role dialog box appears. Give a name to a role, select the user or users in this role, if necessary select roles under roles in this role, and confirm the settings with OK. Role name: Name of the role user to be cre
If you want to distribute push packages (SwDepot push) via an ISDN router, you have to enter the maximum number of simultaneous open connections for the dial up router here. Number of connections. Specifies the maximum number of simultaneous open connections.
Help Topics How to display the help topics: Select the menu ? > Help Topics. Dialog Box Info How to display the Dialog Box Info: Select the menu ? > Info. Displays information on the current Empirum version (versions number, database version), the vendor, the licensee of the product and the purchased licenses per module..
Empirum's depot servers are a very flexible solution for distributing network loads in large or distributed environments. Depot servers can also be used as fallback servers to ensure a higher degree of availability of often business-critical software distribution processes. There are three different variants of depot servers: Standard depot – A Wind
With this tab, you select, from which branch of your directory service (ADS or NDS) you want to synchronize to which configuration group of the Matrix42 location (starting points). In the left window configuration groups are only displayed in case such configuration groups are actually available. After the connection to the ADS or NDS server has bee
If any errors occur during the synchronization, they can be entered as alarm messages in the Empirum database (alarm log). IPC Server DNS Name or IP Address. Name or IP address of the Empirum service server. Port number. IPC port number (communications port) of the Empirum service server. Alert message Send message also on success. Success messages
The actions of Empirum Device Discovery are logged. To do so, go to Management > Audit in the navigation pane. The logged actions can be found underAudit > Software Management > Device Discovery in the middle directory tree. The following actions are logged in the configuration: Logged Action Description AssignConfig Assignment of a configu
To launch the Empirum Agent distribution for the Empirum Legacy Agent prior to and including version 10.5: Click Configuration > Software Management in the navigation pane and open the Agent Distribution tab. The user interface of the Empirum Agent distribution will be displayed. To launch the Empirum Agent distribution for the new Empirum Advanc
Environment Variable. Use this menu point to create a new environment variable or edit or delete an existing environment variable. Tab. Use this option to insert a new tab. A tab serves as a container for software packages. Package. Use this option to insert a new software package into the selected tab.
This is the way you search for Miscellaneous devices: Right-click one of the filters (e.g. All devices) and in the context menu select Search for Devices... or Search profile > Name of the saved search profile. You get to the dialog Search into filter: <Filter name>: Name. A search profile can be selected here or the name for a new Search p
The Variables dialog box is displayed. The registration dates for the advanced agent have to be entered directly in the variables of the Empirum server. The password is going to enter unencoded, the encoding is carried out automatically. Double-click the SUBDEPOT variable or click Edit. Mark the USER_1 variable and click Edit. Uncheck the Empty valu
Cutting Objects How to cut selected objects: Select the objects. Select the Edit > Cut menu or use the shortcut Ctrl + X. The cut objects are stored in the clipboard and can be pasted into other documents. You can only cut objects which may also be deleted. Copying Objects How to copy selected objects to the clipboard: Select the objects. Select
The File Menu The File Menu contains the following entries: New Computer How to add a new computer: Select the menu File > New Computer... or right-click Computers, one of the filters (e.g. Not assigned computers) or an already created computer and select New Computer... from the popup menu.The Add new Computer... dialog box appears. Specify the
In these examples we start from the Example Software Management created in Empirum Software Management (see Software Management help). No dependencies were entered for Package Test1. Package Test1 was entered as dependency for Package Test2. Package Test1 and NOT Test2 were entered as dependencies for package Test3. Three configuration groups were c
Synchronization of OS.ini, %ComputerName>.ddc and %ComputerName%.ini files from the Empirum Server to the respective depot servers can be accelerated significantly via the depot server quick synchronization (QuickSync) feature. From Empirum 2008 upwards, the QuickSync functionality is a standard component of Empirum Sync! The following additional
Empirum Subdepot Webservice Configuration Package This software package installs and configures Windows IIS for http(s) and FTP servers. Software distribution, patch management and inventory can use the http and https protocols for data transfer. FTP is required to install the Linux operating system. If an IIS configuration exists on the server, a v
The following default filters are available in the Empirum Manager interface: PXE All computer that support the PXE booting process (network card, BIOS). Qualified Computers which have already been assigned to a group and which can be booted via PXE. Not qualified (red floppy disk symbol) Computers which have been read into the database via PXE. Act
To facilitate trouble-shooting for installations with Empirum packages and to check what exactly has failed where on the client, there is the option to write debugging information into a log file on the client with Setup.exe. To enable the writing of debug information for a package: Go to Configuration > Software Management > Depot tab to sele
How to add an operating system template to a group: Select the operating system template you want to add to a group. Drag and drop the operating system template onto the group. or Right-click the operating system template and select Copy from the popup menu. Then right-click the group and select Paste from the popup menu. The operating system templ
EmpInventory.exe [/C:ConfigurationFile.xml] [/AUT] [/D] [/DIFF][/DMI] [/E] [/F] [/G] [/L] [/M] [/N] [/NODMI] [/O:OutputFilename] /P [/R:RegistryInputFile] [/S] [/SET "Tablename","Columnname"="Value"] [/T] [/V[2]] [/WMI] [/Y:Seconds] [/ZIP] The command line parameters overrides the areas defined in the configuration. Parameter Significance /AUT Reads
In this window, you can specify when and how often you want to synchronize the directory service with the Empirum location database. Automatic Synchronization Minute-by-minute: Specifies the synchronization interval in minutes. Daily: Specifies the starting time for the daily synchronization. Weekly: Specifies the weekday for the weekly synchronizat
The assignment of language pack imports is available at Empirum v18.0 Update 2.Since Empirum v19.0, Windows 7, Windows Server 2016 and Windows Server 2019 language packs can be assigned in addition to Windows 10 language packs.The assigned language pack imports are used in WinPE-based OS deployment (from version 1.4.7) if the Matrix42 PreOS package
Filters allow you to better organize the computers and to customize their view. There are predefined default filters, but you can also configure your own custom filters.
Use this function to assign a PXE image to an existing configuration group. Empirum Interface Service: ActionType = 4, ActionCode = 10, TargetObjectType = 10 Parameter Parameter Example Variants General PXEID PXE-Images ID GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName
Use this function to set the variable values for a user. Empirum Interface Service: ActionType = 5, ActionCode = 2, TargetObjectType = 5 Parameter Parameter Example Variants General UserID {LoginName + Domain} VariableName VarMSR1 Name der Variable VariableType UserVariable Available values: ComputerVariable; OSVariable; UserVariable Sync
Database Modifications The Options table includes two new options: Option Default value Description EAI_XML_ACTIVE 0 Activate the functionality within EAI. Possible values 0=disabled 1=enabled EAI_XML_PATH Path to the files which must be read in. Default: Configurator\Log\EAI_Jobs
The data displayed in the Inventory History dialog box corresponds to the data defined under Tools > Properties > Inventory History. How to open Inventory History from Management > Administration: Click on the toolbar icon.The Inventory History dialog appears. Date: Specifies the date of the inventory. Computer: Displays the name of the co
For Empirum database roles to execute specific actions are created in Empirum DBUtil. These roles have the necessary rights to the database objects. Moreover, several database users can be specified in Empirum DBUtil. By means of the group rights, the rights for the database users and / or database roles can be defined in detail for working in Empir
Launching Software Management To go to the Empirum Software Management module, proceed as follows: Right-click a software package and select Properties… You will be guided directly to the Software Management module.You are in the Package Depot dialog box and the Package Properties dialog box for the selected software package has been opened. When yo
This chapter explains how to create an offline CD: Select the menu Tools > Create Offline CD or click the toolbar icon.The Offline CDCreation dialog box appears. Under Target directory, specify the directory where the data for the offline CD is to be stored. Click the symbol to enter a CD profile and specify a name. Target directory: Directory we
This chapter describes the general settings of the Empirum Manager interface. How to open the dialog box which lets you make the settings for Empirum Manager. Select the menu Tools > Properties... or click the toolbar icon. The Properties dialog box appears.
Computers can be imported into the Empirum database: manually via the Empirum interface, via PXE booting, by importing an external file. by distributing of the Empirum Agent by reading in Empirum Inventory data, or by synchronizing of a register service (ADS, NDS) via LDAP In order to import computers, you first have to create an Import Profile. Sta
The Alarm log file stores the database entries which were recorded when any threshold values were exceeded. These threshold values are defined via the resource monitor. They might indicate, for instance, the processor usage or the free hard disk space. Opening the Alarm Log File How to open the alarm log file: Click on the toolbar icon.The Alarm Log
Users can be created or imported with the corresponding parameters. This is how you create a new user: Right-click on Users and select New User... or right-click on a configuration and select New > New User... If a user is created via the context menu of a configuration group, then the respective new user will be assigned directly to the configur
Microsoft Reporting Services If you have decided to install the Microsoft Reporting Services, you must perform the following steps: The following points must be checked: It is necessary to consider whether Reporting Services are already installed. If Reporting Services are not installed, they must be post-installed. The description for the post-in
In order to import users, you first have to create an Import Profile. Start the Empirum Management Console (EMC), change to the Manager Module and click on Menu File > Import Users... or click on the symbol in the toolbar. Via the Open button, select the file to be imported as source. Click on the New/Edit button. Source. Here you can enter the p
Specifies the number of possible failed attempts before an installation is aborted. If Error count corresponds to max. Error count, the distribution command is removed from the *.ddc file(s). Select the menu Tools > RollOut Termination... or click the toolbar icon.The RollOut Termination dialog box appears. The software packages are displayed wit
This function allows you to delete the variable values of a system. Empirum Interface Service: ActionType = 5, ActionCode = 3, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} VariableName VarMSR1 VariableType ComputerVariable VariableValue TestWert Read
In order to import handhelds, you first have to create an Import Profile. Start the Empirum Management Console (EMC), change to the Manager Module and click on Menu File > Import Handhelds... or click on the symbol in the toolbar. Via the Open button, select the file to be imported as source. Click on the New/Edit button. Source. Here you can ent
This option can be used to reinstall an installed software package, for instance, if files that are required for this program have been deleted by mistake or are corrupt. Reinstallation can be done by selecting the respective computer or the respective software package. Go to Management > Administration and select the Computer(s) within a configu
If a specific event occurs on the Empirum server, the alarm management creates notifications. Via the configuration, you can determine which warnings are to be issued when certain critical values are exceeded. The status message of the alarm contains the following details: Empirum Alarm Manager - Action - Event Example: Betreff: Empirum Alarm Manage
There are two variants for distributing the information on the configuration of a computer (Computername.ini, Computername.ddc and OS.ini) and making it available on depot servers: Global .With global distribution of the configuration files, the configuration files are available on every depot server after the respective synchronization. The advanta
Serves to select the data for the inventory history and defines the data evaluation. If you activate all options, the server resources may be affected strongly, which may slow down database queries considerably.
You find the procedure for creating a Disk Image Class in the Empirum online help under Workplace Automation > Empirum Management Console > OS Installer > Operating System Configuration > Disk Image Class .
Delete an Object How to delete an object: Right-click the object you want to delete, and select Delete from the popup menu.If a software package has been selected to be deleted, the following query appears. If you want to delete the software from this group with all distribution commands, click Delete. If you want to set the distribution command to
Tab - Preconditions Here you can configure the conditions that the UEM Agent checks in each polling interval. If the conditions are not met, there will be no package download and therefore no installation. Tab - Already Installed Here you can configure the conditions that the UEM Agent checks in each polling interval. If the conditions are fulfilled
Use this function to specify group rights for users. Empirum Interface Service: ActionType = 3, ActionCode = 1 5, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit {GroupName} Group
Overview Proactive Device Insights includes AI-powered root cause analysis, helping IT teams identify the most likely causes of device issues and accelerate troubleshooting. Using endpoint information collected through FastViewer, Neo analyzes device telemetry, historical patterns, and available diagnostic information to generate root cause hypothes
To edit several location databases in the Management Console, you have the possibility to select the respective location databases and integrate them into the multi-site view of the Management Console. How to select additional locations from the location database (EmpLocations). Select the menu Tools > Select Locations…The Empirum Login dialog bo
The rollout coordination provides you with a complete overview of all distribution actions and their results that were started via the Matrix42 Management Console. To display the rollout coordination, proceed as follows. Click on the Rollout Coordination icon in the toolbar.The Rollout Coordination dialog appears. Profiles: A profile can be saved he
To add a new LDAP server, proceed as follows: Click the button to go to the LDAP dialog window. Enter the login information for your LDAP server. LDAP-Server: ServernameServer name or IP address of your ADS server. NetBIOS Domain (This name is used to synchronize objects. If new, it will be applied to the properties).NetBios domain name. Examples: Q
How to add a variable configuration to a group: Select the variable configuration to be added to a group. Drag and drop the variable configuration into the group.orRight-click the Configuration variable and choose Copy from the pop-up menu. Then right-click the desired group and choose Paste from the pop-up menu. The variable configuration is displa
The following basic steps are required for a successful inventory of network devices: Install the Empirum Device Discovery service via Empirum DBUtil on a server. Create a configuration. Alternatively, you may also use the supplied standard configuration; in this case, you can skip point 3. Create a job. Activate the job. Assign the configuration to
This section defines environment variables that can be used to better adapt the configuration to different environments. They can be used via %Variable%, where "Variable" stands for a real variable. These variables are used in addition to the environment variables of the system (usually set in AUTOEXEC.BAT or in the registry). If the symbol '~' is p
This function allows you to uninstall a software package from a computer. Empirum Interface Service: ActionType = 5, ActionCode = 21, TargetObjectType = 2 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explic
Double-click a computer and go to the Inventory tab. Computer Information about computer name, inventory date, MAC-address, processor (manufacturer, type, model, MHZ), memory, BIOS (date, version), display adapter (resolution, colors, frequency), operating system, IP address, host-name, DNS, DHCP, login-name, Domain, Workgroup, NDS-ID, proxy, temp-s
If you right-click on a tab, on a tab (e.g. Software), or on a software package, you can perform various other actions. Copy Preconditions / Paste Preconditions If preconditions are defined in the package conditions, they can be copied to other packages. The two options "Copy preconditions" and "Paste preconditions" are then available in the context
This function is used to deactivate a user. Empirum Interface Service: ActionType = 5, ActionCode = 30, TargetObjectType = 5 Parameter (Only for the Empirum Interface Service) Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} o
To import an existing, external Matrix42 database, please proceed as follows: If you work with more than one Empirum installation with one EmpLocations database each, and if you wish to administrate these modules centrally, you can import the distributed locations via this button into a central EmpLocations database. Subsequently, you have to import
The SNMP Walk is opened in the Administration through the context menu in the filter Miscellaneous Devices and the SNMP Walk selection. The following dialog will be displayed: OID Information. In the group field OID Information the OID and the read out value for the related object are displayed. OID. Specifies the OID (Object Identifier) whose value
The view under Locations depends on the number and the names of the databases. If only one database has been defined, the Locations section will not be displayed. Left Part of the Administration Tab On the left side of the Administration tab, all imported/created computers are indicated under the Computers group and all imported/created users are di
Creating a Search Profile Right-click a filter (e.g. Not assigned Computers) and from the context menu select Search Computer..., etc. or Right-click on Configuration groups or a single configuration group and in the context menu select Search > Computer..., etc You get to the dialog Search in Filter name, Search in Configuration groups or Search
Internet Explorer is recommended if you want to use all the available report functionality. Although you can use other browsers to view a report, Internet Explorer for Windows is the only browser that is guaranteed to support the complete set of features for working with reports.
With an Empirum OneClick Filter, filter criteria can be configured dynamically. It should be noted that only one Empirum OneClick Filter can be created per filter. The Empirum OneClick Filter is configured in the same way as a custom filter. How to configure a OneClick filter: Right-click on a computer or user under Management > Administration an
The configuration of Empirum Device Discovery can be found under the Device Discovery tabin the navigation section under Configuration > Inventory. The following screenshot shows the first view of the Empirum Device Discovery configuration: The left tree can be used to make additional settings. To do so, left-click the respective item. The tree's
There are various ways to assign software packages to the different objects in the Empirum Manager interface. Adding Software to a Group Select the software package you want to add to a group. Drag and drop the software package onto the group. or Right-click the software package, and select Copy from the pop up menu. Then right-click the group, and
This function is used to disable a system’s software. Empirum Interface Service: ActionType = 5, ActionCode = 30, TargetObjectType = 1 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explicit {GroupName} Group
Failed log-ins or similar connection problems can be found in the log files in the default directory of the reporting service under C:\..\Microsoft SQL Server\MSRSxx.InstanceName\Reporting Services\LogFiles. Error through configuration via DBUtil Problem: The following message is displayed when the reports are being configured: Unable to connect t
Including User Defined Graphics There is the possibility to customize the appearance of the Empirum Agent. If you want to change the graphics they have to be copied to the Empirum-Masterserver into the directory Empirum\Configurator\user . If required, they are synchronized to the subdepot servers. At the next start of the Empirum Agent the graphics
Defines the tabs that are shown by the software depot. Up to 100 tabs can be defined. For every tab, there is one line which defines the name of the section in this or any other file, as well as the name of the tab. The tabs will be placed from left to right according to the sequence of the definitions. <Section> = <Name> Defines a tab w
Explanation of Parameters The first 9 and the last 3 parameters of the scheduler string are always available. In between, the string structure varies, depending on the selected recurrence pattern. The first 9 parameters are explained under Start Parameters, and the three remaining standard parameters under Final Parameters. And so, a scheduler strin
Here, you may define the properties of the Empirum Sync Service (EmpSync.exe) for all tasks.
How to add a PXE boot image to a group: PXE boot images are generated via Empirum OS-Installer > Disk Configuration. Select the PXE boot image you want to add to a specific group. Drag and drop the PXE boot image onto the group. or Right-click the PXE boot image, and select Copy from the popup menu. Then right-click the group and select Paste fr
The http(s) protocol can be used to manage computers via the Internet. It is supported for software distribution, patch management and inventory tasks and is the standard protocol for the Matrix42 cloud offering. To enable computers to access the depot with the Empirum Advanced Agent via http / https, this option must be configured for these protoco
If the data of the devices of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported, and select Export to File... Specify
This window displays the defined DHCP options. After a DHCP request from a client, these variables are read out and the Matrix42 Agent writes them into the environment of the respective client. The defined DHCP options in the EPE (Empirum Preboot Environment) are also used for operating system installations. If the DHCP options have been configured
How to access a computer from remote: Before you can have remote access to a computer, you have to define the program call for remote control once under Tools > Properties... > Remote Control. You can implement further remote control solutions under Tools > Properties on the Remote Control tab. These solutions can be distinguished by the na
Version 26.2 List of database changes Matrix42 Enterprise 26.2.x, including all updates. Release 26.2.0.1501 (05.11.2026) Added Tables Table Column PLBEActivationClassContinuations ActivationExecutionId ActivationState Continuations ContinuationsQueuedAt ID LastUpdated ProcessObjectId TimeStamp Changed Columns Table Column Change SPSUserClassBase Ac
Version 26.2 List of solved problems and minor improvements for Matrix42 Enterprise 26.2.x, including all updates. Release 26.2.0.1501 ( 05.11.2026) Problem ID Description MXC00091 License Management MXC00093 License Requirement Creation about Classification of Fingerprint can fail due to other Processes MXC00105 After 26.1 update, the "SYS
Displaying/Changing the Properties How to display the properties of a software package, or change them directly: Right-click a software package (e.g., Adobe Acrobat_Reader), and select Properties... from the popup menu.You are automatically led to Software Management > Depot tab, the Package Properties dialog appears. This dialog box displays the
This is how you search in configuration groups for computers, users, software, software classes, configuration groups, operating system templates or PXE templates: Activating one or several configuration groups with assigned computers and PXE images can take very much time! You get a note with warning if more than an object is concerned.Software pac
How to define the distribution option for the selected software package: Right-click the software package whose distribution options you want to configure and select Distribution Commands... from the popup menu. Select the desired parameters and confirm your settings with OK. Scheduling: Opens the Scheduler dialog box.Use the scheduler to define the
How to add a synch template to a group: Select the Sync Template you want to add to a group. Drag and drop the Sync Template onto the group. or Right-click the Sync Template and select Copy from the popup menu. Then right-click the group and select Paste from the popup menu. The Sync Template is displayed in the selected group. Example: The Sync Te
This function allows you to activate the operating system of a configuration group. Empirum Interface Service: ActionType = 4, ActionCode = 20, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or
In order to import devices, you first have to create an Import Profile. Start the Empirum Management Console (EMC), change to the Manager Module and click on Menu File > Import Devices... or click on the symbol in the toolbar. Via the Open button, select the file to be imported as source. Click on the New/Edit button. Source. Here you can enter t
The Advanced Agent consists of client and server components, described in this article. ERIS (Empirum Remote Installation Service) ERIS is the central computer component. It runs as a service (LocalSystem) on the computer and communicates with the transport, setup and ERIS_UI. ERIS analyzes installation information (DDC and DDS) and sets up installa
To use the UEM Depot Monitor, the Empirum ServiceBus service must be installed and configured.The new "Depot Sync" area is only displayed if you have the "EMP_M_ADMIN" role or higher. In the view Depot Sync there are two registers: Sync Job Status and Depot Server Status Sync Job Status This tab displays a filterable list of sync jobs configured as
This function allows you to active the software of a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 20, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an explic
1. Groups a Group must be empty to be deleted. 2. Clients a Moving allowed: If the group with the computer is empty. b Moving allowed: If the elements of the group with the computer are also contained in the superordinated group, software / software classes with the same distribution options are existing, PXE images and OS templates are the same. 3.
The Empirum Agent - ERIS (Empirum Remote Installation Service) - is the frontend that performs all tasks of the Matrix42 Management Console on the client, i.e., installation, uninstallation, reinstallation tasks and queries (e.g., push). Once the new Empirum Agent has been configured completely (configuration group assigned, Variables filled, templa
Here, you can configure the log file for Empirum Sync. In this file, all commands and actions are stored. Maximum Report Size. Allows you to specify the maximum size of the log file. Report Wrapping Overwrite events as needed. The oldest entries will be overwritten if the maximum log file size is reached. Do not overwrite events. If the maximum log
This function is used to activate the software assigned to a system. Empirum Interface Service: ActionType = 5, ActionCode = 20, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {G
Preboot Execution Environment (PXE), is integrated in the BIOS of many new PCs equipped with a "LAN-On-Motherboard", and makes it possible to install computers via the network. After a reboot (First Boot via LAN has to be enabled), the MAC address of a PXE-capable computer is entered into the Empirum PRO database. In this state, the computer is not
Allows users to start systems via the LAN and initiate reboots or shutdowns. For instance, this makes it possible to restart running systems to enforce operating system reinstallations directly or at a defined date/time. It is also possible to control the reboot behavior during package installations by using the parameter /RB for the software depot
Sets up a link to maximally 20 several external tools. The icon lets you select the corresponding file directly from the directory structure. Name. Name of the external tool. This name is displayed in the context menu. Path to the program. Allows you to specify the path to the executable file of the desired external tool. Global Setting (All Users).
Updating the FastViewer OnPremise Server to Version 5.x from Versions Prior to 5.x Prerequisites The FastViewer Server 5.x is now based on .NET 10. Before updating the server, install the following Microsoft runtimes: Desktop Runtime (.NET 10) ASP.NET Core Runtime (.NET 10) Both packages must be installed before starting the updated server; otherwis
It is not mandatory to assign the Empirum Server to a configuration group. The variables for the Empirum Agent can also be entered directly under the Empirum Server filter. Launch the Matrix42 Management Console, go to Management > Administration in the navigation pane (after a restart, this window is opened directly).Create two additional config
General settings Use DHCP Options. Enables the DHCP options defined on a DHCP server. After a DHCP request of the client, these options are scanned and written into the environment of the respective client by the Empirum Agent. Depending on the location, these variables can be used individually for distributing software packages. See also DHCP Optio
Select the desired options under Properties and User Installation Request Interface. The Empirum Agent template configuration is now complete. Click WTS/Citrix XenApp if you want to use this template on a Citrix server. Click File > Save in the Matrix42 Management Console or click the Save icon in the toolbar. Properties. These settings refer to
The new Empirum Agent has been specifically adapted to provide the complete functionality under Microsoft Vista and is a combination of the previous Empirum Agent and the Mobile Agent. Use the Windows and the Mac OS X icons to specify whether this configuration shall be used for Windows, for Max OS X or for both operating system variants. To configu
Enter the general job settings: Name (mandatory). Enter a unique name for the job, e.g., Training. Description. In the Description field, you may enter a short overview for the user to better distinguish individual jobs. Included IP Addresses. Specify the IP subnetworks, IP domains or individual IP addresses to be inventoried, separated with commas.
The Save Configuration dialog will be displayed. Enter a name for the Agent template and click Save. Go to Management > Administration in the navigation pane. The new template is now displayed under Agent Templates in the right window.
This function is used to create a new system in the database; it “inherits” all basic properties from an existing system. The new computer name, combined with the new domain or workgroup, must be unique and not allocated to another system. Empirum Interface Service: ActionType = 1, ActionCode = 1, TargetObjectType = 1 Parameter Parameter Exampel Var
Define the polling interval, i.e., how often a check for installation jobs should be performed each day. Define the parameters that are relevant for each polling interval. Polling Settings During each run, the new Empirum Agent is launched with three different calls. The first call is always done with the /WU parameter to delete existing user-specif
The Depot Helper Service is also installed with the Activation Service. More information about this service can be found here. The Empirum-Activation service reads settings for activating computers, users and software packages from the database and writes them into the *.ddc, *.dds, OS.ini- <Username>.ini or <Computername>.ini file. Vari
Empirum offers various functions that are delivered through a WWW or FTP server, including the following: Subdepot (through web access); Software installations on SuSE Linux Enterprise and RedHat Enterprise Linux. Empirum allows for automatic configuration and installation via the Empirum Subdepot software package. If your want to use the Internet I
In order to prevent each user from configuring the Audit or viewing the logged actions, there are two different roles, to which a user can be assigned: EMP_M_AUDIT. Can view the data of the Audit. EMP_M_AUDIT_ADMIN. Can view the Audit data and configure the Audit. The role EMP_M_ADMIN contains the permissions of the role EMP_M_AUDIT_ADMIN. Thus, all
Right-click Empirum-DeviceDiscovery in the left directory tree and select Add from the context menu. Click Install in the right window to install the Empirum Device Discovery service on a server. Now you can enter your settings for the new service in the Empirum-DeviceDiscovery tab: Server Name: Enter the name of the server where the service shall
You must perform the following steps to be able to use Empirum-PatchManagement: Enter the respective license key under Licensing. Install the Empirum Activation Service. You can only see Empirum-PatchManagement and configure it accordingly when these two steps have been completed. The Patch Management service is not a separate service. It is a plug-
The Empirum-Inventory service reads the files saved under Directory of data files, which have been created via the Matrix42 Inventory and writes the Inventory configuration files under Directory of configuration files. Directory of Data Files Serves to specifying the folder, in which the files created by the Matrix42 Inventory are to be saved.You ca
This is how you export data from the Audit into a file: Right-click on an action, module, computer or single data sets, and select Export from the context menu. Select the menu Data > Export, for being able to export all data from the Audit.You get to the Export to File dialog. Enter the path and the name of the target file.The file format .csv i
The global settings for the import of Empirum Inventory data are made in the Empirum DBUtil module. Per default, the Empirum Inventory data are always applied. If, for example, ever has been configured for merging the Empirum Inventory data, you can disable this setting for the selected computer by proceeding as follows: Right-click the computer who
When deleting selected data records, please note that although the data has been deleted in the interface, the cumulative values of the data records are still available.So if you want to evaluate the data records for a specific period, you must first delete all the data for this data record and then collect the data for this period in order to be ab
To configure the Empirum Depot Server: Install the Empirum Agent on the server that shall act as an Empirum Depot Server (in this example the computer (PEG-REF-M5) the Empirum Agent. Create a configuration group below Training, e.g., DepotServer. Drag the computer to act as an Empirum Depot Server (PEG-REF-M5) into the configuration group you have j
If the specified registry key or value is found, then the application shows up under Software in the Inventory. Value. Registry key or value. Example: HKLM,Software\Microsoft\DataAccess,FullInstallVer=2.70.9001.0 Developer. Software developer. Example: Microsoft Corporation Application name. Software name. Example: Microsoft Data Access Components V
If you select the CD_BOOTDISK installation type, the Operating System dialog box will be displayed in addition to the dialog boxes described in section Creating an Installation Disk. In the navigation bar switch to Configuration > OS Installer >Boot Disk > Disk Configuration. Make the general settings. Select the operating system on the lef
How to activate a group: Right-click the computer you want to activate, and select Activate from the popup menu.The Activate dialog box appears. Software/Operating System PULL via DDS/DDC (Software packages only). All entries in the installation file SwDepot.ddc will be applied to the assigned software. If you have selected several DDC files for the
Besides computers and handhelds, all other devices (assets) that cannot be administered with Empirum can be managed with Empirum Inventory. In order to do that, freely definable device categories, as for instance Beamers or Routers can be added and the devices can be grouped under them. Change icon... Here you can set any icon for a device type from
This function is used to disable a system’s software and operating system. Empirum Interface Service: ActionType = 6, ActionCode = 30, TargetObjectType = 1 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an expli
By providing fixed parameters for specified applications, this application will only run with the specified parameters. This is done to close a potential security hole. For instance, the setup client (SetupCli.exe) is used to call any command via the setup service (SetupSvc.exe), which is only required if, for example, you want to execute a certain
All context menus in the Inventory tab are described. Delete. Deletes the selected objects from the database. Remote Control. Opens a Remote Control for the selected computer. External Tools. Opens an external program for the selected object. Apply Inventory. If for applying the Inventory data, Only for new computers or Never was defined in DBUtil,
This function can be used to delete a system completely from the database. Empirum Interface Service: ActionType = 2, ActionCode = 0, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)}or{ClientName + MACAddress}or{MACAddress } The ClientID is handed over directly or can
All network devices detected through Empirum Device Discovery appear in the left directory tree under Miscellaneous Devices: Double-click an unknown device to open the Properties for Device window. It is possible to move discovered computers to the group Computer for further management. Therefore do a right mouse click on the device and choose Apply
The task assigned via the Empirum Management Console is displayed in the window of the Empirum Sync Configurator and is activated by default. The file Sync Configurator.exe is located in the directory %ProgramFilesDir%\Empirum\Empsync. Go to Start > Programs > Empirum > Tools > Sync Configurator to start the Empirum Sync Configurator. En
The Empirum Sync templates can be used to synchronize data (Empirum packages, source files for Empirum Installer, etc.) on one ore several locations. Any accessible (network) directory can serve as source and destination. For instance, the central Empirum software depot can be synchronized automatically to other locations, independent of the respect
General Information on the AES256 encryption Starting with version 16.1 Empirum provides the option to use a more secure password variant for authentication between the Empirum Agent and Empirum servers or between an Empirum depot server and the master server. This new encryption is supplied for Empirum usage only to prevent that the decryption mech
In this tab, you may assign attributes or default values from the directory service (ADS or NDS) to the variables of the Matrix42 location database. Synchronization is done with the Empirum LDAPSync service. Explanations of the directory attributes can, for instance, be found on the Microsoft MSDN page. Adds the marked directory attribute in the rig
The employees responsible for the Software distribution often do not know exactly which software depends on another software. This is why errors are only recognized if error messages are returned from the client (Requirement Error). In order to prevent that, a check during the activation will inform the console user, whether the configuration group
The Empirum SWDepotLog service reads in the files stored under Directory, thus providing a real-time overview or report of the current state of the software distribution. Directory Serves to specify the directory in which the SWDepot.log file is stored. Polling Interval Serves to specify the interval (in seconds) between the checks of the Empirum SW
Navigation Bar How to show or hide the navigation bar: Select the View > Navigation Bar menu. If the navigation bar is currently shown, it will be hidden and vice versa. Status Bar How to show or hide the status bar: Select the View > Status Bar menu. If the status bar is currently shown, it will be hidden and vice versa. Users How to display
The Driver Assistant allows you to edit the driver control file of the WinPE based operating system distribution. Driver folders or driver files for a Windows operating system can be selected. For more information on how to use the Driver Wizard, click here. Requirements Empirum Unified Endpoint Management (v21.0.2 or higher). Empirum WinPE PreBoot
Release 26.2.1501 (05.11.2026) ID Description 606716 When updating category, if role changes and a suitable ola exists, the ola field will not be displayed immediately. To make it visible, set again the "Responsible role" parameter to its existing value 606881 Very sporadic, SLA field is displayed as an empty string, refreshing / restartin
If Matrix42 DBUtil has created the location database with Windows authentication (ADS), it is possible to log onto the location database directly with the log-on information of the logged-on user. Windows authentication can only be used if your company uses the Active Directory Services (ADS) by Microsoft for user authentication! Under Linux, Window
The Configuration assignment item in the directory tree allows you to assign configurations to installed servers. Right-click the server and select Assign Configuration. Alternatively, you may double-click the server to open a window with all existing configurations: Select the required configuration and click OK to confirm and complete the assignme
Allows you to specify the paths to the individual programs and files, which are to be launched from the Empirum Manager interface. Make sure to use UNC paths. The icon lets you select the corresponding file directly from the directory structure. If the paths to the files have not been specified, they cannot be imported or the settings you have defin
This service is the external communication interface to other applications, e.g. the Matrix42 Service Store (starting from version 8.0) or the Matrix42 Empirum SDK. A user configured in the Service Store must belong to the role EMP_SERVICES on the Matrix42 location. Protocols HTTP Connection Default port: 9200 Encrypted by certificate (https)Select
Empirum Software Management helps you to adapt, distribute, and install software on Windows 32-bit and 64-bit platforms (Windows 2000, Windows XP, Windows Vista, Windows 7, Windows Server 2003 and Windows Server 2008). The data for Empirum Software Management are administrated in the corresponding location database. Software adaptation means the sim
Navigation Bar. Opens or closes the Management / Configuration navigation bar. Status Bar. The status bar is displayed on the lower margin of the Matrix42 Management Console. To view or hide the status bar, select the View > Status Bar menu. While you move through the menus with the help of the ARROW KEYS, the left part of the status bar describe
Enter the database user name (e.g., "sa"). Enter the password of this database user. Confirm with OK. Database Username Name of the database user to log into the database server (e.g., "sa"). Password Individual character string to identify the user name.
Matrix42 OS Installer is an application which allows for the complete customizing and automatic installation of the operating Windows XP, Windows Vista, Windows 7, Windows 8, Windows 8.1 Update 1, Windows 10, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2 and Windows Server 2016. The
You have to log on to the Internet server specifying your user name and password in the Login dialog box. Type in your user name and password and confirm your entries. If you leave the fields empty, you will be logged on as an anonymous user with the username "anonymous". You might then have fewer rights than with your own user name, however.
The assignment of operating system imports is available at Empirum v18.0 Update 2.Since Empirum v19.0, Windows 7, Windows Server 2016 and Windows Server 2019 can be assigned in addition to Windows 10.The assigned operating system imports are used in WinPE-based OS deployment (from version 1.4.5). If an EmpirumPE-based deployment is performed, the op
The installation of Empirum Software Management also comprehends an example Software Depot. It can be launched via Start > Programs > Empirum > Tools > Software Depot. To display the standard packages in the software depot, at least the Empirum Activation service must be installed.
The Audit window is divided into two areas. In the tree on the left side you can select modules, individual actions of a module, computers and users can be selected: Actions which are to be logged are displayed in the tree with the symbol , actions which are not to be logged are marked with the symbol. Empirum Management Console, Management, Softwar
The UEM Agent Windows is based on the Advanced Agent. It is planned to change some functions in the future or to implement new functions only there and to develop the UEM Agent as the sole Software Management agent. The Advanced Agent will continue to be supported until further notice. In the future, only bug fixes and, if necessary, adjustments to
By modifying the file SwDepot.dds or the file you pass to the software depot as a parameter, you can customize the contents of the tabs during the software installation. You can define up to 100 tabs. This Properties dialog box defines the version, the layout, and the installation parameters of the software of the software depot. For descriptions of
Control via NTFS Rights on the Package Level Please disable this option if you do NOT want to control package visibility via NTFS rights!If no user is logged in, assigned and activated software packages are always installed! To control software package visibility in the kiosk via NTFS permissions, the "UseExecuteRight" option in the depot properties
Release date: 14.09.2026 Improvements Extended the login response to include directory-specific permissions and entraObjectId, removing the need for an additional user information request. Improved folder deletion feedback by informing users when a folder cannot be deleted because it still contains files or subfolders. Bug Fixes Fixed a memory leak
If you want to reinstall one or several assigned software package(s) for a computer: right-click the computer and select Reinstallation.The Activate wizard appears. Under Activation type, you can select the type of reinstallation. Select if the selected software package(s) shall be uninstalled prior to reinstallation. The following settings can be
The creation, displaying and editing of the variables takes place in an own window starting with this version, and no longer as before, under Menu Extras > Settings. There basically is a distinction between "Create Variables" and "Display and Edit Variables". New variables can be created, existing variables can be modified or deleted (variable de
Computers can be created individually with the corresponding parameters or they can be imported into the Empirum database. This is how you create a new computer: Select the menYou can create computers individually with the corresponding parameters or import themu File > New Computer... or Right-click on Computers, one of the filters (e.g. Unassig
Allows you to change the service server password for the selected database user of the selected location. Select Actions > Install/Configure Services... Right-click on a service and select Change password of service server from the pop-up menu that appears. Select the Database user name for which you want to change the password. Enter the passwor
If you want to reinstall a software package: right-click the software package and select Reinstallation.The Activate wizard appears. Under Activation type, you can select the type of reinstallation. Select if the selected software package shall be uninstalled prior to reinstallation. The following settings can be configured: Postpone (n times) Igno
This is how you search in a filter for computers, users, handhelds and other unmanaged devices: Right-click on one of the filters (e.g. Unmanaged computers or All devices) and in the context menu select Search computer..., Search user..., Search handhelds... respectively Search device... or Search profile > Name of the saved search profile.You ge
The following settings must be specified on a computer to be able to successfully distribute the Empirum Agent: The following services must have been launched on the computer: Login service Remote procedure call (RPC) Remote registration service Server The following shared permissions must be available on the computer: IPC$ Admin$ The specified user
If the data of the computers of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported, and select Export to File... Speci
In the past, it was possible to transfer software to locations, only to approved depots, for instance, to provide customer- or language-specific packages. Now, it is also possible to use DDS Compare to selectively transfer packages to depot servers without the need to synchronize the whole structure. This facilitates the connection of remote locatio
In order to view the current status of the activated group with the belonging objects, proceed as follows. Right-click the group, and select Show Status... from the pop up menu.The Status for Group: <Group name> dialog box appears. Computers Tab Shows the current status of the activated group with the objects assigned to the group. On the righ
How to add a software class to a group: Select the software class you want to add to a group. Drag and drop the software class onto the group. or Right-click the software class and select Copy from the pop up menu. T hen right-click the group and select Paste from the pop up menu. The software class is displayed in the selected group. Example: The s
The View menu contains the following commands: Navigation Bar. Shows or hides the leftmost window (Management, Configuration, Locations, each with suboptions). Status Bar. Shows or hides the status bar.Use this command to show or hide the status bar, which describes the action performed by the selected menu entry or a pressed button of the icon bar,
The search in the Empirum Management Console is based on SQL Queries. These SQL queries can be edited, and customized to fit your necessities. Thus, SQL queries which cannot be created via the search dialog are also possible. This is how you edit an SQL query: Right-click on a filter (e.g. Unassigned Computers or All Devices) and in the context menu
Overview The Gallery component provides a modern, interactive way to display and explore multiple images within a Matrix42 Enterprise application, instead of only a single image. The Gallery displays a primary image with thumbnail navigation, letting you switch between images instantly without leaving the current page. You can also open an image in
Unnecessary redundancies may occur through multiple assignments within the assignment groups, additional assignments within the software groups or through external interfaces. The Redundancies menu option (right-click on an assignment group > Expert > Redundancies) allows you to ensure that the assignment groups are reorganized in an optimum w
Several tasks in Empirum are now executed via PowerShell or other APIs on various third-party systems such as XenDesktop or a hypervisor. If this option is enabled, the user can view which tasks are in the queue or have already been executed; this monitoring process can also be used for trouble-shooting purposes. Back end activation task queue: This
Overview Recents provides quick access to recently viewed records across Matrix42 Enterprise applications, helping users navigate between objects, continue previous activities, and work more efficiently without losing context. Whether you are working with tickets, service requests, knowledge base articles, or configuration records, Recents allows yo
Overview The Execute AI Function activity lets you call a configured Native AI Function directly from a Workflow Studio (XAML) workflow. Administrators and workflow designers can pass input parameters to the AI Function and retrieve its generated results for use later in the same workflow, without migrating the workflow to Workflow Designer. For exa
Overview Matrix42 Enterprise supports MCP (Model Context Protocol), enabling secure integration with external AI agents and MCP-compatible tools. The MCP for Enterprise Platform extension allows organizations to expose Matrix42 Enterprise platform capabilities as governed MCP tools, enabling external AI assistants and automation solutions to interac
Overview Neo can explain an existing workflow in natural language, turning complex automation logic into a clear, structured description. This makes it easier to understand inherited or complex workflows, troubleshoot automation logic, onboard new team members, and review business processes before making changes. Neo analyzes the actual workflow con
Use this function to delete an assigned PXE image of an existing configuration group from this group. Empirum Interface Service: ActionType = 4, ActionCode = 11, TargetObjectType = 10 Parameter Parameter Example Variants General PXEID PXE-Images ID GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName +
The following sections will explain how to edit groups. Adding Computers How to add a computer to a group: Select the computer you want to add to a group. Drag and drop the computer onto the group. or Right-click the computer, and select Copy from the pop-up menu. Then right-click the group and select Paste from the pop-up menu. The computer is dis
Here, you can specify where the data for the OS.INI file (IP Configuration and Domain/Workgroup) will be applied. OS Template. The hardware configuration for the OS.ini file is taken over from the OS template. Computer properties. The hardware configuration for the OS.ini file is taken over from the computer properties. Apply additional hardware inf
Allows you to define additional fields to extend the description of the computer hardware configuration. This data can either be entered manually or imported from a file (see also EMC > Properties > OS.INI > Apply additional hardware information. If values have been defined for a computer, this additional information is also written to the
The Empirum-WakeOnLan service allows the starting of Matrix42 clients with a delay which can be set. Simultaneous Wake Up Burst Amount: Defines how many clients can be started ("woken up") by the Empirum-WakeOnLan service. The number "0" is for an unlimited number of clients. Delay: Defines the delay in milliseconds between the startup ("Wake up") o
Use this function to delete all assigned Empirum server from a client. Empirum Interface Service: ActionType = 6, ActionCode = 83, TargetObjectType = 11 Parameter Parameter Example Variants General ClientID {InventoryID} or{ClientName + (Domain / Workgroup)} Name of the computer Read also: Examples of How a Job is Created Variants
Click Properties in the context menu of the subgroup of the configuration groups. The window Properties for Group: <Name> will be displayed. Use the Self Provisioning tab to edit various self-provisioning properties. General tab: General informations were displayed, such as for example Name or Description of the group. Self Provisioning tab Ac
Overview Proactive Device Insights uses endpoint information collected through FastViewer, analyzed by Neo, to identify device problems before they disrupt an employee's work. Instead of waiting for a support ticket, Matrix42 Enterprise detects patterns such as low disk space, unstable services, slower startup times, recurring crashes, or memory
Use this function to reinstall several software packages or software classes on several existing systems of a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 23, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupNa
The Depot Tab Tree View: In the tree view on the left-hand side, all packages are displayed. The packages are administrated in categories which are shown as tabs in the Software Depot application. In addition to the packages, properties of the Software Depot as well as the environment variables are shown. The object Properties defines the standard p
User properties can be modified later on. How to edit the user properties: Select the user whose properties you want to edit. Right-click the selected user and select Properties... from the popup menu. The Properties for Users: <User Name>dialog box appears.Description of the user data The General tab. Shows the current data of the user. Ide
This function allows you to delete a PM group or a PM test group from a configuration or assignment group. The subordinated test group must be removed before you can delete a PM group! Empirum Interface Service: ActionType = 5, ActionCode = 11, TargetObjectType = 15 Parameter Parameter Example Variants General PMGroupID 15 {PMGroupName + PMGroupType
If the data of the handhelds of this location (filter) have to be available to other locations, you can export them. This is how you export the data of a filter to a file: Start the Empirum Management Console (EMC), change to the Manager Module and right-click on the filter from which the files have to be exported and select Export to File... Specif
The assignment group Service Management shows which software has been assigned via Empirum and which one via Matrix42 Service Management. If, for instance, software such as Irfanview or 7-Zip is "shopped" via Matrix42 Service Management, it is displayed in the Single Assignments group. This new functionality provides the following benefits: Transpar
A package is assigned an internal ID when it is saved for the first time; this ID is necessary to define sequences and dependencies. By default, installation starts with the software packages of the first tab from above in the software depot; the software packages in this tab are installed, starting with the top package, then the software packages o
Use this function to create a new client in the database, which is not assigned to a configuration group. Empirum Interface Service: ActionType=1, ActionCode=0, TargetObjectType=1 Parameter Parameter Example Variants General ClientName TestClient01 Max. 40 characters Domain / Workgroup TestDomain Specification of the domain or workgroup domain:
Database users assigned to the role EMP_M_AUDIT_ADMIN can set the log behavior of the Audit. In order to do that, you can select from the categories All, Default, Critical and None, which log a various number of actions. Actions which are logged are marked in the tree with the symbol , actions which are not logged are marked with the symbol . Select
To launch the Empirum Personal Backup program, proceed as follows: Click in the navigation pane to Configuration > Personal Backup in the Empirum Management Console.The Empirum Personal Backup interface appears. A PBU file to be opened can be specified under Management > Administration >Extras > Properties > Path to files, behind Path
Overview Instead of manually configuring a reporting widget, you can describe what you want to see in natural language, and Neo creates the corresponding visualization directly in the Reporting Toolkit. Neo interprets your request, identifies the relevant business objects, metrics, time periods, and grouping options, and generates a suitable chart o
General Information on Certificate-Based Authentication in Empirum As an alternative to log-in with user name and password, the Advanced Agent can also perform a certificate-based authentication. Specific infrastructure and configuration settings are required to be able to use this authentication method. Authentication via client certificates provid
When launched, the following parameters can be specified (applies for the Empirum Legacy Agent): SwDepot.exe [File [/A] [/B[R]] [/C Sec] [/E] [/F] [/G] [/I File] [/K Sec[, Polling interval]] [/L Drive] [/M] [/N] [/O] [/P Password] [/Q[R]] [/R Directory] [/RB time until reboot, Time between alerts] [/S Flags] [/T Level] [/U Username] [/V] [/W[U]] [/X
Overview A complete audit trail is available for how Neo Agentic Assistant selects and executes tools. The audit supports operational troubleshooting, security reviews, compliance requirements, and consumption analysis. Audit Information Each recorded audit entry includes: User and channel. Selected tool and its source. Applied configuration and con
The detailed SetupErrorLog file provides the following information: the error messages on the client during an installation, the actions performed by the user on the client, and the explicit abort within a Setup.inf. You can find the SetupErrorLog files on your hard disk under:Drive\Empirum\Configurator\Log\SetupErrorLog How to display the detailed
To go to the Empirum OS-Installer module, proceed as follows: Right-click on an operating system template and select Properties… You will be automatically guided to the OS-Installer module.You are now in the Operating System Configuration tab, and the selected operating system template is displayed in the respective operating system tab. When you ha
Use this function to reinstall several software packages or software classes on several existing systems of a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 22, TargetObjectType = 2 Parameter Parameter Example Variants General ClientID {Client} or{Clientname/Domain} SoftwareID Either a software package or a whol
Overview The Insights application provides Service Desk agents and IT teams with a centralized workspace to review AI-generated insights, investigate device problems, and take action on recommendations from Neo. The application brings together Proactive Device Insights, Major Incident Proposals, Knowledge Base Gap Proposals, AI-Assisted Tickets, and
Release date: 10.09.2026 Important Information The parameters for agent installation have been updated as follows: “/folder=first folder\second folder\and another subfolder” The folder(s) will be created if they do not already exist. The remote client is registered within this specified folder. Important: the entire parameter must be enclosed in quo
Overview Instead of manually configuring every workflow step, you can describe the business process you want to automate in natural language. Neo translates these requirements into a fully editable workflow, including triggers, actions, conditions, branching logic, and connections between workflow steps. Neo understands the context of Matrix42 Enter
If the ADS authentication (Windows authentication) has to be set up, the following settings have to be performed first. A user that is set up through this procedure, is used to create the Empirum databases (location, tables, procedures, and triggers). Domain Controller Create a user in the ADS, via which you wish to log on to Matrix42 DBUtil or to t
Overview Instead of manually analyzing charts, KPIs, and complex datasets, you can ask Neo to explain a report you are viewing, highlight the most important findings, or identify a trend that needs attention. Neo understands the context of the report you are viewing, including its configuration, filters, metrics, and the actual underlying data. Rath
To modify the roles (Rights) for multiple user, proceed as follows: Select the Actions > User Management... menu. Go to the Roles tab. Click Edit in the Roles tab. Each user is a user in the database and can belong to one or more roles. Under Users in this role, select the user to whom the role is to be added and confirm with OK. This dialog box
Besides computers and handhelds, all other devices (assets), which cannot be be administered with Empirum, can be managed with Empirum Inventory. In order to do that, freely definable device categories, as for instance Beamers or Routers can be added and the devices can be grouped under them.
Displays information on the current version.
All jobs that shall be processed via the Empirum Interface Service must be entered into the table EmpTaskQueue. All mandatory fields must be set to execute a job. The following table elements are available: Name Description/Value Typ ID Unique ID for the job E ID_EmpExtSubscribers Foreign key of the external system from the EmpExtSubscribers table t
Use this function to delete an assigned software class from a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 11, TargetObjectType = 8 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or
Writes/updates PXE boot images, index files, and disk and operating system configurations from the database to the storage medium. Download of the index files and drivers from the Matrix42 FTP server or other sources to the local storage medium. Serves to specify the sources from which the drivers are to be downloaded in the Empirum OS Installer. Wh
To create a new database user, proceed as follows: Select Actions > User management…The User Management dialog box appears: Click New.The Add new user dialog box appears. Under Password and Retype password, enter the password for the database user to be created. Confirm your settings with OK. Username: Name of the database user to be created Role
ClientID Variants Variant InventoryID Parameter Parameter Example General InventoryID 102 <member><name>InventoryID</name> <value><string>102</string></value> </member> Variant ClientName + Domain/Workgroup Parameter Parameter Example General ClientName PC01 Domain/Workgroup ISM_NT <member>
This function is used to deactivate all systems of a configuration group, including the assigned operating system and software. Empirum Interface Service: ActionType = 6, ActionCode = 30, TargetObjectType = 3 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName
How to Contact Customer Support When you're facing an issue, our Support team is here to ensure you always feel supported. This page explains how to contact our Customer Support, how to submit tickets effectively, and what to expect during the support process. How to contact Customer Support Contact Detail Support Portal Primary Contact Channel: h
This function is used to activate the operating system and the software assigned to a computer. Empirum Interface Service: ActionType = 6, ActionCode = 20, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {
This function is used to assigned a software package to an existing system and then activate this package. To do so, you must create a new configuration group, which is assigned the specified group name or a name made up by "Domain\ComputerName". Empirum Interface Service: ActionType = 5, ActionCode = 58, TargetObjectType = 2 Parameter Parameter Exa
Use this function to delete an assigned Empirum server from a client. Empirum Interface Service: ActionType = 6, ActionCode = 80, TargetObjectType = 11 Parameter Parameter Example Variants General ClientName Name of the computer ClientDomain Name of the domain of the computer ServerName Name of the subdepot server ServerDomain Name o
Use this function to set the variable values for a system. Empirum Interface Service: ActionType = 5, ActionCode = 2, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 110 {InventoryID} or{ClientName + (Domain / Workgroup)} VariableName VarMSR1 Name of the variable VariableType ComputerVariable Available values: Comp
This function is used to assign a software class to a configuration group. Empirum Interface Service: ActionType = 5, ActionCode = 10, TargetObjectType = 8 Parameter Parameter Example Variants General GroupID 7e573d80-1400-49f4-8bb1-5ba021d0a9cc {GroupPath} or {GroupName + ParentID} or {GroupName + ParentPath} or {GroupName + ParentName} or an expli
Serves to defining the values of variables which are required for the configuration of the software distribution, operating system installation or Empirum Sync Configuration. The values for the Variables can be entered via an XML or CSV file. If you import values for variables, the manual entries are overwritten with the imported variable values. Th
Variable values can also be imported via a CSV file. During repeated import, the existing values of the affected variables are overwritten. In order to import variable values, proceed as follows: Start the Empirum Management Console (EMC), change in the navigation pane to Management > Administration and select File Menu > Import Variable... or
Use this function to assign an existing system to an existing configuration group and activate the assigned software. Empirum Interface Service: ActionType = 5, ActionCode = 55, TargetObjectType = 1 Parameter Parameter Example Variants General ClientID 102 {InventoryID} or{ClientName + (Domain / Workgroup)} GroupID 7e573d80-1400-49f4-8bb1-5ba021d
If you have created a structure as described under User-Defined Control Element and have activated the option Collection (checkbox ticked) you can assign this collection repeatedly to an object. Assigning Collection to an object, e.g. a configuration group: Start the Empirum Management Console (EMC), change in the navigation pane to Management >
A user-defined Control element can be explained as a number of simple variable definitions (structure). This structure can be assigned to a configuration group, a computer or a user. This is how you create a structure: Start the Empirum Management Console (EMC), change in the navigation pane to Management > Administration and select Menu Extras &
In order to edit an existing variable definition, proceed as follows: Start the Empirum Management Console (EMC), change in the navigation pane to Management > Administration and select in the Extras Menu > Variable Definitions..., or click on the Define Variables icon on the toolbar.You get to the Variable Definitions dialog window. Select th
The Variable Definitions dialog serves to the creation of new variable definitions, or to modifying or deleting existing variable definitions. The entries in the window on the left are filters for various views of the variables. Depending on which filter you click in the window on the left, the corresponding variables of the filter are displayed on
Here you can set a value for the selected variable. You get to this dialog window via the Variables dialog window. Depending on the set Control element set during the Variable definition, several Values are shown here. Name. Specifies the name of the selected variable. This name can be set via the Variable Definition. Description. Gives a short desc
In order to create a new variable definition, proceed as follows: Start the Empirum Management Console (EMC), change in the navigation pane to Management > Administration and select in the Tools Menu > Variable Definitions..., or click on the Define Variables icon in the task bar. Click on the Add button.You get to the Variable Definition dial
Variable definitions can only be imported or exported in the XML format. In order to import a variable definition, proceed as follows: Start the Empirum Management Console (EMC), change in the navigation pane to Management > Administration and select Menu Extras > Variable definitions... or click on the Define Variables... icon in the toolbar.
Function Empirum Interface Service Description ActivateClient_OS This function is used to activate the operating system assigned to a computer ActivateClient_SW This function is used to activate the software assigned to a system ActivateClient_SWOS This function is used to activate the operating system and the software assigned to a computer A
With this dialog you may enter a new license key. This action might be necessary if all databases are set up anew or if new licenses have been purchased. Enter your company and the license key provided by Matrix42 GmbH and click OK. Company: Name of your company. License Key: Field to enter the license key provided by Matrix42 GmbH in the following