Getting started with Configuring an Offline Subdepot Server

Create Agent Template for the UEM-Agent

This is the agent configuration that connects from your offline depot server - via the UEM agent (https) - to the master server in the cloud.

1. Start the Matrix42 Management Console via the link provided to you.
2. In the navigation bar, switch to Configuration > Software Management > Register Empirum Agent tab.
3. Enter (optionally) a description.
   
4. Switch to General Settings.
   Enter your fallback server - EmpirumXXX.m42cloud.com (Replace XXX with your instance).
   Enable the HTTPS option (checked) and disable the SMB option (unchecked).
   
   All other options can be customized "optionally" according to your requirements.
5. The options in the Software Depot and AgentUI area can be customized according to your requirements.
6. On the File menu, click Save.
7. Enter a name for this agent configuration and click Save.
   
   The Empirum Agent template for the UEM-Agent has been created and can later be assigned to a configuration group.

Create Variable Configurations

For the variable configurations described below, you can download the configurations and then adapt them to your environment. You can upload the variable configurations to the master server via WebDAV (WinSCP) as described here.

1. Switch to Variable Configurations in the tree on the left.
2. Create a variable configuration for each of the following variable sets:
   • SUBDEPOT
     
     Enter the correct values of the variables for your environment, this concerns in particular
     WEBSERVER_USER, .WEBSERVER_PASSWORD, ROOTPATH, USER_1, PASSWORD_1 und SERVICES.
   • SUBDEPOT_SERVICES
     
     Enter the correct values of the variables for your environment.
   • MX42_UEM_DEPOT_MANAGEMENT
     
     Click on the button for the respective scheduler entry , optionally change the default values and confirm each with OK.
     The variable configurations have been created and can later be assigned to a configuration group.

Create a configuration group

1. Create a new computer object for the Empirum Offline Depot Server (in this example CLOUD-DEPOT).
   
   It is important that the Computer role "Empirum Depot Server" is activated under Computer type (check mark)! The specification of the UUID is optional.
2. After all the information has been entered, click OK.
3. Double click on the computer you just created (in the Not Assigned Computers filter). Check if your Master Server (EmpirumXXX) is entered in the Empirum Server tab under Assigned Empirum Servers.
   
4. Create a new configuration group in the middle tree, e.g. DepotServer.
5. Add the computer you just created to this configuration group.
6. Add the previously created variable configurations to this configuration group.
7. Add at least the following software packages to this configuration group:
   • Empirum Subdepot
   • Empirum Subdepot PXE Service
   • Matrix42 UEM Agent Windows
8. Activate the computer (PULL via DDS/DDC (software packages only).
   Your configuration group for the Offline Depot Server now looks something like this:
   

Install Matrix42 UEM Agent

Now the current UEM Agent must be installed on the server configured as the CLOUD Offline Depot Server (Matrix42 UEM Agent 2312.1.2 Standard Feature Release x64 is used for this example).

1. Download the latest UEM agent from the Matrix42 Marketplace.
2. Unzip the UEM Agent you just downloaded to a local directory (e.g. D:\Temp\UEM-Agent).
3. Change to the directory ".\Empirum\Configurator\Packages\Matrix42\UEM Agent Windows\MSI\2312.1.2\" and double-click the file "Matrix42 UEM Agent 2312.1.2 Standard Feature Release Setup 64bit.MSI".
   
4. Click Next.
5. Read the "End-User License Agreement". If you agree, place a check mark in front of "I accept the terms in the License Agreement" and click Next.
   You will be prompted for the "Agent Connection Settings".
   
   • Protocol:                        https
   • Server:                          empirumXXX.m42cloud.com
   • Port:                              443
   • User:                             .\DepotUser
   • Encrypted Password:   <Password AES256-ecrypted with EmpCrypt.exe> (EmpCrypt.exe /aes256 <password>)
6. Answer Yes to the question "Do you want to allow this app to make changes to your device?".
7. Click Finish to exit the setup wizard.
8. Perform a restart of the server.

Create Agent Template for your Offline Depot Server

This is the agent configuration that is used in your LAN for the distribution of software packages and operating system installations from the Offline Subdepot Server to your clients.

1. In the navigation bar, switch to Configuration > Software Management > Register Empirum Agent tab.
2. Click on New in the File menu.
3. Enter (optionally) a description.
   
4. Switch to General Settings.
   Your offline depot must be entered as the Fallback Server and a local or domain user must be specified as the Account under SUBDEPOT variables - see Create Variable Configurations > SUBDEPOT.
   
   
   All other options can be customized "optionally" according to your requirements.
5. The options in the Software Depot and AgentUI area can be customized according to your requirements.
6. On the File menu, click Save.
7. Enter a name for this agent configuration and click Save.
   
   The Empirum Agent template for the internal LAN has been created and can later be assigned to a configuration group for the distribution of software packages and operating system installations from the Offline Subdepot Server to your clients..

You can find more information about configuring the Agent Template here and here and how to use the Variable Configurations you can find here.