Zum Hauptinhalt springen

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.

Dieser Abschnitt enthält Anleitungen zur manuellen Installation Ihrer Anwendung auf einer lokalen Workstation.
Eine manuelle Standalone-Installation ist nur möglich, wenn Sie Software oder Online protection verwenden.
In diesem Szenario stellen Sie Ihre Anwendung auf einer Cloud-Instanz, einer privaten virtuellen Maschine oder einer lokalen Workstation bereit – mithilfe eines Installationsprogramms Ihrer Wahl, eines Shell-Skripts oder durch manuelles Kopieren der Dateien. Sie benötigen:
  • eine Online-Lizenz-Token-Datei (mit einem Dateinamen wie SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Für den Betrieb der Anwendung ist eine Internetverbindung erforderlich.
Wir empfehlen, ein ABBYY FineReader Engine-Paket zu erstellen (nachfolgend als „Paket” bezeichnet) – einen Ordner mit den Dateien, die für den Betrieb und die Lizenzierung von ABBYY FineReader Engine erforderlich sind.
Um das Erstellen eines benutzerdefinierten Pakets zu vereinfachen, entpacken Sie die Dateien mithilfe 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 befinden sich die folgenden Ordner:
  1. für installRnt**.exe:
    • FineReader Engine - mit den Dateien von ABBYY FineReader Engine
    • Inc - mit der FREngine.tlb (zum Registrieren der FREngine.dll)
    • Licensing - mit den Dateien des Licensing Service
  2. für installLS.exe:
    • Licensing - mit den Dateien des Licensing Service
    • License Server - mit den Dateien des License Server
Verwenden Sie diese Ordner und die nachstehende Anleitung, um Ihr License Server-Paket zu erstellen.

​
Zum Paket auf Ihrem Computer hinzufügen:

  1. 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 “mandatory” gekennzeichnet sind. Dabei handelt es sich um Systemmodule und zentrale Erkennungsdatenbanken.
    • Erkennungsdatenbanken für handgeschriebene Druckschrift, wenn Sie solche Texte erkennen möchten.
    • Ressourcendateien für Benutzeroberflächensprachen, die in Ihrer Anwendung verwendet werden.
    • Wörterbuchdateien 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.
    • Scanmodule, scanspezifische Ressourcen und TWAIN-Module, wenn Ihre Anwendung Scans über die ABBYY FineReader Engine-Schnittstelle durchführt.
    • Windows Visual Components-Module und die zugehörigen spezifischen Ressourcen, wenn Ihre Anwendung ABBYY FineReader Engine Visual Components verwendet.
Sie können die Dateiliste auch automatisch erstellen – mithilfe der Datei FREngineDistribution.csv und des entpackten FineReader Engine-Ordners.
  1. Lizenzserver-Paket. Es besteht aus zwei Ordnern mit den Dateien des Licensing Service und der License Manager Utility:
    • Ordner Licensing Service mit allen Dateien aus dem entpackten Ordner „Licensing“.
    • Ordner License Manager (License Manager64) 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.
Verwenden Sie ABBYY FineReader Engine und Lizenzserver aus demselben Paket. Andernfalls ist die Kompatibilität nicht gewährleistet.
  1. Weitere Softwarekomponenten:
    • das KB2999226-Update oder Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Wenn Sie das Windows-Update-Paket nicht installieren, können Sie stattdessen 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.

​
Kopieren des Pakets auf der Workstation:

Am einfachsten stellen Sie sicher, dass alle Ressourcendateien vom Programm gefunden werden, indem Sie dieselbe Ordnerstruktur beibehalten und die Datei SharedFiles.ini in Ihr Distributionspaket aufnehmen, die Sie je nach Betriebssystem im Ordner Bin (or Bin64) finden. 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.

​
Installation der erforderlichen Softwarekomponenten:

  1. Das Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
  2. .NET Framework, falls es erforderlich ist.
Sie müssen den Ordner mit den ABBYY FineReader Engine-Dateien aus dem Bibliothekspaket in das Verzeichnis auf der Workstation kopieren, in dem die Bibliothek erwartet wird.

​
Registrieren der dynamischen Bibliotheken:

  1. Wenn Ihre Anwendung das Engine-Objekt mithilfe der IEngineLoader-Schnittstelle lädt, registrieren Sie FREngine.dll mit der folgenden Befehlszeile:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"
  1. Wenn Ihre Anwendung Visual Components verwendet, registrieren Sie VisualComponentsX.dll mit der folgenden Befehlszeile:
regsvr32 /s "<path to VisualComponentsX.dll>"
Falls bei der Verwendung von COM-Loadern oder bei der Arbeit mit Visual Components Probleme auftreten, prüfen Sie bitte die Pfade zu diesen Komponenten in der Registry und wiederholen Sie bei Fehlern die Registrierung.
Erstellen der 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 (Vollzugriffsberechtigung erforderlich)
  • Ordner %ProgramData%\ABBYY\SDK\12\Licenses (Vollzugriff ist für den Lizenzserver erforderlich, für Arbeitsstationen optional)
Um den Ordner für Lizenzdaten während der Installation anzugeben, finden Sie ein Beispiel in Arbeiten mit der Datei LicensingSettings.xml. Sie können auch die InitializeEngine-Funktion oder eine Methode der IEngineLoader-Schnittstelle verwenden.

​
Lizenzserver installieren:

Für die Installation sind Administratorrechte erforderlich.
  1. Kopieren Sie die Ordner aus dem Lizenzserver-Paket in das Verzeichnis auf der Workstation, auf der der Lizenzserver installiert werden soll.
Wir empfehlen, ABBYY FineReader Engine-Dateien in einer leicht auffindbaren und einfach nutzbaren Ordnerstruktur abzulegen. Siehe folgendes Beispiel:
  • <YourApplicationFolder>/ABBYY FineReader Engine-Bibliothek.
  • <YourApplicationFolder>/Lizenzserver/Licensing Service.
  • <YourApplicationFolder>/Lizenzserver/License Manager (License Manager64).
  1. Erstellen oder wählen Sie einen Ordner, in dem Ihre Anwendung nach der Lizenz-Token-Datei sucht, und legen Sie die Token-Datei dort ab. Sie können %ProgramData%\ABBYY\SDK\12\Licenses wählen, was dem Standardverhalten entspricht, oder einen anderen Ordner zum Speichern der Lizenzdaten. Für diese Ordner muss die Gruppe „Jeder“ über Vollzugriff verfügen.
  2. Erstellen Sie eine LicensingSettings.xml-Datei mit dem nachstehend aufgeführten Inhalt. Weitere Informationen finden Sie unter Arbeiten mit der Datei LicensingSettings.xml 
<LocalLicenseServer>
    <ConnectionProtocol ProtocolType="<Protocol type>" />
  </LocalLicenseServer>
Geben Sie das Tag OnlineLicensing nur an, wenn Sie eine Online-Lizenz mit einem Proxy-Server verwenden (in anderen Fällen lassen Sie dieses Tag weg), und belassen Sie alle anderen Einstellungen auf dem Standardwert (nehmen Sie sie nicht in Ihre Datei auf). Das XML-Schema, dem sie entsprechen muss, finden Sie in der Datei LicensingSettings.xsd, die sich im Ordner Inc Ihrer Developer-Installation oder im Ordner CADF\Inc des Distribution-Pakets befindet.
  1. Kopieren Sie die konfigurierte LicensingSettings.xml-Datei in die folgenden Ordner:
    • Licensing Service.
    • License Manager (License Manager64).
    • Ordner mit den ABBYY FineReader Engine-Dateien neben FREngine.dll.
  2. Führen Sie LicensingService.exe mit dem Parameter “/install” aus: 
LicensingService.exe /install

​
Lizenz aktivieren:

Eine Online-Lizenz erfordert keine Aktivierung: Die Lizenzinformationen werden zur Laufzeit der Anwendung vom ABBYY Online-Lizenzierungsdienst empfangen. Zur Autorisierung sendet die Anwendung eine Token-Datei für die Lizenz sowie ein Lizenzkennwort. Sie müssen die Token-Datei an dem Speicherort ablegen, den die Anwendung erwartet. Dieser Speicherort muss vom Entwickler angegeben werden (Standard: %ProgramData%\ABBYY\SDK\12\Licenses).Zur Laufzeit muss die Anwendung regelmäßig eine Verbindung zum ABBYY Online-Lizenzierungsdienst herstellen, um Lizenzinformationen zu empfangen und Nutzungsstatistiken zu übermitteln. Es werden keine privaten Informationen mit ABBYY-Servern ausgetauscht.
  • Stellen Sie sicher, dass Sie Verbindungen zu *.abbyy.com über Port 443 (HTTPS) zulassen. Wenn die Verbindung unterbrochen wird, funktioniert die Anwendung nicht mehr, sobald ein bestimmter Wiederverbindungs-Timeout überschritten ist. Der Synchronisierungszeitraum und der Wiederverbindungs-Timeout sind spezifische Parameter jeder Online-Lizenz.
Stellen Sie sicher, dass das GoDaddy-Stammzertifikat im Zertifikatspeicher „Vertrauenswürdige Stammzertifizierungsstellen” der lokalen Maschine installiert ist. Weitere Informationen zum Zertifikat finden Sie auf der GoDaddy-Website.
Es ist nicht möglich, zwei oder mehr Online-Lizenzen gleichzeitig auf demselben Host zu verwenden. Wenn die Anwendung ausgeführt wird und die Verbindung zu den ABBYY-Lizenzierungsdiensten funktioniert, können Sie mithilfe der License Manager Utility Details zur aktuell aktiven Online-Lizenz anzeigen.
Kopieren Sie das Lizenz-Token in einen Standardordner auf jeder Workstation oder in einen Ordner, dessen Pfad von Ihrer Anwendung in der InitializeEngine-Funktion verwendet wird.
In diesem Szenario installieren Sie Ihre Anwendung, die die ABBYY FineReader Engine-Bibliothek verwendet, manuell auf einer lokalen Workstation. Sie benötigen:
  • die Seriennummer einer Standalone-Runtime-Lizenz.
Wir empfehlen, ein ABBYY FineReader Engine-Paket zu erstellen (nachfolgend als „Paket” bezeichnet) – einen Ordner mit den Dateien, die für den Betrieb und die Lizenzierung von ABBYY FineReader Engine erforderlich sind.
Um das Erstellen eines benutzerdefinierten Pakets zu vereinfachen, entpacken Sie die Dateien mithilfe 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 befinden sich die folgenden Ordner:
  1. für installRnt**.exe:
    • FineReader Engine - mit den Dateien von ABBYY FineReader Engine
    • Inc - mit der FREngine.tlb (zum Registrieren der FREngine.dll)
    • Licensing - mit den Dateien des Licensing Service
  2. für installLS.exe:
    • Licensing - mit den Dateien des Licensing Service
    • License Server - mit den Dateien des License Server
Verwenden Sie diese Ordner und die nachstehende Anleitung, um Ihr License Server-Paket zu erstellen.

​
Zum Paket auf Ihrem Computer hinzufügen:

  1. 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 “mandatory” gekennzeichnet sind. Dabei handelt es sich um Systemmodule und zentrale Erkennungsdatenbanken.
    • Erkennungsdatenbanken für handgeschriebene Druckschrift, wenn Sie solche Texte erkennen möchten.
    • Ressourcendateien für Benutzeroberflächensprachen, die in Ihrer Anwendung verwendet werden.
    • Wörterbuchdateien 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.
    • Scanmodule, scanspezifische Ressourcen und TWAIN-Module, wenn Ihre Anwendung Scans über die ABBYY FineReader Engine-Schnittstelle durchführt.
    • Windows Visual Components-Module und die zugehörigen spezifischen Ressourcen, wenn Ihre Anwendung ABBYY FineReader Engine Visual Components verwendet.
Sie können die Dateiliste auch automatisch erstellen – mithilfe der Datei FREngineDistribution.csv und des entpackten FineReader Engine-Ordners.
  1. Lizenzserver-Paket. Es besteht aus zwei Ordnern mit den Dateien des Licensing Service und der License Manager Utility:
    • Ordner Licensing Service mit allen Dateien aus dem entpackten Ordner „Licensing“.
    • Ordner License Manager (License Manager64) 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.
Verwenden Sie ABBYY FineReader Engine und Lizenzserver aus demselben Paket. Andernfalls ist die Kompatibilität nicht gewährleistet.
  1. Weitere Softwarekomponenten:
    • das KB2999226-Update oder Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Wenn Sie das Windows-Update-Paket nicht installieren, können Sie stattdessen 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.

​
Kopieren des Pakets auf der Workstation:

Am einfachsten stellen Sie sicher, dass alle Ressourcendateien vom Programm gefunden werden, indem Sie dieselbe Ordnerstruktur beibehalten und die Datei SharedFiles.ini in Ihr Distributionspaket aufnehmen, die Sie je nach Betriebssystem im Ordner Bin (or Bin64) finden. 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.

​
Installation der erforderlichen Softwarekomponenten:

  1. Das Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
  2. .NET Framework, falls es erforderlich ist.
Sie müssen den Ordner mit den ABBYY FineReader Engine-Dateien aus dem Bibliothekspaket in das Verzeichnis auf der Workstation kopieren, in dem die Bibliothek erwartet wird.

​
Registrieren der dynamischen Bibliotheken:

  1. Wenn Ihre Anwendung das Engine-Objekt mithilfe der IEngineLoader-Schnittstelle lädt, registrieren Sie FREngine.dll mit der folgenden Befehlszeile:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"
  1. Wenn Ihre Anwendung Visual Components verwendet, registrieren Sie VisualComponentsX.dll mit der folgenden Befehlszeile:
regsvr32 /s "<path to VisualComponentsX.dll>"
Falls bei der Verwendung von COM-Loadern oder bei der Arbeit mit Visual Components Probleme auftreten, prüfen Sie bitte die Pfade zu diesen Komponenten in der Registry und wiederholen Sie bei Fehlern die Registrierung.

​
Erstellen der 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 (Vollzugriffsberechtigung erforderlich)
  • Ordner %ProgramData%\ABBYY\SDK\12\Licenses (Vollzugriff ist für den Lizenzserver erforderlich, für Arbeitsstationen optional)
Um den Ordner für Lizenzdaten während der Installation anzugeben, finden Sie ein Beispiel in Arbeiten mit der Datei LicensingSettings.xml. Sie können auch die InitializeEngine-Funktion oder eine Methode der IEngineLoader-Schnittstelle verwenden.

​
Lizenzserver installieren

Für die Installation sind Administratorrechte erforderlich.
  1. Kopieren Sie die Ordner aus dem Lizenzserver-Paket in das Verzeichnis auf der Workstation, auf der der Lizenzserver installiert werden soll.
Wir empfehlen, ABBYY FineReader Engine-Dateien in einer leicht auffindbaren und einfach nutzbaren Ordnerstruktur abzulegen. Siehe folgendes Beispiel:
  • <YourApplicationFolder>/ABBYY FineReader Engine-Bibliothek.
  • <YourApplicationFolder>/Lizenzserver/Licensing Service.
  • <YourApplicationFolder>/Lizenzserver/License Manager (License Manager64).
  1. Erstellen Sie eine Datei LicensingSettings.xml und geben Sie bei Bedarf Einstellungen im Tag LocalLicenseServer an. Das XML-Schema, dem sie entsprechen muss, finden Sie in der Datei LicensingSettings.xsd, die sich im Ordner Inc Ihrer Developer-Installation oder im Ordner CADF\Inc des Distribution-Pakets befindet. Weitere Informationen finden Sie unter Arbeiten mit der Datei LicensingSettings.xml
  2. Kopieren Sie die konfigurierte LicensingSettings.xml-Datei in die folgenden Ordner:
    • Licensing Service.
    • License Manager (License Manager64).
    • Ordner mit den ABBYY FineReader Engine-Dateien neben FREngine.dll.
  3. Führen Sie LicensingService.exe mit dem Parameter “/install” aus: 
LicensingService.exe /install

​
Lizenz aktivieren

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 Computer über einen Internetzugang verfügt, müssen Sie lediglich die Seriennummer eingeben und kurz 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.