{"id":98,"date":"2024-05-17T08:51:12","date_gmt":"2024-05-17T06:51:12","guid":{"rendered":"http:\/\/192.168.1.232\/index.php\/titel\/ddd\/"},"modified":"2024-07-06T13:51:30","modified_gmt":"2024-07-06T11:51:30","slug":"installation_biffo","status":"publish","type":"docs","link":"https:\/\/biffo.de\/index.php\/titel\/installation_biffo\/","title":{"rendered":"Installation biffo"},"content":{"rendered":"\n

Installation biffo<\/h2>\n\n\n\n

Die Installation von biffo sollte ohne gro\u00dfe Abh\u00e4ngigkeiten von statten gehen. F\u00fcr die Verwendung bzw. dessen Nutzung sind im Vorfeld einige Voraussetzungen zu schaffen. Im Folgenden wird beschrieben wie eine \u201eeinfache\u201c Installation lauff\u00e4hig ist. Das Beispiel beruht auf einer CentOS 7 Version bei der im Vorfeld noch ein \u201eyum update\u201c durchgef\u00fchrt wurde. Die Installation erfolgte unter dem Benutzer \u201eroot\u201c, daher entf\u00e4llt das vorgesetzte \u201esudo\u201c.<\/p>\n\n\n\n

Folgende Komponenten werden in dieser Beschreibung verwendet:
– yum-utils
– Tesseract 4.x
– wget
– Java 17
– Tomcat 7 (oder vergleichbar)
– PostgreSQL >= 9.x
– OpenSearch 2.x<\/p>\n\n\n\n

<\/div>\n\n\n\n

Installation Tesseract 4.x<\/strong><\/p>\n\n\n\n

Leider ist in dem aktuellen CentOS Repos nur die Version 3.x verf\u00fcgbar. Nachdem biffo nicht mit 3.x getestet wurde, sollte daher die Version 4.x installiert werden.<\/p>\n\n\n\n

Version 4.x wurde von dem Entwickler Alexander Pozdnyakov auf einem Open-Suse Repos bereitgestellt. Dieses Repository wird \u00fcber folgende Befehle eingebunden:<\/p>\n\n\n\n

Falls yum-utils noch nicht vorhanden sind:<\/p>\n\n\n\n

yum install yum-utils<\/code><\/pre>\n\n\n\n
Repository hinzuf\u00fcgen:<\/p>\n\n\n\n
yum-config-manager --add-repo https:\/\/download.opensuse.org\/repositories\/home:\/Alexander_Pozdnyakov\/CentOS_7\/<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Hinzuf\u00fcgen des Repository-Keys:<\/p>\n\n\n\n
rpm --import https:\/\/build.opensuse.org\/projects\/home:Alexander_Pozdnyakov\/signing_keys\/download?kind=gpg<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Update der lokalen Installation mittels yum update:<\/p>\n\n\n\n
yum update<\/code><\/pre>\n\n\n\n
Installation Tesseract mittels yum install:<\/p>\n\n\n\n
yum install tesseract<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wichtig ist hierbei das es sich um Version 4.x handelt. Die Aufforderung kann in diesem Fall mit \u201ey\u201c best\u00e4tigt werden.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Installation passendes Language-Pack mittels yum install:<\/p>\n\n\n\n
yum install tesseract-langpack-deu<\/code><\/pre>\n\n\n\n
Nach der Installation sollte \u00fcberpr\u00fcft werden, ob Tesseract auch gestartet werden kann:<\/p>\n\n\n\n
tesseract<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Zum Abschluss sollte auch \u00fcberpr\u00fcft werden, an welcher Stelle die Installation und das Daten-Verzeichnis abgelegt wurden. Die Werte sind wichtig f\u00fcr die anschlie\u00dfende Konfiguration.<\/p>\n\n\n\n
cd \/\nfind * | grep tessdata<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n
Installation Java >=17<\/strong><\/p>\n\n\n\n
Leider gestaltet sich die Installation von Java nicht mehr so einfach. Durch den Verzicht auf ein RPM seitens Oracle, muss man sich mit einigen Handgriffen besch\u00e4ftigen.<\/p>\n\n\n\n
Falls wget noch nicht installiert sein sollte:<\/p>\n\n\n\n
yum install wget<\/code><\/pre>\n\n\n\n
Im Beispiel wird als Installationsort der Ordner \/opt verwendet.<\/p>\n\n\n\n
cd \/opt<\/code><\/pre>\n\n\n\n
Download der Java Binaries von java.net:<\/p>\n\n\n\n
wget https:\/\/download.java.net\/java\/GA\/jdk17.0.2\/dfd4a8d0985749f896bed50d7138ee7f\/8\/GPL\/openjdk-17.0.2_linux-x64_bin.tar.gz<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Entpacken des Archivs:<\/p>\n\n\n\n
tar xvf openjdk-17.0.2_linux-x64_bin.tar.gz<\/code><\/pre>\n\n\n\n
Kopieren des JDK\u2019s an einen allgemeinen Ort:<\/p>\n\n\n\n
mv jdk-17.0.2\/ \/opt\/jdk-17\/<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Installation Tomcat > 7.x<\/strong><\/p>\n\n\n\n
Download des Tomcat-Application Servers mittels wget.<\/p>\n\n\n\n
wget https:\/\/archive.apache.org\/dist\/tomcat\/tomcat-7\/v7.0.99\/bin\/apache-tomcat-7.0.99.tar.gz<\/code><\/pre>\n\n\n\n
Entpacken des Archivs:<\/p>\n\n\n\n
tar xvf apache-tomcat-7.0.99.tar.gz<\/code><\/pre>\n\n\n\n
User, Gruppe und entsp. Rechte hinzuf\u00fcgen:<\/p>\n\n\n\n
groupadd tomcat\nuseradd -g tomcat tomcat\nchown -R tomcat:tomcat apache-tomcat-7.0.99<\/code><\/pre>\n\n\n\n
Erstellung tomcat.service Datei im Verzeichnis \/etc\/systemd\/system<\/p>\n\n\n\n
Diese Datei wird entsp. dem Verzeichnis indem sich der entpackte Tomcat Server befindet angepasst.<\/p>\n\n\n\n
Der Service kann dann \u00fcber systemctl enable tomcat.service eingetragen und \u00fcber den Befehl systemctl auch gestartet werden.<\/p>\n\n\n\n
[Unit]\nDescription=Tomcat\nAfter=syslog.target network.target\n[Service]\nType=forking\nUser=tomcat\nGroup=tomcat\nWorkingDirectory=\/opt\/apache-tomcat-7.0.99\nEnvironment=\"JAVA_HOME=\/opt\/jdk-17\"\nEnvironment=\"CATALINA_HOME=\/opt\/apache-tomcat-7.0.99\"\nEnvironment=\"CATALINA_OPTS=-Xms1024M -server\"\nExecStart=\/opt\/apache-tomcat-7.0.99\/bin\/startup.sh\nExecStop=\/opt\/apache-tomcat-7.0.99\/bin\/shutdown.sh\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\n
Innerhalb der Datei server.xml m\u00fcssen noch die Parameter \u201e maxHttpHeaderSize=\u201c65536\u201c \u201c und \u201e maxPostSize=\u201c4194304\u201c \u201c gesetzt werden. Anderenfalls, kann es Probleme bei gro\u00dfen PDF Dokumenten w\u00e4hrend der Anzeige, Bearbeitung, etc. \u2026 geben.<\/p>\n\n\n\n
Die Datei server.xml befindet sich im Verzeichnis conf des entpackten Tomcat-Archivs.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Bevor getestet wird ob der Tomcat erreichbar ist, sollte die Firewall-Regeln f\u00fcr den notwendigen Port 8080 ge\u00f6ffnet werden:<\/p>\n\n\n\n
firewall-cmd --zone=public --add-port=8080\/tcp<\/code><\/pre>\n\n\n\n
Wenn man die Regel nicht bei jedem Server-Neustart erneut eingeben m\u00f6chte, so sollte die Regel mit einem „–permanent“ versehen werden:<\/p>\n\n\n\n
firewall-cmd --zone=public --add-port=8080\/tcp --permanent<\/code><\/pre>\n\n\n\n
Der Service wird mittels dem Befehl systemctl dem System bekannt gemacht und kann auch direkt gestartet werden.<\/p>\n\n\n\n
systemctl enable tomcat.service\nsystemctl start tomcat.service<\/code><\/pre>\n\n\n\n
Der Zugriffstest kann dann mit einem normalen WebBrowser erfolgen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Befehl<\/strong><\/td>Info<\/strong><\/td><\/tr>
systemctl enable tomcat.service<\/td>Bekanntmachen des Tomcat-Dienstes<\/td><\/tr>
systemctl status tomcat.service<\/td>Zeigt den aktuellen Zustand des Dienstes an.<\/td><\/tr>
systemctl start tomcat.service<\/td>Starten des Tomcat-Servers<\/td><\/tr>
systemctl stop tomcat.service<\/td>Stopp des Tomcat-Dienstes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Installation PostgresSQL<\/strong><\/p>\n\n\n\n
Die Installation der notwendigen PostgreSQL Datenbank erfolgt einfach vom System heraus.<\/p>\n\n\n\n
yum install postgresql-server<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Anmerkung: In dem Beispiel wird die im CentOS hinterlegte Version 9.2.x verwendet. Es sind auch neuere Versionen m\u00f6glich.<\/p>\n\n\n\n
Um die Datenbank in den Betrieb zu bekommen, m\u00fcssen noch folgende Befehle ausgef\u00fchrt werden:<\/p>\n\n\n\n
postgresql-setup initdb<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
In der Datei pg_hba.conf muss der Authentifizierungsmethode noch auf \u201etrust\u201c umgeschaltet werden. Anderenfalls ist kein Login seitens unserer Applikation m\u00f6glich.<\/p>\n\n\n\n
Die Datei \u201epg_hba.conf\u201c befindet sich im Verzeichnis:<\/p>\n\n\n\n
cd \/var\/lib\/pgsql\/data<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die Datenbank kann nach einer Bereitstellung des des Dienstes:<\/p>\n\n\n\n
systemctl enable postgresql.service<\/code><\/pre>\n\n\n\n
\u00fcber<\/p>\n\n\n\n
systemctl start postgresql.service<\/code><\/pre>\n\n\n\n
gestartet werden.<\/p>\n\n\n\n
Ob die PostgreSQL Installation korrekt durchgef\u00fchrt wurde, kann \u00fcber den Befehl:<\/p>\n\n\n\n
systemctl status postgresql.service<\/code><\/pre>\n\n\n\n
getestet werden.<\/p>\n\n\n\n
Die R\u00fcckgabe sollte in etwas wie folgt aussehen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
biffo ben\u00f6tigt eine existierende Datenbank und einen passenden Benutzer. Beides wird mit der psql Shell durchgef\u00fchrt.<\/p>\n\n\n\n
su postgres<\/code><\/pre>\n\n\n\n
Danach \u00f6ffnet sich die zugeordnete Shell und der Befehl psql \u00f6ffnet eine Shell zur Datenbank.<\/p>\n\n\n\n
psql<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Der Befehl create database dms ertellt dann die Datenbank, die f\u00fcr die sp\u00e4tere Konfiguration notwendig ist.<\/p>\n\n\n\n
create database dms;<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wie bereits erw\u00e4hnt, erfolgt die Installation sowohl mittels root aber auch mit dem default postgres user (DB-Admin). Daher sollte direkt das Passwort des PostgreSQL Users ge\u00e4ndert werden:<\/p>\n\n\n\n
\\password<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die Shell kann \u00fcber \\q mit anschliessendem exit verlassen werden.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Installation OpenSearch<\/strong><\/p>\n\n\n\n
F\u00fcr das Suchen und Finden von Dokumenten, wird Open-Search verwendet.<\/p>\n\n\n\n
Download des OpenSearch Servers mittels wget:<\/p>\n\n\n\n
cd \/opt\nwget https:\/\/artifacts.opensearch.org\/releases\/core\/opensearch\/2.0.1\/opensearch-min-2.0.1-linux-x64.tar.gz<\/code><\/pre>\n\n\n\n
Das entpacken erfolgt wie bisher mittels tar:<\/p>\n\n\n\n
tar -xvzf opensearch-min-2.0.1-linux-x64.tar.gz<\/code><\/pre>\n\n\n\n
In dem entpackten Verzeichnis, wird auch direkt der Server ausgef\u00fchrt. Dieses beinhaltet auch das Verzeichnis f\u00fcr die bzw. den Index:<\/p>\n\n\n\n
cd opensearch-2.0.1\nmkdir data<\/code><\/pre>\n\n\n\n
User, Gruppe und Rechte hinzuf\u00fcgen:<\/p>\n\n\n\n
groupadd opensearch\nuseradd -g opensearch opensearch\nchown -R opensearch:opensearch \/opt\/opensearch-2.0.1<\/code><\/pre>\n\n\n\n
Erstellung opensearch.service Datei im Verzeichnis \/etc\/systemd\/system<\/p>\n\n\n\n
Diese Datei wird entsp. dem Verzeichnis indem sich der entpackte Opensearch Server befindet angepasst. Die folgende Konfiguration als Service wurde unter Anpassungen der Ordner aus dem Internet \u00fcbernommen.<\/p>\n\n\n\n
[Unit]\nDescription=Opensearch\nDocumentation=https:\/\/opensearch.org\/docs\/latest\nRequires=network.target remote-fs.target\nAfter=network.target remote-fs.target\nConditionPathExists=\/opt\/opensearch-2.0.1\nConditionPathExists=\/opt\/opensearch-2.0.1\/data\n[Service]\nUser=opensearch\nGroup=opensearch\nWorkingDirectory=\/opt\/opensearch-2.0.1\nExecStart=\/opt\/opensearch-2.0.1\/bin\/opensearch\n# Specifies the maximum file descriptor number that can be opened by this process\nLimitNOFILE=65535\n# Specifies the maximum number of processes\nLimitNPROC=4096\n# Specifies the maximum size of virtual memory\nLimitAS=infinity\n# Specifies the maximum file size\nLimitFSIZE=infinity\n# Disable timeout logic and wait until process is stopped\nTimeoutStopSec=0\n# SIGTERM signal is used to stop the Java process\nKillSignal=SIGTERM\n# Send the signal only to the JVM rather than its control group\nKillMode=process\n# Java process is never killed\nSendSIGKILL=no\n# When a JVM receives a SIGTERM signal it exits with code 143\nSuccessExitStatus=143\n# Allow a slow startup before the systemd notifier module kicks in to extend the timeout\nTimeoutStartSec=75\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\n
Das Eintragen als Service erfolgt analog wie beim Tomcat-Server mittels systemctl. Allerdings mit dem neu erzeugten Service-File.<\/p>\n\n\n\n
Befehl<\/strong><\/td>Info<\/strong><\/td><\/tr>
systemctl enable opensearch.service<\/td>Bekanntmachen des Opensearch Services<\/td><\/tr>
systemctl status opensearch.service<\/td>Zeigt den aktuellen Zustand des Dienstes an.<\/td><\/tr>
systemctl start opensearch.service<\/td>Starten des Opensearch-Servers<\/td><\/tr>
systemctl stop opensearch.service<\/td>Stopp des Opensearch-Dienstes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Installation und Konfiguration DMS-Applikation<\/strong><\/p>\n\n\n\n
Nachdem die Voraussetzungen f\u00fcr den Betrieb geschaffen wurden, muss die Datei DmsWeb.war in das webapps Verzeichnis des Tomcat-Servers kopiert werden.<\/p>\n\n\n\n
Das Deploy-Verzeichnis befindet sich innerhalb des Tomcat-Servers:<\/p>\n\n\n\n
cd \/opt\/apache-tomcat-7.0.99\/webapps\/<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Nachdem die Datei „DmsWeb.war“ in das Verzeichnis kopiert wurde, kann \u00fcber einen Browser mittels der URL: http:\/\/<SERVER-IP>:<SERVER-PORT>\/DmsWeb auf die Applikation zugegriffen werden:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Der Username und das Passwort lauten: setup<\/strong>\/setup<\/strong><\/p>\n\n\n\n
Im Anschluss \u00f6ffnet sich folgendes Fenster f\u00fcr die Datenbankkonfiguration:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Folgende Parameter werden nun eingetragen (Die Konfiguration entspricht meiner Installation und muss daher angepasst werden):<\/p>\n\n\n\n
Name<\/strong><\/td>Wert<\/strong><\/td><\/tr>
Datenbank URL:<\/td>jdbc:postgresql:\/\/localhost\/dms<\/td><\/tr>
Datenbank Benutzer:<\/td>postgres<\/td><\/tr>
Datenbank Password:<\/td>123456<\/td><\/tr><\/tbody><\/table>
Datenbankparameter (Beispiel)<\/figcaption><\/figure>\n\n\n\n
Button<\/strong><\/td>Funktion<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
\"\"<\/td>Abbrechen<\/td>Abbruch (R\u00fcckg\u00e4ngig falls Edit-Modus) ansonsten Edit-Modus verlassen.<\/td><\/tr>
\"\"<\/td>Konfiguration speichern<\/td>Konfiguration speichern, Tabellen anlegen und Parameter schreiben.<\/td><\/tr>
\"\"<\/td>Konfiguration testen<\/td>Testet die eingegeben Parameterwerte auf deren Korrektheit<\/td><\/tr>
\"\"<\/td>Konfiguration editieren<\/td>Wechselt in den Edit-Modus<\/td><\/tr>
\"\"<\/td>Konfiguration Re-Initialisieren<\/td>Verl\u00e4sst den Konfigurationsmodus und f\u00fchrt einen komplett Refresh der Verbindungen, etc. durch. Es erfolgt ein Redirect zum Login-Fenster.<\/td><\/tr><\/tbody><\/table>
PostgreSQL Konfiguration – Buttons<\/figcaption><\/figure>\n\n\n\n
\u00dcber einen Druck auf de Button „Konfiguration testen“ werden die eingegeben Parameter \u00fcberpr\u00fcft.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Der rote Balken liefert die Fehlermeldung, dass die jeweiligen Tabellen noch nicht vorhanden sind. Die Tabelle „DMS-Table Status“ zeigt einen \u00dcberblick um welche Tabellen es sich handelt. Die Konfiguration der Zugriffsparameter ist aber soweit OK. Anderenfalls, w\u00e4re die Tabelle „DMS-Table Status“ nicht angezeigt worden.<\/p>\n\n\n\n
Ein Druck auf „Konfiguration speichern“ generiert die Tabellen und setzt die ersten Konfigurationsparameter.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\u00dcber einen „Abbrechen“ und „Konfiguration Re-Initialisieren“ wird die Web-Applikation neu initiert und man kann sich mit dem generierten Admin-Account neu anmelden und das Setup abschliessen.<\/p>\n\n\n\n
Der Default Admin Account lautet: admin<\/strong>\/admin<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Um die Konfiguration zu vervollst\u00e4ndigen, muss in den Menu-Eintrag „Config“ gesprungen werden.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die Einstellungen gliedern sich in vier relevante Bereiche:<\/p>\n\n\n\n
Name\/Bereich<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
PostgreSQL<\/td>Festlegung der PostgreSQL Datenbank und der Tabellenstruktur<\/td><\/tr>
Opensearch<\/td>Konfiguration des OpenSearch-Servers f\u00fcr die Suche<\/td><\/tr>
DmsConfig<\/td>Parameter Verzeichnisse und ImportTypen<\/td><\/tr>
Tesseract-OCR<\/td>Festlegung der lokal installierten Tessersact OCR Engine<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Bereich „PostgreSQL“<\/strong><\/p>\n\n\n\n
Hierbei handelt es sich 1:1 um das oben beschriebene Datenbank-Setup Fenster. Bei Bedarf kann aus einer laufenden Umgebung zu einer neuen Datenbank gewechselt werden. Wichtig hierbei, alle Parameter m\u00fcssen erneut eingegben werden. Sollte es sich um eine bereits konfigurierte Umgebung handeln, so werden die Einstellungen aus den jeweiligen Tabellen geladen.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Bereich „Opensearch“<\/strong><\/p>\n\n\n\n
Opensearch wird verwendet um die Dokumente zu indizieren und liefert einen Suchindex f\u00fcr die gezielte Suche nach Dokumenteninhalten. Hierzu wird mittels der Konfiguration ein Index innerhalb des Opensearch-Server erzeugt.<\/p>\n\n\n\n
Name<\/strong><\/td>Wert<\/strong><\/td><\/tr>
OpenSearch URL:<\/td>http:\/\/localhost:9200<\/td><\/tr>
OpenSearch Index:<\/td>dms<\/td><\/tr>
OpenSearch Benutzer:<\/td>admin (z.Zt. noch nicht ver\u00e4nderbar -> siehe Releaseplanung)<\/td><\/tr>
OpenSearch Password:<\/td>admin (z.Zt. noch nicht ver\u00e4nderbar -> siehe Releaseplanung)<\/td><\/tr><\/tbody><\/table>
Opensearch Parameters<\/figcaption><\/figure>\n\n\n\n
Button<\/strong><\/td>Funktion<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
\"\"<\/td>Abbrechen<\/td>Abbruch (R\u00fcckg\u00e4ngig falls Edit-Modus) ansonsten Edit-Modus verlassen.<\/td><\/tr>
\"\"<\/td>Konfiguration speichern<\/td>Konfiguration speichern und Index anlegen.<\/td><\/tr>
\"\"<\/td>Konfiguration testen<\/td>Testet die eingegeben Parameterwerte auf deren Korrektheit<\/td><\/tr>
\"\"<\/td>Konfiguration editieren<\/td>Wechselt in den Edit-Modus<\/td><\/tr><\/tbody><\/table>
Opensearch Konfiguration \u2013 Buttons<\/figcaption><\/figure>\n\n\n\n
Um den Index anzulegen muss in den Edit-Modus gewechselt und danach die Konfiguration einfach gespeichert werden. Der gr\u00fcne Balken symbolisiert das der Index erfolgreich erstellt wurde.<\/p>\n\n\n\n
Ein Druck auf „Konfiguration testen“ zeigt ob die angegebenen Werte des Opensearch-Servers verwendet werden k\u00f6nnen.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wichtig! Die Suche kann nur so gut sein, wie auch die Texte innerhalb der bereitgestellten Dokumente, welche mittels Tesseract erkannt werden konnten.<\/p>\n\n\n\n
Solle ein gelber Balken erscheinen, so wurde unter den angegebenen Werten bereits ein Index gefunden. Ob dieser Index mit denen f\u00fcr biffo \u00fcbereinstimmt, wird nicht \u00fcberpr\u00fcft. Im Zweifel bitte einen neuen Namen eingeben und den Index neu erzeugen.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n
Bereich „DmsConfig“<\/strong><\/p>\n\n\n\n
biffo serialisiert die Dokumente nicht 1:1 in der Datenbank, sondern legt die eingelesenen Dokumente auf Dateiebene ab. Hierzu werden diverse Ablagem\u00f6glichkeiten (Verzeichnisse) ben\u00f6tigt.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Parameter<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
DataFolder:<\/td>In diesem Verzeichnis werden die Dokumente nach der erfolgreichen Verarbeitung abgelegt. Hierzu wird eine Struktur mit dem Aufbau ..\/data\/YYYYMMDD erstellt. Der Zeitstempel richtet sich nach dem Zeitpunkt der Ver- bzw. Bearbeitung.<\/td><\/tr>
ImportFolder:<\/td>Der prim\u00e4re Import-Ordner. In diesem Ordner werden Dokumente (siehe ImportImageTypes) aus Servern oder mittels Web-Upload verarbeitet und bei erfolgreichem Abschlu\u00df in den DataFolder \u00fcberf\u00fchrt.
Dokumente die per „cp“ abgelegt wurden, werden nicht erkannt.<\/td><\/tr>
TempFolder:<\/td>Ordner der w\u00e4hrend der einzelnen Verarbeitungsschritte als Zwischenablage verwendet wird.<\/td><\/tr>
ArchiveFolder:<\/td>Wenn gew\u00fcnscht, wird nach der Verarbeitung ein ZIP-File mit dem bereitgestellten Dokument erzeugt.<\/td><\/tr>
ModuleFolder:<\/td>Bei Verwendung von API-Modulen, werden diese in diesem Verzeichnis abgelegt.<\/td><\/tr>
ImportImageTypes:<\/td>Unterst\u00fctzte Import-Image Typen (Derzeit keine Bearbeitung m\u00f6glich)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
S\u00e4mtliche Ordner\/Verzeichnisse m\u00fcssen von dem Applikation-Server beschrieben werden k\u00f6nnen. Es empfiehlt sich dennoch diese Ordner nicht innerhalb des „Tomcat“-Server abzulegen, sondern au\u00dferhalb und dem „tomcat“-User dann die Owner Rechte zuzuweisen.<\/p>\n\n\n\n
cd \/opt\nmkdir dms\nmkdir dms\/data\nmkdir dms\/import\nmkdir dms\/temp\nmkdir dms\/archive\nmkdir dms\/api\nchown -R tomcat:tomcat dms<\/code><\/pre>\n\n\n\n
Die Ordnerstruktur sollte wie folgt aussehen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die Werte der erstellten Verzeichnisse werden dann analog zu der obigen Parameterstruktur eingetragen (Edit-Modus) und dann abschlie\u00dfend gespeichert.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Sollte ein Verzeichnis nicht existent sein und\/oder keine Berechtigung vorliegen, so erfolgt ein Hinweis an der entsprechenden Stelle.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n
Bereich „Tesseract-OCR“<\/strong><\/p>\n\n\n\n
F\u00fcr den Import von Bildern und Dokumenten (pdf, jpg, tiff) wird eine OCR Engine ben\u00f6tigt. biffo setzt hierbei auf die quelloffene Software Tesseract. Das System erm\u00f6glicht eine Umwandlung und Texterkennung mit anschlie\u00dfender \u00dcberf\u00fchrung in ein suchbares PDF. Diverse Dokumentenscanner liefern zwar eine OCR Erkennung mit, diese geschieht im Regelfall aber au\u00dferhalb irgendwo in einer Cloud-Applikation.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Parameter<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
Installationsverzeichnis:<\/td>In welchem Verzeichnis befindet sich die Tesseract Anwendung<\/td><\/tr>
Datenverzeichnis:<\/td>Verzeichnis mit den Lanugage-Packs. Hier\u00fcber kann auch auf ein anderes Pack (z.B. FAST) gewechselt werden<\/td><\/tr>
Programmname:<\/td>Der Befehl bzw. die Anwendung selbst.<\/td><\/tr>
Sprache:<\/td>Welches Language-Pack soll verwendet werden. Derzeit nur Deutsch und Englisch<\/td><\/tr>
OCR Engine mode:<\/td>OCR Mode von Tesseract (bitte die Tesseract Dokumentation konsultieren)<\/td><\/tr>
Page segmentation modes:<\/td>Der Modus wie Tesseract die Quell-Datei verarbeitet  (bitte die Tesseract Dokumentation konsultieren). <\/td><\/tr>
DPI:<\/td>Mit welcher Aufl\u00f6sung werden z.B. Bilder in ein Tiff-Dokument konvertiert. Je h\u00f6her die Aufl\u00f6sung, desto langsamer wird die Umwandlung und die Dateigr\u00f6\u00dfe w\u00e4chst erheblich mit.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Button<\/strong><\/td>Funktion<\/strong><\/td>Beschreibung<\/strong><\/td><\/tr>
\"\"<\/td>Abbrechen<\/td>Abbruch (R\u00fcckg\u00e4ngig falls Edit-Modus) ansonsten Edit-Modus verlassen.<\/td><\/tr>
\"\"<\/td>Konfiguration speichern<\/td>Konfiguration speichern und Index anlegen.<\/td><\/tr>
\"\"<\/td>Konfiguration testen<\/td>Testet die eingegeben Parameterwerte auf deren Korrektheit und versucht das Programm Tesseract zu starten.<\/td><\/tr>
\"\"<\/td>Konfiguration editieren<\/td>Wechselt in den Edit-Modus<\/td><\/tr><\/tbody><\/table>
Tesseract Konfiguration \u2013 Buttons<\/figcaption><\/figure>\n\n\n\n
Nachdem die Eintr\u00e4ge vollzogen wurden, kann die Konfiguration getestet und gespeichert werden.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n
Bereich „Variablen“<\/strong><\/p>\n\n\n\n
Dieser Bereich zeigt die gespeicherten Parameter (u.A. Password im Quelltext) und sollte nur auf Anweisung modifiziert werden. Daher an dieser Stelle keine Erkl\u00e4rungen.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Erstes Dokument importieren<\/strong><\/p>\n\n\n\n
Wenn alle Einstellungen vollzogen wurden, kann versucht werden das erste Dokument in biffo zu importieren.<\/p>\n\n\n\n
Aufgrund der nicht vorhandenen Verzeichnisse, muss erstmalig der „Default PDF Importer“ per Hand gestartet werden. Dieses geschieht im Mne\u00fc „Administration“ und dort unter dem Reiter „Importers“.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ein Druck auf den gr\u00fcnen „Startknopf“, startet den Web-Importer. F\u00fcr den Fall das der Button weiterhin auf der Farbe gr\u00fcn verweilt, bitte mit F5 die Seite aktualisieren. Der Button sollte dann auf die Farbe rot gewechselt haben.<\/p>\n\n\n\n
Anschlie\u00dfend kann im Men\u00fc „Home“ der „Default PDF Importer“ verwendet werden. Entweder \u00fcber einen Druck auf „Select Files“ mittels Filedialog ein Dokument ausw\u00e4hlen oder per D&D ein Dokument auf den Importer ziehen.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Nach Selektion bzw. D&D erfolgt der Start der Default-Verarbeitungskette.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Nach Beendigung der Prozesskette ohne Fehlermeldung (gr\u00fcner Balken), ist das Dokument erfolgreich in das System importiert worden.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Hiermit endet die erstmalige Installation.<\/p>\n\n\n\n
Weitere Informationen befinden sich in Nutzung biffo<\/strong>.<\/p>\n","protected":false},"featured_media":0,"parent":0,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"positive":"","negative":"","footnotes":""},"docs_category":[],"_links":{"self":[{"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/docs\/98"}],"collection":[{"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/comments?post=98"}],"version-history":[{"count":98,"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/docs\/98\/revisions"}],"predecessor-version":[{"id":1057,"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/docs\/98\/revisions\/1057"}],"wp:attachment":[{"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/media?parent=98"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/biffo.de\/index.php\/wp-json\/wp\/v2\/docs_category?post=98"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}