Skip to main content
Matrix42 Self-Service Help Center

Tips and Troubleshooting

If the Software Kiosk or Installation UI cannot be displayed

The new user dialogs are based on a locally executed web page that is displayed with an embedded chrome browser. To do this, it is necessary to set the Internet properties so that no proxy is used locally, and the local computer is classified as secure. In addition, the "localhost" should not be part of the trusted site list. Use GPOs to ensure this for all computers.

Anti Virus Programs

Some antivirus programs prevent the installation or execution of the UEM Agent. Please use the AV options to exclude the"%Program Files%\Matrix42\UniversalAgent Framework" directory.

How to use the global silent switch

To ensure more standardized installations and minimize disruptions for the end user, there is the option to set a global “silent” key in the registry, which ensures that all packages installed via the software kiosk use the same mode. Ideally, this should be the “0” (/S0) mode. Progress is displayed to the user in the kiosk in larger increments.

With Empirum 17.0 Update 2 the Setup.exe will know the new value /S4. This suppresses all output except for process queries and prompts (user input).

Current restrictions:

  • Mode “0” and “1” does not work for packages where an user entry is required.

[HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\Agent]

"GlobalSilentLevel"=dword:00000004

In this example, all installations are set to “/S4”.

Shutdown the computer after OS installation

If the registry key below is set to 1, the "InstallAtShutdown" mode is active for the agent. This can be set in UEMAgent.bat to turn off the computer completely after the OS installation.

[HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\AGENT]

"InstallAtShutdown"=dword:00000001

Example in UEM Agent.bat:

REG ADD HKLM\SOFTWARE\MATRIX42\AGENT /v InstallAtShutdown /t REG_DWORD /d 1 /f

Hide the option "Install on Shutdown"

The option "Install on Shutdown" can be hidden from the user:

[HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\AGENT]

"AllowPostponeUntilShutdown "=dword:00000000

Suspend mode

With a registry key the UEM Agent can be set to a mode in which no polling, download or installation actions are performed. Internally this mode is used for the Auto Update. If required, this mode can be used, for example, to prevent the agent's possible data consumption when establishing a VPN connection via a satellite telephone.

[HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\Agent]

"Suspenduntil" (STRING) = end date of suspend mode

The value specifies the end of the suspend mode. For example, 2018-12-24T18:15. Any specified value that is not recognized by the agent as an ISO time value in the past will pause the agent.

Check for script files for kiosk packages

The check of the script files on the depot server can be deactivated with the following registry key:

[HKEY_LOCAL_MACHINE\SOFTWARE\Matrix42\AGENT]

"UseCheckFileForKiosk"=dword:00000000

 

  • Was this article helpful?