Laden...

Installation

Documenos ®

Documenos® ist sowohl mit der x86- als auch mit der ARM-Architektur kompatibel.

Der Prozessor Ihres Servers kann x86- oder ARM-basiert sein. Documenos® ist mit beiden kompatibel. Die passenden Installationsdateien für beide Serverarchitekturen können Sie auf dieser Seite herunterladen: Herunterladen

Es gibt zwei Installationswege: Mit Docker starten alle Komponenten mit einem einzigen Befehl – dies ist die empfohlene Methode. Die Installation unter Windows IIS empfiehlt sich, wenn Sie die Anwendung auf Ihrer vorhandenen Windows-Serverinfrastruktur betreiben möchten.

ARM / x86

Installation mit Docker

Ein einziges Paket installiert die Anwendung, die PostgreSQL-Datenbank, den Dienst für digitale Signaturen, die Suchmaschine Elasticsearch und den Übersetzungsdienst LibreTranslate gemeinsam.

  1. Schaffen Sie die Voraussetzungen. Auf Ihrem Server müssen Docker Engine (20.10+) und das Docker-Compose-Plug-in (2.0+) installiert sein. Für den Anwendungscontainer müssen mindestens 8 GB RAM verfügbar sein, und der Server benötigt Internetzugang, um die Container-Images herunterzuladen. Läuft unter Linux, Windows und macOS.
  2. Laden Sie das Paket herunter. Laden Sie das Docker-Compose-Paket (ZIP) von der Seite Herunterladen herunter. Das Paket besteht aus docker-compose.yml mit den Dienstdefinitionen, .env mit den Konfigurationswerten und readme.md mit den Installationshinweisen. Kopieren Sie den Ordner unverändert auf Ihren Server.
  3. Legen Sie die Passwörter fest. Öffnen Sie die Datei .env und ersetzen Sie vor dem Starten der Container unbedingt diese beiden Werte durch eigene starke und eindeutige Werte: DB_PASSWORD (Passwort des PostgreSQL-Datenbankbenutzers) und DEFAULT_PWD (Initialpasswort für neu angelegte Benutzer; die Benutzer sollten es nach der ersten Anmeldung ändern). Verwenden Sie in der Produktivumgebung niemals Beispiel- oder Standardpasswörter.
  4. Überprüfen Sie die Netzwerk- und Porteinstellungen. Prüfen Sie die Werte *_BIND_IP und *_PORT. Standardmäßig binden sich die Datenbank-, Signatur-, Such- und Übersetzungsdienste nur an 127.0.0.1 und sind von außen nicht erreichbar; der einzige nach außen geöffnete Port ist der Anwendungsport (APP_PORT, Standard 8080). Befindet sich die Anwendung hinter einem Load Balancer oder Reverse Proxy, setzen Sie den Wert CLIENT_IP_HEADER (zum Beispiel X-Forwarded-For).
  5. Starten Sie die Dienste. Führen Sie in dem Ordner, in dem sich die Datei docker-compose.yml befindet, folgenden Befehl aus: docker compose up -d
  6. Warten Sie, bis der erste Start abgeschlossen ist. Beim ersten Start lädt der Übersetzungsdienst die mit TRANSLATE_LOAD_ONLY festgelegten Sprachmodelle herunter; das dauert bei einer normalen Verbindung 5–10 Minuten und erfolgt nur einmal. Den Fortschritt können Sie mit den Befehlen docker compose ps und docker compose logs -f documenos_translate verfolgen. Während des Downloads zeigt der Dienst starting, sobald er bereit ist, healthy. Bei einer langsamen Verbindung erhöhen Sie den Wert TRANSLATE_START_PERIOD.
  7. Öffnen Sie die Anwendung. Öffnen Sie in Ihrem Browser http://ihre-serveradresse:8080 (bzw. den von Ihnen festgelegten APP_PORT-Wert), legen Sie gemäß den Anweisungen beim ersten Start das Administratorkonto an und registrieren Sie Ihre Lizenz.

Aktualisierung: Laden Sie das neueste Paket herunter, übertragen Sie Ihre vorhandenen Konfigurationswerte in die neue Datei .env und führen Sie docker compose pull und anschließend docker compose up -d aus. Ihre Daten werden in benannten Docker-Volumes gespeichert und sind von Updates und Neustarts nicht betroffen.

