Erste Schritte (neuer Server)
Zuletzt geändert: 24.07.2026 07:45

Erste Schritte auf einem neuen Server #

Diese Seite beschreibt in einfachen Worten, wie EulandaXrest und der ERP-Client (EulandaXclient) auf einen Server kommen, auf dem bisher nur EULANDA mit SQL Server läuft. Es sind drei Schritte - alles Weitere erledigt der Assistent im Verwaltungsfenster.

Was du brauchst #

  • Zugriff auf den Server (RDP genügt), Windows PowerShell 5.1 ist auf jedem Windows Server vorhanden.
  • Die UDL-Datei des Mandanten, so wie EULANDA sie nutzt (z.B. C:\Eulanda\Mandant.udl).
  • Für die einmalige Einrichtung eine Anmeldung, die Tabellen anlegen darf (Windows-Administrator oder ein SQL-Login wie sa). Der laufende Betrieb braucht diese Rechte nicht - der Assistent fragt bei Bedarf nach der stärkeren Anmeldung.

Schritt 1: Module holen und entpacken #

Die Module liegen als ZIP auf files.eulanda.eu, je Produkt ein Ordner mit gleichnamiger Datei (daneben version.txt mit der Versionsnummer):

https://files.eulanda.eu/eulandaxtools/eulandaxtools.zip
https://files.eulanda.eu/eulandaxrest/eulandaxrest.zip
https://files.eulanda.eu/eulandaxclient/eulandaxclient.zip

Jedes ZIP in den PowerShell-Modulpfad für alle Benutzer entpacken, je Modul ein Ordner mit dem Modulnamen:

C:\Program Files\WindowsPowerShell\Modules\EulandaXtools\
C:\Program Files\WindowsPowerShell\Modules\EulandaXrest\
C:\Program Files\WindowsPowerShell\Modules\EulandaXclient\

Danach findet Import-Module die Module ohne Pfadangabe.

Schritt 2: Assistent starten #

In einer Windows PowerShell 5.1 (powershell.exe, nicht pwsh):

Import-Module EulandaXrest
Show-XrestAdmin -Udl 'C:\Eulanda\Mandant.udl'

Das Verwaltungsfenster öffnet und erkennt selbst, dass die Datenbank noch nicht eingerichtet ist. Die Einrichtungs-Seite führt der Reihe nach durch:

  1. Migration ausführen - legt das Schema xrest mit allen Tabellen an. Darf die UDL-Anmeldung das nicht, fragt der Dialog nach einer stärkeren Anmeldung (Windows oder SQL). Die Prüfliste zeigt jeden Punkt mit Ampel.
  2. Ersten Administrator anlegen - Anmeldename und Passwort vergeben (das Auge im Passwortfeld deckt die Eingabe auf). Mit diesem Benutzer meldet man sich später im Client und in der Netz-Verwaltung an.
  3. App-Server-Key anlegen - ein Klick erzeugt den Vertrauens-Key für den ERP-Client. Der Key wird genau einmal angezeigt - kopieren und sicher ablegen.

Bis die Migration durch ist, sind die übrigen Seiten des Fensters gesperrt - man kann also nichts in der falschen Reihenfolge tun.

Schritt 3: Starten #

Sobald Schema und Administrator stehen, zeigt die Einrichtungs-Seite die fertig ausgefüllten Startbefehle mit Kopier-Knopf - UDL und Key sind schon eingesetzt:

# REST-API für Fremdsysteme (bindet ohne weitere Angaben nur localhost)
Start-XrestServer -Udl 'C:\Eulanda\Mandant.udl'

# ERP-Client als Web-App (Kopplung per PIN, Anmeldung mit dem Administrator)
Start-XclientServer -Udl 'C:\Eulanda\Mandant.udl' -ApiKey 'exr_xclient_...'

# ERP-Client als lokales Fenster, zum sofortigen Ausprobieren
Show-EulandaXclient -Udl 'C:\Eulanda\Mandant.udl' -ApiKey 'exr_xclient_...'

Damit läuft alles im LAN. Für den Betrieb im Netz (eigener Hostname, HTTPS-Zertifikat, Start als geplante Aufgabe, Watchdog) geht es weiter mit Installation und Betrieb; die laufende Wartung von unterwegs beschreibt Verwaltung.