Agenten konfigurieren
Damit der Agent das Message Center findet, benötigt er die Basis-URL des Matrix42-Servers. Diese kann auf verschiedene Weisen konfiguriert werden:
- MSI-Installation –
SERVER_URL-Property beim Installieren (empfohlen) - Umgebungsvariable –
M42_BASE_URLauf dem Gerät - DNS – TXT-Einträge als automatischer Fallback
Schlägt jede Methode fehl, startet der Agent nicht und protokolliert einen Fehler.
Option 1: MSI-Installation (empfohlen)
Interaktive Installation
Das MSI-Installationspaket fragt die Server-URL in einem eigenen Dialog ab. Kein zusätzlicher Aufwand nötig.
Stille Installation
Übergib SERVER_URL als parameter:
msiexec /i "Labtagon Message Center.msi" /qn SERVER_URL="https://dein-matrix42-server.de" APP_AUTOSTART=1
Dies ist nur bei der erstmaligen Installation nötig, nicht bei Updates.
Verfügbare MSI-Properties:
| Property | Beschreibung | Standard |
|---|---|---|
SERVER_URL |
Basis-URL des Matrix42-Servers | (leer) |
INSTALLDIR |
Installationsverzeichnis | %ProgramFiles%\Labtagon\Message Center Agent |
APP_AUTOSTART |
Agent beim Windows-Login automatisch starten (1/0) |
1 |
APP_AUTOMATIC_START_UP |
Agent direkt nach der Installation starten (1/0) |
1 |
Option 2: Empirum-Paket
Das mitgelieferte Empirum-Paket enthält die Konfiguration in Setup.inf unter [Environment]:
Passe den Wert von MC_SERVER_URL auf die URL deines Matrix42-Systems an. Das Paket übergibt diese Variable beim Installieren automatisch als SERVER_URL-Property an das MSI:
Der MC_SERVER_URL-Wert ist der einzige Wert, den du im Paket anpassen musst.
Option 3: Umgebungsvariable
Ist kein SERVER_URL per MSI gesetzt, prüft der Agent die Umgebungsvariable M42_BASE_URL. Du kannst diese Variable z. B. über Gruppenrichtlinien (GPO) oder eine andere Softwareverteilung auf den Geräten setzen.
Option 4: DNS (Fallback)
Ist weder MSI-Konfiguration noch Umgebungsvariable vorhanden, sucht der Agent automatisch nach DNS-TXT-Einträgen. Die Domain wird aus der Windows-Umgebungsvariablen USERDNSDOMAIN gelesen.
Lege folgende TXT-Einträge in deinem DNS an:
| TXT-Record | Beispielinhalt |
|---|---|
m42wsmsvc.<domain> |
https://dein-matrix42-server.de/m42services |
m42wsmwm.<domain> |
https://dein-matrix42-server.de/wm |
Welche Methode wählen?
| Szenario | Empfehlung |
|---|---|
| Einzelne Geräte / manuelle Installation | Interaktive MSI-Installation |
| Massenverteilung via Intune oder ähnliches | Stille MSI-Installation mit SERVER_URL |
| Massenverteilung via Empirum | Empirum-Paket mit angepasstem MC_SERVER_URL |
| Geräte ohne Softwareverteilung, mit DNS-Kontrolle | DNS-TXT-Einträge |
Tip
Wende dich an den Labtagon Support, falls du Unterstützung bei der Verteilung benötigst.