Installation¶
Kommandozeile und Grafische Benutzungsoberfläche¶
Die Installation von best4Automic ist weitestgehend plattformunabhängig und in wenigen Schritten durchzuführen. Aufgrund der genutzten Bibliothek OpenJFX wird ein Release von best4Automic als ZIP-Archiv für Unix- und ein weiteres für Windows-Systeme ausgeliefert. Alle weiteren Komponenten eines Releases sind in den Archiven sonst gleich.
Voraussetzungen¶
Vor der Installation müssen einige Vorbedingungen geprüft werden. Damit sichergestellt ist, dass eine unterstützte Plattform vorhanden ist, sollte das eingesetzte Betriebssystem einem der folgenden getesteten entsprechen:
Unix - bspw. IBM AIX® (7.1 oder 7.2) oder Oracle Solaris® (10 oder 11)
Linux - bspw. SUSE Linux Enterprise Server (SLES)® (11 oder 12) oder RedHat Enterprise Linux (RHEL)® (6, 7 oder 8)
Microsoft Windows® (8.1 oder höher und Server ab 2012)
Sollte ein anderes UNIX-kompatibles oder Windows System vorliegen, kann best4Automic trotzdem funktionieren. Es müssen auf jeden Fall die nachfolgenden Bedingungen erfüllt sein:
Oracle Java 11 oder OpenJDK 11 muss auf dem System installiert sein. Es ist ausreichend die JRE zu verwenden (JDK ist nicht notwendig). Java Versionen vor 11 werden nicht unterstützt.
Durchführung¶
Wenn diese Voraussetzungen erfüllt sind, kann best4Automic auf dem System installiert werden.
Damit best4Automic mit der installierten Version der Automation Engine zusammenarbeiten kann, muss diese in einer Version ab 12.3 installiert sein. Dabei ist der Patchlevel nicht relevant.
Für das b4A.ps1-Startskript sowie die Powershell-Actions wird Powershell 5.0 vorausgesetzt.
Bemerkung
Die grafische Oberfläche von best4Automic wird mittels der Bibliothek OpenJFX realisiert. Diese ist aktuell ausschließlich für Linux- und Windows-Systeme verfügbar. Damit best4Automic auch auf älteren Unix-Systemen nutzbar ist, wird ein spezielles Start-Skript - b4A-cli - mitgeliefert, dass best4Automic in einen Kommandozeilen-Modus zwingt. Dabei wird die OpenJFX Bibliothek durch eine interne Variante von best4Automic ersetzt. Auch für Windows-Systeme kann dieser erzwungene Kommandozeilen-Modus genutzt werden indem das Start-Skript b4A-cli.ps1 genutzt wird.
Release-Archiv¶
Der Installationsvorgang besteht ausschließlich aus dem Auspacken des Release-Archivs in dem gewünschten Verzeichnis. Es wird empfohlen, das Archiv mit dem Benutzer auszupacken, der auch die Module ausführen wird.
Das Paket beinhaltet Verzeichnisse, die wie folgend beschrieben aufgebaut sind:
bin
enthält Start-Skripte für die best4Automic Module. Für Unix-Systeme gibt es das Skript
b4A
und für Windows-Systeme die Skripteb4A.bat
undb4A.ps1
. Des Weiteren gibt es noch die Start-Skripteb4A-cli
undb4A-cli.ps1
für den Kommandozeilen-Modus.
lib
enthält alle notwendigen jar-Archive für best4Automic. Für 3rd-Party Bibliotheken sind in einem Unterverzeichnis die entsprechenden Lizenzinformationen zu finden
conf
enthält Konfigurationsdateien für die best4Automic Module. Ausgeliefert werden die zentralen Konfigurationsdateien
defaults.conf
undmodules.conf
. Über den Konfigurationsmechanismus gibt es in einem der folgenden Kapitel weitere Details.
doc
enthält diese Dokumentation im HTML-Format.
data
ist das Standardausgabeverzeichnis für Module, die Ausgabedateien erstellen.
REST-API¶
Die Distribution für die REST-API von best4Automic wird als separates Archiv veröffentlich, da die Installation anders verläuft und primär auf den Mechanismen von Apache Tomcat ® basiert. Das Archiv wird im WAR-Format veröffentlicht und kann somit über die Veröffentlichungsmechanismen von Apache Tomcat ® installiert werden.
Voraussetzungen¶
Die REST-API von best4Automic kann auf jeder Plattform betrieben werden, die auch von Apache Tomcat ® unterstützt wird. Dabei gibt es die folgenden zusätzlichen Anforderungen
Apache Tomcat ® muss mindestens in der Version 9 installiert sein
Apache Tomcat ® muss mit mindestens Java 11 betrieben werden
Durchführung¶
Die Installation folgt dem Vorgehen für Web-Applikationen auf einem Apache Tomcat ® Server welches in der Dokumentation beschrieben ist.
Release-Archiv¶
Das war-Archiv enthält die folgende Verzeichnisse
WEB-INF
Alle notwendigen Java-Bibliotheken
META-INF
Meta-Informationen zur Web-Applikation
org
Startup-Programm für die REST-Applikation
conf
Konfigurationsverzeichnis für best4Automic
lib
Compliance-Tests, 3rd Party Lizenen und andere intern benötigte Dateien
data
Vorgabeverzeichnisse für erzeugte Ausgabedateien der b4A Module
Third Party Software¶
Die best4Automic Solution basiert auf einigen Open Source Komponenten, die von einigen Modulen benötigt werden. Die jeweilige Lizenz bzw. Präambeln der Lizenzen sind in der Distribution enthalten.
jgit
gherkin
diffutils
Gson
OpenJFX
Apache Groovy
Apache Commons IO
Jayway JsonPath
Springboot