Die Inbetriebnahme des frisch installierten primedocs-Servers erfolgt in wenigen Schritten.

Schritt 1: Konfiguration überprüfen

Zuerst wird die Konfigurationsdatei "primedocs.config" überprüft. Sie befindet sich im Installationsverzeichnis (standardmässig unter C:\inetpub\wwwroot\primedocs\primedocs.config).

In der "primedocs.config" sollten keine Platzhalter wie {{OPERATION_DB_CONNECTION_STRING}}, {{GUID}} oder {{RAND}} vorhanden sein. Überprüfen Sie, ob die Struktur den Beispielen auf primedocs.config gleicht.

Schritt 2: Datenbank über Dashboard initialisieren

Nun muss die Datenbank initialisiert werden. Hierfür kann die DataSourceAdminApp bzw. das sogenannte Dashboard verwendet werden.

Das Dashboard kann im Browser aufgerufen werden unter der entsprechenden URL, z. B. https://your-url.local/datasourceadminapp.

Die Authentifizierung für den Zugriff geschieht über die integrierte Windows-Authentifizierung (siehe Schritt 3).

Im Dashboard wird eine Übersicht über die konfigurierten Datenbanken angezeigt. Wählen Sie die einzige konfigurierte Datenbank (im Beispiel "primedocs-primesoft", im Screenshot ist diese bereits initialisiert!).

Open

Anschliessend kann die Initialisierung durch Wählen des Buttons "Init Datasource" ausgelöst werden.

Schritt 3: Zugriff auf Admin/Dashboard einschränken

Nach der Installation hat jeder Windows-Benutzer in der Domäne Zugriff auf das Dashboard. An dieser Stelle sollte der Zugriff eingeschränkt werden auf wenige Benutzer.

Die Authentifizierung geschieht über Windows. Die Berechtigungskonfiguration dafür kann in der entsprechenden "Web.config"-Datei (standardmässig unter "C:\inetpub\wwwroot\primedocs\datasourceadminapp\Web.config") vorgenommen werden und wird durch den IIS durchgesetzt.

Schritt 4: Verschlüsselungsschlüssel generieren

Auf neuen Datenbanken sollte ein "symmetric encryption key" (symmetrischer Verschlüsselungsschlüssel) erstellt werden.

Die folgende Meldung weist auf das Fehlen dieses Schlüssels hin:

Open

Der Schlüssel kann im Reiter "Settings" unter "General Settings" bei "SymmetricEncryptionKey" mit dem Button "generate" erstellt werden.

Schritt 5 (Optional): Background Jobs konfigurieren

Der "JobHost" ist eine Konsolenapplikation, welche z. B. für die automatische Benutzerdatensynchronisation, Verwaltung von dynamischen Gruppen, das caching von Gruppeninformationen für Benutzer oder für ein automatisiertes Sichern der primedocs-Daten im primedocs-Package-Format (".oopx") genutzt werden kann.

Über die Standardinstallation wird vorgeschlagen, den "JobHost" einmal täglich als "Scheduled Task" einzurichten. Hierbei wird der "JobHost" ohne Parameter gestartet. Dies sorgt dafür, dass sowohl Benutzersynchronisation ("UserSync"), Verwalten von dynamischen Gruppen ("DynamicGroupLinking") und ein Caching aller Gruppeninformation für Benutzer ("PrincipalConnectorCaching") gestartet werden. Die eigentliche Konfiguration dieser Jobs erfolgt in der jeweiligen Datenquelle.

Package-Backup konfigurieren

Über den JobHost können automatisiert die primedocs-Daten im primedocs-Package-Format (".oopx") in ein konfigurierbares Verzeichnis (p für path) abgelegt werden. Über einen weiteren Parameter (r für retain) können ältere Backups automatisch gelöscht werden. Die generierten primedocs Packages oder Teile davon können über das Admin Dashboard wieder importiert werden.

Aufruf:

Der Standardwert von -r ist 7, d. h. es verbleiben maximal 7 Backups von jeder Datenquelle im Verzeichnis.

Hilfe anzeigen

Um die Hilfe beim JobHost anzuzeigen nutzen Sie diesen Parameter: