Der Onboarding-Assistent: Datenbank konfigurieren

Dieser Artikel behandelt den ersten Teil des Onboarding-Assistenten: das Öffnen des Einrichtungsablaufs auf einer brandneuen Installation und das Konfigurieren der Datenbank. Der Abschluss dieses Schritts bereitet das System darauf vor, Ihre Daten zu speichern.

Wann der Assistent läuft

Der Onboarding-Assistent läuft nur, solange eine Installation noch nicht konfiguriert ist. Wenn Sie eine neue Instanz in Ihrem Browser öffnen, werden Sie automatisch zur Einrichtungsroute (/setup) umgeleitet. Der Assistent führt in dieser Reihenfolge durch die folgenden Schritte:

Datenbankkonfiguration
Administratorkonto
Lizenzaktivierung
Erstes Unternehmen/Mandant
Anfangseinstellungen
Abschluss

Der Assistent ist bewusst offen (keine Anmeldung), weil noch kein Konto existiert. Sobald die Einrichtung abgeschlossen ist, werden diese Einrichtungsbildschirme dauerhaft abgeriegelt — ein erneutes Öffnen gibt "The application is already configured. Onboarding is disabled." zurück. Dies ist eine Sicherheitsmaßnahme, führen Sie den Assistenten daher nur einmal aus, während der Ersteinrichtung.

Hinweis: Der Assistent merkt sich, wo Sie sich befinden. Wenn Sie den Browser mitten im Ablauf schließen, setzt das erneute Öffnen der Einrichtungsroute bei dem Schritt fort, den Sie erreicht hatten (zum Beispiel dem Schritt zur Administratorerstellung, wenn die Datenbank bereits konfiguriert ist).

Schritt 1: Die Datenbank konfigurieren

Dieser Schritt teilt der Plattform mit, wo Daten gespeichert werden sollen, und erstellt das Schema der Systemdatenbank.

Den Datenbanktyp wählen

Wählen Sie eine der beiden unterstützten Engines:

PostgreSQL — die empfohlene Vorgabe, besonders auf ARM-basierten Servern.
SQL Server — Microsoft SQL Server, unterstützt für bestehende Umgebungen.

Den Verbindungsstring eingeben

Geben Sie den Verbindungsstring für Ihren Datenbankserver an. Der Assistent füllt Werte aus der Anwendungskonfiguration möglicherweise als Ausgangspunkt vor. Sie benötigen in diesem Stadium nur Konnektivität zum Datenbankserver — die Zieldatenbank selbst muss noch nicht existieren.

Die Verbindung testen

Wählen Sie Verbindung testen. Der Assistent verbindet sich mit dem Server (unter Verwendung der administrativen Standarddatenbank des Servers), um zu bestätigen, dass er ihn erreichen kann.
Wenn der Test erfolgreich ist, sehen Sie eine Erfolgsbestätigung.
Wenn er fehlschlägt, zeigt der Assistent die zugrunde liegende Fehlermeldung an. Prüfen Sie Host, Port, Zugangsdaten und ob der Datenbankserver läuft, und versuchen Sie es dann erneut.

Das Schema konfigurieren und erstellen

Wenn Sie fortfahren, wendet der Assistent das Datenbankschema an (Migrationen) und legt den Berechtigungskatalog an. Wenn die Zieldatenbank nicht existiert und die automatische Erstellung aktiviert ist, wird sie für Sie erstellt. Sobald dies abgeschlossen ist, wird die konfigurierte Verbindung für die verbleibenden Onboarding-Schritte verwendet.

Warnung: Richten Sie das Onboarding nicht auf eine Datenbank, die bereits Daten einer anderen Anwendung enthält. Der Assistent erstellt und migriert das Schema auf dem Zielserver, und das erneute Umlenken der Verbindung ist genau die Art von Aktion, die die Plattform nach abgeschlossener Einrichtung blockiert.

Was als Nächstes geschieht

Nachdem die Datenbank erfolgreich konfiguriert ist, geht der Assistent zum Schritt des Administratorkontos über. Die Verbindungsdetails werden für den Rest des Onboardings vorgehalten und erst dauerhaft in die Anwendungseinstellungen geschrieben, wenn Sie den letzten Schritt abschließen.