Dieser Abschnitt enthält Anleitungen zur manuellen Installation Ihrer Anwendung auf einem Netzwerkserver sowie auf den mit diesem Server verbundenen Arbeitsstationen.Documentation Index
Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
Use this file to discover all available pages before exploring further.
Eine manuelle Netzwerkinstallation ist nur möglich, wenn Sie Software- oder Online protection verwenden.
Online-Schutz
Online-Schutz
In diesem Szenario installieren Sie Ihre Anwendung, die die ABBYY FineReader Engine-Bibliothek verwendet, manuell auf einem Server und auf Arbeitsstationen, die über ein Netzwerk mit diesem Server verbunden sind. Sie benötigen:Um dieses Szenario umzusetzen, müssen Sie den Licensing Service auf dem Lizenzserver installieren – einem Computer, der Lizenzen verwaltet und an die Arbeitsstationen im Netzwerk verteilt. Installieren Sie anschließend die Bibliothek auf den Arbeitsstationen, richten Sie die Verbindung zum Lizenzserver ein und kopieren Sie das Lizenz-Token auf jede Arbeitsstation.Standardmäßig wird der TCP/IP-Port 3022 verwendet. Wenn dieser Port auf Ihrem Server geschlossen ist, geben Sie einen anderen offenen Port an:Wenn Sie für den Server einen anderen TCP/IP-Port festgelegt haben, nehmen Sie hier dieselbe Einstellung vor.
- eine Online-Lizenz-Token-Datei (mit einem Namen wie SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Für den Betrieb der Anwendung ist eine Internetverbindung erforderlich.
Um die Erstellung eines benutzerdefinierten Pakets zu vereinfachen, entpacken Sie die Dateien mithilfe der Option /extract für installRnt**.exe oder installLS.exe in der Befehlszeile aus dem Distributionspaket ohne Installation in einen bestimmten Ordner. Darin befinden sich die folgenden Ordner:
-
für installRnt**.exe:
- FineReader Engine - mit den Dateien von ABBYY FineReader Engine
- Inc - mit FREngine.tlb (zum Registrieren von FREngine.dll)
- Licensing - mit den Dateien des Licensing Service
-
für installLS.exe:
- Licensing - mit den Dateien des Licensing Service
- License Server - mit den Dateien des Lizenzservers
Erstellen der ABBYY FineReader Engine-Pakete auf Ihrem Computer:
-
Bibliothekspaket. Dabei handelt es sich um einen Ordner mit den ABBYY FineReader Engine-Dateien, die im Abschnitt ABBYY FineReader Engine Distribution Kit der Developer-Hilfe aufgeführt sind. Die Liste umfasst:
- Dateien, die im ABBYY FineReader Engine Distribution Kit als “mandatory” gekennzeichnet sind. Dabei handelt es sich um Systemmodule und Hauptdatenbanken für die Erkennung.
- Erkennungsdatenbanken für Druckschrift, wenn Sie handgeschriebenen Drucktext erkennen möchten.
- Ressourcendateien für Benutzeroberflächensprachen, die in Ihrer Anwendung verwendet werden.
- Wörterbuch-Supportdateien für Erkennungssprachen, die von Ihrer Anwendung unterstützt werden. Wenn die Erkennungssprachen Sprachen mit dem lateinischen Alphabet umfassen, stellen Sie sicher, dass Sie die Dateien Univers.amd und Univers.amm auswählen.
- Scanning-Module, scanning-spezifische Ressourcen und Twain-Module, wenn Ihre Anwendung das Scannen über die ABBYY FineReader Engine Schnittstelle ausführt.
- Module für Windows Visual Components und die entsprechenden spezifischen Ressourcen, wenn Ihre Anwendung ABBYY FineReader Engine Visual Components verwendet.
-
Lizenzserver-Paket. Es besteht aus zwei Ordnern mit den Dateien des Licensing Service und des License Manager Utility:
- Licensing Service-Ordner mit allen Dateien, die aus dem entpackten Licensing-Ordner kopiert wurden.
- License Manager (License Manager64)-Ordner mit den folgenden aus dem entpackten Lizenzserver-Ordner kopierten Dateien: AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
-
Weitere Softwarekomponenten:
- Das Update KB2999226 oder Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Wenn Sie das Windows-Updatepaket nicht installieren, können Sie das Redistributable aus dem Ordner External Components\VC_Redist im Distributionspaket installieren: vc_redist.x86.exe und vc_redist.x64.exe.
- .NET Framework 4.6.2, wenn Sie das Modul OfficeConverters verwenden möchten.
Installieren des Licensing Service auf dem Lizenzserver:
- Kopieren Sie das Lizenzserverpaket und Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 auf den Lizenzserver.
- Installieren Sie Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- Kopieren Sie die Ordner aus dem Lizenzserver-Paket in das Verzeichnis auf dem Lizenzserver, in dem sich der Licensing Service befinden soll.
Wir empfehlen, ABBYY FineReader Engine-Dateien in einer Ordnerstruktur abzulegen, die leicht zu finden und zu verwenden ist. Siehe folgendes Beispiel:
- <YourApplicationFolder>/Lizenzserver/Licensing Service.
- <YourApplicationFolder>/Lizenzserver/License Manager (License Manager64).
- Erstellen Sie einen Ordner zum Speichern der Lizenzdaten (standardmäßig den Ordner %ProgramData%\ABBYY\SDK\12\Licenses). Jeder Benutzer, der Ihre Anwendung ausführt, muss Vollzugriff auf diesen Ordner haben.
- Erstellen Sie eine LicensingSettings.xml-Datei. Das XML-Schema, dem sie entsprechen muss, finden Sie in der Datei LicensingSettings.xml, die sich im Ordner Inc Ihrer Developer-Installation oder im Ordner CADF\Inc des Distribution-Pakets befindet. In dieser Datei müssen Sie den Typ des Verbindungsprotokolls festlegen, das Ihr Lizenzserver verwendet. Unterstützt werden die Typen LocalInterprocessCommunication, NamedPipes, TCP/IP und Sockets:
-
Kopieren Sie die konfigurierte LicensingSettings.xml-Datei in die folgenden Ordner:
- Licensing Service.
- License Manager (License Manager64).
- Führen Sie LicensingService.exe mit dem Parameter “/install” aus:
Aktivieren der Lizenz auf dem Lizenzserver:
Eine Online-Lizenz erfordert keine Aktivierung: Die Lizenzinformationen werden zur Laufzeit der Anwendung vom ABBYY Online-Lizenzierungsdienst abgerufen. Zur Autorisierung sendet die Anwendung eine Lizenz-Token-Datei sowie ein Lizenz-Kennwort. Die Token-Datei muss an dem Speicherort abgelegt werden, den die Anwendung erwartet. Dieser Speicherort muss vom Developer angegeben werden (Standard: %ProgramData%\ABBYY\SDK\12\Licenses).Zur Laufzeit muss die Anwendung regelmäßig eine Verbindung zum ABBYY Online-Lizenzierungsdienst herstellen, um Lizenzinformationen abzurufen und Nutzungsstatistiken zu übermitteln. Es werden keine privaten Informationen mit den ABBYY-Servern ausgetauscht.- Stellen Sie sicher, dass Verbindungen zu *.abbyy.com über Port 443 (HTTPS) zugelassen sind. Wenn die Verbindung unterbrochen wird, funktioniert die Anwendung nicht mehr, sobald ein bestimmtes Zeitlimit für die Wiederherstellung der Verbindung überschritten wird. Der Synchronisierungszeitraum und das Zeitlimit für die Wiederherstellung der Verbindung sind spezifische Parameter jeder Online-Lizenz.
Es ist nicht möglich, zwei oder mehr Online-Lizenzen gleichzeitig auf demselben Host zu verwenden. Wenn die Anwendung läuft und die Verbindung zu den ABBYY-Lizenzierungsdiensten besteht, können Sie die Details der derzeit aktiven Online-Lizenz über das License Manager Utility einsehen.
Installation der ABBYY FineReader Engine-Bibliothek auf den Arbeitsstationen:
Wenn der Lizenzserver auch als Workstation verwendet werden soll, führen Sie diesen Schritt auch auf dem Server aus.
- Kopieren Sie das Bibliothekspaket und die Softwarekomponenten auf all Ihre Arbeitsstationen.
Der einfachste Weg, um sicherzustellen, dass alle Ressourcendateien vom Programm gefunden werden können, besteht darin, dieselbe Ordnerstruktur beizubehalten und die Datei SharedFiles.ini, die Sie je nach Betriebssystem im Ordner Bin (oder Bin64) finden, in Ihr Distributionspaket aufzunehmen. Wenn Sie diese Datei nicht verwenden möchten, müssen Sie die Ordnerstruktur nicht beibehalten, sondern wie folgt vorgehen:
- Kopieren Sie den Ordner Data\Resource mit allen Unterordnern in den folgenden Ordner:
- Bin
- Bin64
- Kopieren Sie den Inhalt des Ordners Data\ExtendedDictionaries direkt in den Ordner Bin oder Bin64.
- Kopieren Sie die übrigen im Ordner Data enthaltenen Dateien in den Ordner Bin oder Bin64.
-
Installieren Sie die erforderlichen Softwarekomponenten:
- Microsoft Visual C++ 2015–2019 Redistributable 14.28.29912.
- .NET Framework, falls erforderlich.
- Kopieren Sie den Ordner mit den ABBYY FineReader Engine-Dateien aus dem Bibliothekspaket in das Verzeichnis auf der Workstation, in dem die Bibliothek gespeichert werden soll.
-
Registrieren Sie die benötigten dynamischen Bibliotheken:
- Wenn Ihre Anwendung das Engine-Objekt mithilfe der IEngineLoader-Schnittstelle lädt, registrieren Sie FREngine.dll mit der folgenden Befehlszeile:
- Wenn Ihre Anwendung Visual Components verwendet, registrieren Sie VisualComponentsX.dll mit der folgenden Befehlszeile:
-
Erstellen Sie die Ordner, die von ABBYY FineReader Engine verwendet werden. In der folgenden Liste sind die Standardwerte für diese Ordner aufgeführt:
- Ordner %ProgramData%\ABBYY\SDK\12\FineReader Engine (Vollzugriff ist erforderlich)
- Ordner %ProgramData%\ABBYY\SDK\12\Licenses (Vollzugriff ist für den Lizenzserver erforderlich, für Arbeitsstationen optional)
Um den Ordner für die Lizenzdaten während der Installation anzugeben, finden Sie ein Beispiel unter Arbeiten mit der Datei LicensingSettings.xml. Sie können auch die InitializeEngine-Funktion oder die Methode der IEngineLoader-Schnittstelle verwenden.
- Kopieren Sie das Lizenz-Token in den Standardordner auf jeder Workstation oder in einen Ordner, dessen Pfad Ihre Anwendung in der Funktion InitializeEngine verwendet.
Erstellen einer LicensingSettings.xml-Datei:
Erstellen Sie eine LicensingSettings.xml-Datei, und konfigurieren Sie dabei denselben Verbindungsprotokolltyp, den Sie für den Server angegeben haben, sowie die Serveradresse:Kopieren der konfigurierten Datei LicensingSettings.xml:
Kopieren Sie die konfigurierte Datei LicensingSettings.xml auf jeder Workstation in den Ordner mit den ABBYY FineReader Engine-Dateien neben FREngine.dll:Hinweis: Wenn der Lizenzserver auch als Workstation fungiert, muss die Datei LicensingSettings.xml für den Server sowohl die Tags LicensingServers als auch LocalLicenseServer enthalten, ähnlich wie oben angegeben. Der Inhalt der Datei sieht dann folgendermaßen aus:Softwareschutz
Softwareschutz
In diesem Szenario installieren Sie Ihre Anwendung, die die ABBYY FineReader Engine-Bibliothek verwendet, manuell auf einem Server und auf Arbeitsstationen, die über ein Netzwerk mit diesem Server verbunden sind. Sie benötigen:Standardmäßig wird der TCP/IP-Port 3022 verwendet. Wenn dieser Port auf Ihrem Server geschlossen ist, geben Sie einen anderen offenen Port an:Wenn Sie für den Server einen anderen TCP/IP-Port festgelegt haben, nehmen Sie hier dieselbe Einstellung vor.
- die Seriennummer einer Network Runtime-Lizenz.
Um die Erstellung eines benutzerdefinierten Pakets zu vereinfachen, extrahieren Sie die Dateien mit der Option /extract für installRnt**.exe oder installLS.exe über die Befehlszeile aus dem Distribution-Paket in einen bestimmten Ordner, ohne die Installation auszuführen. Darin finden Sie die folgenden Ordner:
-
für installRnt**.exe:
- FineReader Engine - mit den Dateien von ABBYY FineReader Engine
- Inc - mit der FREngine.tlb (zur Registrierung der FREngine.dll)
- Licensing - mit den Dateien des Licensing Service
-
für installLS.exe:
- Licensing - mit den Dateien des Licensing Service
- License Server - mit den Dateien des Lizenzservers
Erstellen der ABBYY FineReader Engine-Pakete auf Ihrem Computer:
-
Bibliothekspaket. Dabei handelt es sich um einen Ordner mit den ABBYY FineReader Engine-Dateien, die im Abschnitt ABBYY FineReader Engine Distribution Kit der Developer-Hilfe aufgeführt sind. Die Liste enthält:
- Dateien, die im ABBYY FineReader Engine Distribution Kit als “obligatorisch” gekennzeichnet sind. Dabei handelt es sich um Systemmodule und Haupterkennungsdatenbanken.
- Erkennungsdatenbanken für von Hand in Druckbuchstaben geschriebenen Text, wenn Sie solchen Text erkennen möchten.
- Ressourcendateien für Benutzeroberflächensprachen, die in Ihrer Anwendung verwendet werden sollen.
- Wörterbuch-Supportdateien für Erkennungssprachen, die Ihre Anwendung unterstützt. Wenn die Erkennungssprachen Sprachen mit lateinischem Alphabet umfassen, stellen Sie sicher, dass Sie die Dateien Univers.amd und Univers.amm auswählen.
- Scanmodule, scanspezifische Ressourcen und TWAIN-Module, wenn Ihre Anwendung das Scannen über die ABBYY FineReader Engine-Schnittstelle ausführt.
- Windows Visual Components-Module und die entsprechenden spezifischen Ressourcen, wenn Ihre Anwendung ABBYY FineReader Engine Visual Components verwendet.
-
Lizenzserver-Paket. Es besteht aus zwei Ordnern mit den Dateien für den Licensing Service und das License Manager Utility:
- Licensing Service-Ordner mit allen Dateien aus dem entpackten Ordner Licensing.
- License Manager (License Manager64)-Ordner mit den folgenden Dateien aus dem entpackten Ordner Lizenzserver: AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
-
Weitere Softwarekomponenten:
- KB2999226-Update oder Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Wenn Sie das Windows-Updatepaket nicht installieren, können Sie das Redistributable aus dem Ordner External Components\VC_Redist im Distribution-Paket installieren: vc_redist.x86.exe und vc_redist.x64.exe.
- .NET Framework 4.6.2, wenn Sie das Modul OfficeConverters verwenden möchten.
Installieren des Licensing Service auf dem Lizenzserver:
- Kopieren Sie das Lizenzserver-Paket und Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 auf den Lizenzserver.
- Installieren Sie Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- Kopieren Sie die Ordner aus dem Lizenzserver-Paket in das Verzeichnis auf dem Lizenzserver, in dem der Licensing Service installiert werden soll.
Wir empfehlen, die Dateien von ABBYY FineReader Engine in einer übersichtlichen, leicht auffindbaren Ordnerstruktur abzulegen. Siehe folgendes Beispiel:
- <YourApplicationFolder>/Lizenzserver/Licensing Service.
- <YourApplicationFolder>/Lizenzserver/License Manager (License Manager64).
- Erstellen Sie einen Ordner zum Speichern der Lizenzdaten (standardmäßig den Ordner %ProgramData%\ABBYY\SDK\12\Licenses). Jeder Benutzer, der Ihre Anwendung ausführt, muss Vollzugriff auf diesen Ordner haben. Ein Beispiel zum Festlegen des Ordners für Lizenzdaten finden Sie unter Arbeiten mit der Datei LicensingSettings.xml.
- Erstellen Sie eine LicensingSettings.xml-Datei. Das XML-Schema, dem sie entsprechen muss, finden Sie in der Datei LicensingSettings.xml, die sich im Ordner Inc Ihrer Developer-Installation oder im Ordner CADF\Inc im Distribution-Paket befindet. In dieser Datei müssen Sie den Typ des Verbindungsprotokolls festlegen, das Ihr Lizenzserver verwendet. Die unterstützten Typen sind LocalInterprocessCommunication, NamedPipes, TCP/IP und Sockets:
-
Kopieren Sie die konfigurierte Datei LicensingSettings.xml in folgende Ordner:
- Licensing Service.
- License Manager (License Manager64).
- Führen Sie LicensingService.exe mit dem Parameter “/install” aus:
Sie haben außerdem die Möglichkeit, eine Konfiguration mit zwei Servern einzurichten, bei der einer der Lizenzserver als Backup für den anderen dient, falls dieser ausfällt. Weitere Informationen finden Sie unter Weitere Informationen finden Sie unter Einrichten einer redundanten Lizenzserver-Konfiguration.
Aktivierung der Lizenz auf dem Lizenzserver:
Führen Sie LicenseManager.exe aus. Klicken Sie auf die Schaltfläche Activate License… und folgen Sie den Anweisungen des Assistenten, um Ihre Lizenz zu aktivieren. Wenn Ihr Server über einen Internetzugang verfügt, müssen Sie lediglich die Seriennummer eingeben und einen Moment warten. Weitere Informationen zum License Manager finden Sie unter License Manager Utility.Sie können die Lizenz auch über die Befehlszeile aktivieren. Weitere Informationen finden Sie unter Arbeiten mit dem License Manager über die Befehlszeile..Installation der ABBYY FineReader Engine-Bibliothek auf den Arbeitsstationen:
Wenn der Lizenzserver auch als Workstation verwendet werden soll, führen Sie diesen Schritt auch auf dem Server aus.
- Kopieren Sie das Bibliothekspaket und die Softwarekomponenten auf all Ihre Arbeitsstationen.
Die einfachste Möglichkeit, sicherzustellen, dass alle Ressourcendateien vom Programm gefunden werden, besteht darin, dieselbe Ordnerstruktur beizubehalten und die Datei SharedFiles.ini, die Sie je nach Betriebssystem im Ordner Bin (oder Bin64) finden, in Ihr Distribution Package aufzunehmen. Wenn Sie diese Datei nicht verwenden möchten, gehen Sie statt der Beibehaltung der Ordnerstruktur wie folgt vor:
- Kopieren Sie den Ordner Data\Resource mit allen Unterordnern in den folgenden Ordner:
- Bin
- Bin64
- Kopieren Sie den Inhalt des Ordners Data\ExtendedDictionaries direkt in den Ordner Bin oder Bin64.
- Kopieren Sie die übrigen Dateien aus dem Ordner Data in den Ordner Bin oder Bin64.
-
Installieren Sie die erforderlichen Softwarekomponenten:
- Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- .NET Framework, falls erforderlich.
- Kopieren Sie den Ordner mit den ABBYY FineReader Engine-Dateien aus dem Bibliothekspaket in das Verzeichnis auf der Workstation, in dem die Bibliothek gespeichert werden soll.
-
Registrieren Sie die benötigten dynamischen Bibliotheken:
- Wenn Ihre Anwendung das Engine-Objekt mithilfe der IEngineLoader-Schnittstelle lädt, registrieren Sie FREngine.dll mit der folgenden Befehlszeile:
- Wenn Ihre Anwendung Visual Components verwendet, registrieren Sie VisualComponentsX.dll mithilfe der folgenden Befehlszeile:
-
Erstellen Sie die Ordner, die von ABBYY FineReader Engine verwendet werden. In der folgenden Liste sind die Standardwerte für diese Ordner aufgeführt:
- Ordner %ProgramData%\ABBYY\SDK\12\FineReader Engine (Vollzugriff erforderlich)
- Ordner %ProgramData%\ABBYY\SDK\12\Licenses (Vollzugriff für den Lizenzserver erforderlich, für Arbeitsstationen optional)
Um den Ordner für die Lizenzdaten während der Installation anzugeben, finden Sie ein Beispiel unter Arbeiten mit der Datei LicensingSettings.xml. Sie können auch die Funktion InitializeEngine oder eine Methode der Schnittstelle IEngineLoader verwenden.
Erstellen einer LicensingSettings.xml-Datei:
Erstellen Sie eine LicensingSettings.xml-Datei, und legen Sie dabei denselben Verbindungsprotokolltyp fest, den Sie für den Server angegeben haben, sowie die Adresse des Servers:Kopieren der konfigurierten Datei LicensingSettings.xml:
Kopieren Sie die konfigurierte Datei LicensingSettings.xml auf jeder Workstation in den Ordner mit den ABBYY FineReader Engine-Dateien neben FREngine.dll:Wenn der Lizenzserver auch als Workstation fungieren soll, muss die Datei LicensingSettings.xml auf dem Server sowohl die Tags LicensingServers als auch LocalLicenseServer enthalten, ähnlich wie oben beschrieben. Der Inhalt der Datei sieht dann wie folgt aus: