Installation

Backend

Voraussetzungen

Die Installation von requests4Automation ist weitestgehend plattformunabhängig und in wenigen Schritten durchzuführen.

Damit requests4Automation ordnungsgemäß funktionieren kann, ist eine korrekt eingerichtete und lauffähige Camunda-Installation erforderlich, mit der sich vom Server, auf dem r4A installiert werden soll, verbunden werden kann.

Das r4A Backend ist als Apache Tomcat^®-Applikation verfügbar. Zur Installation ist daher ein Tomcat Server der Version 9 sowie Java in der Version 11 Voraussetzung.

b4A RESTful API

r4A nutzt zur Integration mit Automic die b4A RESTful API. Diese kann auf demselben Tomcat-Server installiert werden, es kann aber auch ein anderer Server verwendet werden. Details zur Installation finden sich in der offiziellen best4Automic Dokumentation:

https://docs.best4automic.de/manuals/de/best4automic/5/5.5/chapter-installation.html#id1

Release-Archiv

Das war-Archiv enthält die folgende Verzeichnisse

WEB-INF

Alle notwendigen Java-Bibliotheken sowie die application.properties Konfigurationsdatei

META-INF

Meta-Informationen zur Web-Applikation

org

Startup-Programm für die REST-Applikation

Durchführung

Zur Installation muss lediglich das ausgelieferte WAR-File in das webapps Verzeichnis des Tomcats kopiert werden. Der Tomcat Server nimmt die Installation anschließend automatisch vor. Die Installation folgt dem Vorgehen für Web-Applikationen auf einem Apache Tomcat^® Server, welches in der Dokumentation beschrieben ist.

https://tomcat.apache.org/tomcat-9.0-doc/deployer-howto.html

Frontend

Voraussetzungen

Zur Installation des Frontend ist eine laufende node.js Umgebung auf dem Server erforderlich. Das next Plugin muss installiert sein. Die Installation kann auf demselben Server stattfinden, auf dem auch das Backend installiert wurde. Dies ist aber nicht zwingend erforderlich.

Release-Archiv

Die Auslieferung des Frontends erfolgt als tar-Archiv. Dieses muss auf dem Server entpackt werden.

Durchführung

Nachdem das Archiv entpackt worden ist, müssen die folgenden Befehle npm Scripte ausgeführt werden:

npm install
npm run build

Das Frontend ist jetzt startklar und kann mit dem folgenden Befehl gestartet werden:

npm run start

Third Party Software

requests4Automation basiert auf einigen Open Source Komponenten. Die jeweilige Lizenz bzw. Präambeln der Lizenzen sind in der Distribution enthalten.

• Apache Commons IO

• Spring Boot