Dokument | OCR & Barcode (ocr engine) auf Debian Linux installieren und aktualisieren

Für welche Version verfügbar?
• agorum core pro

Diese Dokumentation beschreibt, wie Sie die Dokument | OCR & Barcode (ocr engine) auf einem Debian-Linux-Betriebssystem installieren und aktualisieren.

Dokument | OCR & Barcode (ocr engine) auf Debian Linux installieren

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

Variante A: Debian 13 (Trixie) vorbereiten (WineHQ stable + Winetricks + .NET 4.0)

Hinweis: Für Debian 13 (Trixie) wird das WineHQ-Repository über einen Keyring in /etc/apt/keyrings und eine .sources-Datei eingebunden. apt-key wird hierfür nicht verwendet.

Wechseln Sie auf den Root-Benutzer.
Führen Sie die folgenden Befehle aus.

su -
dpkg --add-architecture i386

wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/trixie/winehq-trixie.sources

apt update
apt install --install-recommends winehq-stable

wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
chmod +x winetricks
WINEDEBUG=-all ./winetricks -q --unattended dotnet40

Tipp: Falls Probleme auftreten, helfen häufig die folgenden Punkte:

Verzeichnis fehlt: Existiert /etc/apt/keyrings nicht, legen Sie es an (z. B. mkdir -p /etc/apt/keyrings).
HTTPS-Downloads schlagen fehl: Stellen Sie sicher, dass ca-certificates installiert ist (z. B. apt install -y ca-certificates).
Proxy-Umgebung: Wenn Ihr Server einen Proxy nutzt, stellen Sie sicher, dass wget/apt die Proxy-Variablen kennen (z. B. http_proxy/https_proxy).
Winetricks / dotnet40: Die Installation kann je nach Server einige Minuten dauern. Führen Sie Winetricks bei Bedarf erneut aus.

Variante B: Debian 12 (Bookworm) / ältere Releases vorbereiten

Hinweis: Diese Variante verwendet apt-key und einen klassischen sources.list-Eintrag. Das ist für neuere Debian-Versionen (z. B. Debian 13/Trixie) nicht mehr die empfohlene Vorgehensweise.

Das Release (z. B. Debian 12) erhalten Sie mit dem Kommando lsb_release -a.

Für andere Distributionen muss Wine ggf. anders installiert werden. Weitere Informationen zu Wine finden Sie bei WineHQ.

Führen Sie auf Ihrem agorum core Linux-Server (z. B. per PuTTY) die folgenden Befehle aus.

mkdir /opt/agorum/wine
cd /opt/agorum/wine
dpkg --add-architecture i386
wget -nc https://dl.winehq.org/wine-builds/winehq.key

apt-key add winehq.key
# ACHTUNG: Für debian stretch (Release < 12) diesen echo-Befehl verwenden
# echo "deb http://dl.winehq.org/wine-builds/debian/ stretch main" >> /etc/apt/sources.list
# debian bookworm (Release >= 12) diesen echo-Befehl verwenden
echo "deb http://dl.winehq.org/wine-builds/debian/ bookworm main" >> /etc/apt/sources.list
apt update

apt -y install --install-recommends winehq-stable

# winetricks installieren
wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks

# dotnet 4.0 installieren
export WINEDEBUG=-all
chmod 700 winetricks
./winetricks -q --unattended dotnet40

Die OCR-Engine auf Debian Linux installieren

Laden Sie in Windows die OCR-Engine als ZIP-Paket herunter.
Fügen Sie das ZIP-Paket etwa mit WinSCP in folgenden Ordner auf Ihrem agorum core Linux-Server ein:
```
/opt/agorum/agorumcore
```

Führen Sie etwa mit PuTTY folgende Befehle auf dem agorum core Linux-Server aus:

cd /opt/agorum/agorumcore
unzip agorumcoreocr-linux.zip
rm agorumcoreocr-linux.zip
mv agorumcoreocr-linux ocr

Die OCR-Engine auf Debian Linux testen

Führen Sie auf Ihrem agorum core Linux-Server etwa mit PuTTY folgende Befehle aus.
```
# Aufruf
cd /opt/agorum/agorumcore/ocr/bin
export WINEDEBUG=-all
wine ReadIRISOCRConverter.exe
```
Ergebnis:

• Sie erhalten eine Auflistung der Argumente für die OCR-Engine.
• Die OCR-Engine ist serverseitig installiert. Fahren Sie mit der Installation der OCR-Engine in agorum core fort.

Die OCR-Engine in agorum core installieren

Laden Sie die OCR-Engine-Einstellungen als ZIP-Paket herunter.
Installieren Sie in agorum core das heruntergeladene ZIP-Paket über das agorum core support tool.

Dokument | OCR & Barcode (ocr engine) Debian Linux aktualisieren

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

Beenden Sie agorum core, sodass kein Prozess mehr die OCR-Engine verwendet.
Löschen Sie das gesamte Verzeichnis ocr mit folgendem Befehl:
```
cd /opt/agorum/agorumcore
rm -Rf ocr
```
Laden Sie die neue Version der OCR-Engine als ZIP-Paket herunter und übertragen Sie diese in folgendes Verzeichnis:
```
/opt/agorum/agorumcore
```

Führen Sie folgende Befehle auf Ihrem agorum core Server aus:

cd /opt/agorum/agorumcore
unzip agorumcoreocr-linux.zip
rm agorumcoreocr-linux.zip
mv agorumcoreocr-linux ocr

Starten Sie agorum core.