> ## 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.

# Installieren des Licensing Service unter Linux

> Installieren Sie den ABBYY FineReader Engine Licensing Service unter Linux manuell für Standalone- oder Network-Deployments mit systemd- oder SysVinit-Konfiguration für den automatischen Start.

Für den ordnungsgemäßen Betrieb von Anwendungen, die ABBYY FineReader Engine 12 verwenden, ist der Licensing Service erforderlich.

Der Licensing Service wird bei der Developer- und Runtime-Installation im automatischen Modus automatisch installiert. Wenn Sie die manuelle Installation verwenden, befolgen Sie die nachstehenden Anweisungen. Führen Sie nach Abschluss der Installation des Licensing Service die [License Manager Utility](/de/fine-reader/engine/licensing/license-manager-utility) aus, um Lizenzen zu verwalten.

<Note>
  Der Licensing Service verwendet standardmäßig die systemd-Software-Suite und unterstützt auch die Verwendung des SysVinit-Daemons. Wenn Sie SysVinit durch systemd ersetzen möchten, deinstallieren Sie Ihre alte Distribution mit dem Skript uninstallfre.sh und installieren Sie die neue Distribution mit dem Skript activatefre.sh (siehe [Installieren der ABBYY FineReader Engine-Bibliothek](/de/fine-reader/engine/distribution/distribution-linux/installing-the-library-linux)). Wenn Sie die Distribution mit systemd deinstallieren möchten, während die Distribution mit SysVinit noch installiert ist, führen Sie die folgenden Befehle aus:
</Note>

```bash theme={null}
$ systemctl disable abbyy-fre12-licensing-service
$ systemctl stop abbyy-fre12-licensing-service
$ rm -rf /usr/local/{bin,lib}/ABBYY/SDK/12/Licensing
```

Deinstallieren Sie anschließend das Distributionspaket mit dem Skript uninstallfre.sh.