Installation unter Windows IIS

Documenos® ist eine ASP.NET-Core-Anwendung und läuft unter IIS über das ASP.NET-Core-Modul.

  1. Schaffen Sie die Voraussetzungen. Aktivieren Sie auf Windows Server die Rolle IIS und installieren Sie das ASP.NET Core Hosting Bundle. Das Hosting Bundle muss nach IIS installiert werden, da das ASP.NET-Core-Modul sonst nicht in IIS registriert wird. Starten Sie IIS nach der Installation mit dem Befehl iisreset neu.
  2. Bereiten Sie den Datenbankserver vor. Installieren Sie PostgreSQL (v15 oder höher) oder stellen Sie den Zugriff auf einen vorhandenen PostgreSQL-Server sicher. Documenos® verwendet separate Datenbanken für den Kern (DOCUMENOS_CORE), das Reporting (DOCUMENOS_REPORT) und die Gesichtserkennung (DOCUMENOS_FACE).
  3. Bereiten Sie die Hilfsdienste vor. Für die Volltextsuche wird Elasticsearch benötigt, für elektronische Signaturen der Dienst für digitale Signaturen und für die automatische Übersetzung auf Ihrem eigenen Server LibreTranslate. Betreiben Sie diese Dienste mit den Definitionen aus dem Docker-Paket auf einem separaten Server und notieren Sie die Adressen, unter denen die Anwendung sie erreichen kann.
  4. Laden Sie das ZIP-Paket herunter. Laden Sie das Paket herunter, indem Sie Ihren Download-Schlüssel im Abschnitt ZIP-Datei für Windows IIS der Seite Herunterladen eingeben.
  5. Entpacken Sie die Dateien auf den Server. Entpacken Sie den ZIP-Inhalt in den für die Website vorgesehenen Ordner, zum Beispiel C:\inetpub\documenos.
  6. Konfigurieren Sie die Verbindungseinstellungen. Tragen Sie in der Datei appsettings.json im Anwendungsordner im Abschnitt ConnectionStrings Ihre PostgreSQL-Verbindungsdaten (CnStrServer, CnStr, CnStrBI, CnStrFA) ein. Legen Sie in derselben Datei auch die Adressen der Signatur- und Übersetzungsdienste fest (SignatureServiceUrl, TranslateServiceUrl). Die Verbindung zum Elasticsearch-Suchserver wird nach der Installation im Verwaltungsbereich eingerichtet.
  7. Erstellen Sie einen Anwendungspool. Fügen Sie im IIS-Manager einen neuen Anwendungspool (Application Pool) hinzu und setzen Sie die .NET CLR-Version auf Kein verwalteter Code (No Managed Code).
  8. Fügen Sie die Website hinzu. Erstellen Sie im IIS-Manager über Sites → Website hinzufügen eine neue Site; wählen Sie als physischen Pfad den Ordner, in den Sie die Dateien entpackt haben, und als Anwendungspool den soeben erstellten Pool. Legen Sie die Bindungen (Port, Hostname) fest und weisen Sie in der Produktivumgebung ein SSL-Zertifikat für HTTPS zu.
  9. Erteilen Sie die Ordnerberechtigungen. Erteilen Sie der Identität IIS AppPool\<Poolname> Lese- und Schreibrechte für den Anwendungsordner. Die Anwendung schreibt Protokolle, temporäre Dateien und Datenschutzschlüssel unter dieser Identität.
  10. Starten und öffnen Sie die Site. Starten Sie die Site und öffnen Sie die festgelegte Adresse in Ihrem Browser. Das Datenbankschema wird beim Start der Anwendung automatisch angewendet. Legen Sie gemäß den Anweisungen beim ersten Start das Administratorkonto an und registrieren Sie Ihre Lizenz.

Aktualisierung: Die Schritte für ein Versions-Upgrade bei einer IIS-Installation sind auf der Seite Wartung und Updates beschrieben. Informationen zur Lizenzregistrierung und zum Testmodus finden Sie auf der Seite Lizenzierung.