agorum core ocr engine auf anderem Server installieren und aktualisieren

Wenn Sie agorum core auf einem Linuxrechner installiert haben und die OCR-Funktionen verwenden möchten, müssen Sie die beschriebenen Schritte auf einem Windows-Server umsetzen. Die von agorum core genutzte OCR-Engine ist eine rein auf Windows basierende Software.

Diese Dokumentation beschreibt, wie Sie:

den Windows-Server vorbereiten
die OCR-Engine installieren
den Linux- und Windows-Server miteinander verbinden, sodass agorum core und die OCR-Engine miteinander kommunizieren können

Voraussetzungen Windows-Server

ImageMagick ist installiert.
Ghostscript ist installiert.
.NET 4.0 Framework ist installiert.

Das .NET Framework konnte nicht durch Windows installiert werden

Sie können das .NET Framework über den Server-Manager von Windows nachinstallieren.

Verwenden Sie einen Windows Server 2012 R2, befolgen Sie die Schritte unter Windows Server 2012 R2 und Windows Server 2019 .NET 2.0 Problem lösen. Das dort beschriebene Problem verweist darauf, dass das OCR-Set-up vielleicht erneut durchgeführt werden muss, da die Konfiguration nicht komplett durchgeführt wurde.

Die agorum core ocr engine auf dem Windows-Server installieren

Hinweis: Die agorum core ocr engine wird nur in Verbindung mit einer agorum core pro-Lizenz unterstützt.

Laden Sie die Datei setup-agorum-core-ocr-engine-X_X_X.exe aus dem Downloadbereich der agorum core pro-Version.

Den Link erhalten Sie von Ihrem agorum-Ansprechpartner.
Speichern Sie die Datei auf Ihrem agorum core-Server (Windows).
Starten Sie die Installationsdatei und folgen Sie den Anweisungen.

Ports freigeben

Damit die Kommunikation zwischen dem agorum core-Server und dem Server, auf dem die agorum core ocr engine installiert ist, reibungslos funktioniert, müssen Sie Ports freigeben, falls diese besetzt sind:

Auf dem agorum core-Server muss der Port 443 (TCP) freigeschaltet sein.
Auf dem Server, auf dem die agorum core ocr engine installiert ist, muss der Port 8080 (TCP) freigeschaltet sein, da der Dienst AgorumDocumentService standardgemäß diesen Port verwendet (Einstellungen siehe Firewall konfigurieren).

Hinweis: Der Dienst AgorumDocumentService erscheint nur, wenn die OCR auf einem eigenständigen Windows-Server installiert wird. Bei der Installation von OCR und agorum core auf demselben Server verwendet die OCR-Engine dieselbe Java-Maschine und Jboss wie agorum core.

Den Port 8080 umziehen

Sollten Sie den Port 8080 anderweitig verwenden, können Sie den Port umziehen.

Beenden Sie den Dienst AgorumDocumentService auf dem Windows-Server.

Passen Sie die Portkonfiguration (Standard 8080) in der Datei server.xml an. Der Pfad lautet:

InstallDir\agorum core DocumentServer\jboss\server\default\deploy\jbossweb-tomcat50.sar\server.xml

Starten Sie den Dienst AgorumDocumentService auf Ihrem Windows-Server.
Das agorum core-System auf dem Linux-Server muss jetzt erfahren, über welchen Port es mit der OCR-Engine kommunizieren kann.

a) Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.
b) Öffnen Sie den Pfad MAIN_SERVER_MANAGEMENT > RemoteDocumentServiceServer
c) Doppelklicken Sie auf das Property-Entry ServerPort, um es zu bearbeiten und die neue Port-Nummer anzupassen.
Starten Sie agorum core auf dem Linux-Server neu.

Die Kommunikation zwischen agorum core und der OCR-Engine prüfen

Hinweis: Die agorum core ocr engine wird nur in Verbindung mit einer agorum core pro-Lizenz unterstützt.

Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
Wählen Sie links im Menü Document conversion > Checks > Remote host check.
Klicken Sie auf Execute check.
Prüfen Sie Ihre Port-Angaben erneut, falls es zu Fehlermeldungen kommt, oder nehmen Sie anderweitige Änderungen vor.

Prüfen, ob agorum core mit der OCR-Engine kommunizieren kann

Nachträgliche Änderungen vornehmen

Die IP-Adresse oder den Port der agorum core ocr engine ändern

Sofern sich die IP-Adresse oder der Port des Servers, auf dem die agorum core ocr engine läuft, ändern sollte, müssen Sie dies auf dem agorum core-Server anpassen.

Schalten Sie den jeweiligen Port auf dem Windows-Server in der Firewall für den agorum core-Server frei.
Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_SERVER_MANAGEMENT/RemoteDocumentServiceServer

Passen Sie in diesem Pfad folgende Property-Entrys mit einem Doppelklick an.
```
ServerAddress
ServerPort
```

Die IP-Adresse, den Port des agorum core-Servers oder das Passwort ändern

Bei Änderung der IP-Adresse oder des Ports des agorum core-Servers müssen Sie die Einstellung auf dem Server der agorum core ocr engine vornehmen.

Öffnen Sie in Windows folgenden Pfad (Installationsverzeichnis von agorum core, Pfad kann variieren):

C:\Program Files (x86)\agorum\agorum core DocumentServer\jboss\server\default\deploy\documentservice.ear\lib\properties.jar\agorum\agceptit\dynawebservices\properties

Bearbeiten Sie die Datei:
```
DynaWebServicesClient.properties
```
Suchen Sie die folgende Einstellung innerhalb der Datei:
```
agorum.agceptit.dynawebservices.Url
```
Passen Sie die Einstellung und ggf. die Zugangsdaten zum agorum core-Server an dieser Stelle an.
Starten Sie nach Änderung den Dienst AgorumDocumentService neu.

Die OCR-Engine aktualisieren

Aktualisieren Sie die OCR-Engine, wenn Sie im selben Zuge agorum core aktualisieren. Das Set-up für die agorum core ocr engine dient gleichzeitig als Update für eine bereits installierte agorum core ocr engine.

Weitere Schritte

Nehmen Sie nach erfolgreicher Installation weitere Anpassungen vor:

Firewall einstellen / relevante Ports freigeben