Die Einstellungen des Licensing Service sind in der Datei LicensingSettings.xml hinterlegt. Diese Datei wird bei der automatischen Installation automatisch generiert. Bei der manuellen Installation müssen Sie diese Datei in den Ordnern Bin und CommonBin/Licensing erstellen und die korrekten Einstellungen darin angeben. Das XML-Schema der Licensing-Service-Einstellungen ist in der Datei LicensingSettings.xsd beschrieben. Diese Datei finden Sie im Ordner [Inc](/de/fine-reader/engine/distribution/distribution-linux/distribution-kit-linux#incsamples). Eine ausführliche Beschreibung der Einstellungen finden Sie im Abschnitt [Arbeiten mit der Datei LicensingSettings.xml](/de/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file).

* Wir empfehlen, den Licensing Service im manuellen Modus ausschließlich bei der Runtime-Installation (bzw. -Deinstallation) zu installieren (bzw. zu deinstallieren). Für Entwicklungszwecke verwenden Sie die standardmäßige Installation und Deinstallation.
* Verwenden Sie ABBYY FineReader Engine und den Licensing Service stets aus demselben Paket. Andernfalls ist die Kompatibilität nicht gewährleistet.

<div id="installing-in-manual-mode">
  ## Installation im manuellen Modus
</div>

<Warning>
  Der Licensing Service sollte unter ROOT installiert werden.
</Warning>

Für die Standalone-Installation:

1. Kopieren Sie die Dateien für den Licensing Service und das License Manager Utility auf die Workstation. Linux: libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService und LicenseManager.Console. Kopieren Sie die Ressourcendateien libProtectionRes\*.so für die benötigten Oberflächensprachen sowie libProtectionResShared.so

Windows: 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.

1. Erstellen Sie einen Ordner zum Speichern der Lizenzdaten (standardmäßig %ProgramData%\ABBYY\SDK\12\Licenses). Alle Benutzer müssen vollständige Zugriffsberechtigungen auf diesen Ordner haben.

2. Für Online License: Erstellen oder wählen Sie einen Ordner, in dem Ihre Anwendung nach der License-Token-Datei sucht, und legen Sie die Token-Datei dort ab. Sie können den Ordner %ProgramData%\ABBYY\SDK\12\Licenses verwenden (Standardverhalten) oder einen anderen Ordner zum Speichern der Lizenzdaten. Alle Benutzer müssen vollständige Zugriffsberechtigungen auf diese Ordner haben.

3. Geben Sie bei Bedarf die Parameter des LocalLicenseServer in der Datei LicensingSettings.xml an (siehe [Arbeiten mit der Datei LicensingSettings.xml](/de/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file)).

4. Starten Sie den LicensingService:

5. Erstellen Sie den Ordner /var/run/abbyy-licensing-daemon/ mit Lese- und Schreibberechtigungen ausschließlich für den Root-Benutzer.

6. Starten Sie den LicensingService mit folgendem Befehl:

```
LicensingService /start
```

Die Umgebungsvariable LD\_LIBRARY\_PATH sollte auf den Pfad zum Ordner mit den kopierten Bibliotheken gesetzt werden.

Um den Dienst bei jedem Systemstart auszuführen, registrieren Sie ihn in Ihrem Init-System, z. B. als Daemon.

Wenn Sie das systemd-Init-System verwenden:

1. Erstellen Sie die Konfigurationsdatei abbyy-fre12-licensing-service.service und legen Sie sie im Ordner /etc/systemd/system/ ab. Die Dateiberechtigungen sollten 664 sein (Lesen & Schreiben für den Eigentümer (root) & die Benutzergruppe, Lesen für andere). Beispieldatei:

```
[Unit]
Description=abbyy-fre12-licensing-service: Provides managements of ABBYY SDK 12 Licensing Service
After=network.target
 
[Service]
Type=forking
Environment="LD_LIBRARY_PATH=/usr/local/lib/ABBYY/SDK/12/Licensing"
ExecStartPre=/bin/mkdir -p /var/run/abbyy-licensing-daemon
ExecStart=/usr/local/bin/ABBYY/SDK/12/LicensingService /start
ExecStop=/usr/local/bin/ABBYY/SDK/12/LicensingService /stop
ExecReload=/usr/local/bin/ABBYY/SDK/12/LicensingService /stop
ExecReload=/usr/local/bin/ABBYY/SDK/12/LicensingService /start
 
[Install]
WantedBy=multi-user.target
```

2. Aktualisieren Sie die Dienstliste:

```bash theme={null}
$ systemctl daemon-reload
```

3. Automatischen Start des Dienstes beim Systemstart aktivieren.

```bash theme={null}
$ systemctl enable abbyy-fre12-licensing-service
```

4. Führen Sie LicensingService aus.

```bash theme={null}
$ systemctl start abbyy-fre12-licensing-service
```

Wenn Sie das SysVinit- oder Upstart-Init-System verwenden:

1. Erstellen Sie die Konfigurationsdienstdatei abbyy-fre12-licensing-service.sh und legen Sie sie im Ordner /etc/init.d/ ab. Die Dateiberechtigungen sollten 755 sein (Lesen, Schreiben, Ausführen für den Eigentümer (root), Lesen & Ausführen für Benutzergruppe und andere). Dateibeispiel:

```
#! /bin/sh
### BEGIN INIT INFO
# Provides:          abbyy-fre12-licensing-service
# Required-Start:    $all
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: ABBYY SDK 12 Licensing Service starten
# Description:       Verwaltung des ABBYY SDK 12 Licensing Service
### END INIT INFO
 
export LD_LIBRARY_PATH=/usr/local/lib/ABBYY/SDK/12/Licensing:$LD_LIBRARY_PATH
 
set -e
 
case $1 in
  start)
    mkdir -p /var/run/abbyy-licensing-daemon
    /usr/local/bin/ABBYY/SDK/12/LicensingService /start
    ;;
  stop)
    /usr/local/bin/ABBYY/SDK/12/LicensingService /stop
    ;;
  restart|force-reload)
    $0 stop
    $0 start
    ;;
  status)
    /usr/local/bin/ABBYY/SDK/12/LicensingService --status=$0
    ;;
  *)
    echo "Verwendung: $0 {start|stop|restart|force-reload|status}" >&2
    exit 1
    ;;
esac
```

1. Aktivieren Sie den Ladedienst beim Systemstart.

Für SysVinit:

```bash theme={null}
$ chkconfig --add abbyy-fre12-licensing-service
```

Für Upstart:

```
update-rc.d abbyy-fre12-licensing-service defaults
```

1. Führen Sie LicensingService aus.

```bash theme={null}
$ service abbyy-fre12-licensing-service start
```

<Note>
  SELinux kann den korrekten Betrieb des Licensing Service beeinträchtigen. Wenn Lizenzierungsfehler auftreten, führen Sie den folgenden Befehl mit dem tatsächlichen Pfad zum LicensingService aus:
</Note>

```
chcon -u system_u -t bin_t /path/to/LicensingService
```

Für die Network installation:

1. Installieren Sie den Licensing Service auf dem license server:
   1. Kopieren Sie die Dateien für den Licensing Service und das License Manager Utility auf einen Computer, der als license server verwendet werden soll.Linux: libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService und LicenseManager.Console. Kopieren Sie die Ressourcendateien libProtectionRes\*.so für die benötigten Oberflächensprachen sowie libProtectionResShared.so

Windows: 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..

1. Erstellen Sie einen Ordner zum Speichern der Lizenzdaten (standardmäßig der Ordner %ProgramData%\ABBYY\SDK\12\Licenses). Alle Benutzer müssen vollständige Zugriffsberechtigungen auf diesen Ordner haben.

2. Erstellen Sie eine LicensingSettings.xml-Datei für den Lizenzserver.

3. Geben Sie in der LicensingSettings.xml-Datei die Einstellungen entsprechend dem Lizenztyp an (siehe [Arbeiten mit der Datei LicensingSettings.xml](/de/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file) für Details):
   * Für Online License: das OnlineLicensing-Tag, wenn Sie eine Online License mit einem Proxyserver verwenden möchten. In allen anderen Fällen der Einrichtung einer Online License überspringen Sie diesen Schritt.

4. Kopieren Sie die konfigurierte LicensingSettings.xml-Datei auf den Lizenzserver in den Ordner, in dem der Licensing Service installiert ist.

5. Konfigurieren Sie die Verbindung zwischen dem Lizenzserver und den Arbeitsstationen:
   1. Für Online License: Erstellen oder wählen Sie auf allen Arbeitsstationen einen Ordner, in dem Ihre Anwendung nach der Lizenztokendatei sucht, und legen Sie die Tokendatei dort ab. Sie können den Ordner %ProgramData%\ABBYY\SDK\12\Licenses verwenden (Standardverhalten) oder einen anderen Ordner zum Speichern der Lizenzdaten. Alle Benutzer müssen vollständige Zugriffsberechtigungen auf diese Ordner haben.
   2. Erstellen Sie die LicensingSettings.xml-Datei für die Arbeitsstationen.
   3. Geben Sie in der LicensingSettings.xml-Datei die Einstellungen entsprechend dem Lizenztyp an (siehe [Arbeiten mit der Datei LicensingSettings.xml](/de/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file) für Details):
      * Die Attribute ServerAddress und ProtocolType des MainNetworkLicenseServer-Tags.
   4. Kopieren Sie die konfigurierte LicensingSettings.xml-Datei auf alle Arbeitsstationen in den Ordner /opt/ABBYY/FREngine12/Bin/, in dem der License Manager installiert ist.
   5. Starten Sie den LicensingService wie in [Schritt 5](/de/fine-reader/engine/distribution/distribution-linux/activating-the-library-linux/installing-the-licensing-service-on-linux#run_ls) der Standalone-Installation beschrieben.

Wenn Sie den Licensing Service als Nicht-Root-Benutzer ausführen möchten, starten Sie ihn bei jedem Systemstart manuell:

1. Erstellen Sie die Datei start\_licensing\_service.sh und legen Sie sie im Ordner \<FRE\_installation\_directory>/CommonBin/Licensing ab. Beispiel für die Datei:

```
#!/bin/bash
export LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing
pgrep LicensingServic || exec <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone
```

2. Starten Sie den Licensing Service mit dem Befehl:

als Daemon

```
run "<FRE_installation_directory>/Bin/ServiceWrapper <FRE_installation_directory>/CommonBin/Licensing/start_licensing_service.sh"
```

als Anwendung

```
run "LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone"
```

<div id="see-also">
  ## Siehe auch
</div>

[Aktivierung](/de/fine-reader/engine/licensing/activation)

[Distribution - Linux](/de/fine-reader/engine/distribution/distribution-linux)

[Arbeiten mit der Datei LicensingSettings.xml](/de/fine-reader/engine/licensing/working-with-the-licensingsettingsxml-file)