Installation des JCP
Die folgenden Schritte helfen Ihnen bei der Installation des JCP (Java Communication Process).
Die für JCP benötigten Dateien sind die gleichen wie die für JWP bereitgestellten Dateien im gleichen Verzeichnis wie alle anderen Automation Engine-Dateien.
Da die Installation des JWP obligatorisch ist und die für das JCP notwendigen Dateien mit denen der Installation des JWP übereinstimmen, ist es nicht notwendig, Dateien zu entpacken oder einen anderen Installationsschritt durchzuführen.
Hinweise:
-
Die JCP-Installation ist sowohl für die AE-REST-API als auch für die erweiterte Objektsuche relevant. Stellen Sie daher sicher, dass Sie den Abschnitt REST der Automation Engine-Konfigurationsdatei (ucsrv.ini) entsprechend konfigurieren. Andernfalls funktioniert die erweiterte Automic Automation-Objektsuche nicht. Weitere Informationen finden Sie unter Automation Engine.
-
Wir empfehlen die Verwendung von HTTPS.
HTTPS/SSL Einrichtung für die AE-REST API
Um HTTPS nutzen zu können, müssen Sie den Parameter sslEnabled auf 1 setzen und mit der Einstellung der folgenden Parameter in der Automation Engine-Konfigurationsdatei fortfahren (ucsrv.ini, siehe Automation Engine):
-
keystore
Dieser Parameter ist obligatorisch und muss auf das richtige Ziel zeigen, sonst wird der JCP-Server beendet.
-
keystorePassword
-
keyPassword
Das keystorePassword und das keyPassword können mit dem Dienstprogramm UCYBCRYP verschlüsselt werden.
Zertifikate hinzufügen
JCP verwendet den keystore, wie in der Automation Engine-Konfigurationsdatei definiert. Weitere Informationen sowie Informationen zum Hinzufügen von Zertifikaten finden Sie unter https://www.eclipse.org/jetty/documentation/jetty-9/index.html#configuring-ssl.
Starten des JCP
Verwenden Sie diese Art von Befehl, um das JCP über die Kommandozeile zu starten:
java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -rest
Die Datei "ucsrvjp.jar" befindet sich im gleichen Verzeichnis wie die anderen Automation Engine-Dateien. Sie wird ausschließlich zum Starten von JWP und JCP verwendet.
Das JCP kann auch über den ServiceManager gestartet werden.
java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -svc%port% -rest
Der Parameter -svc sollte weggelassen werden, wenn Sie direkt über die Kommandozeile starten.
Der Parameter -I zur Angabe der INI-Datei ist optional. Fehlt der Parameter, versucht das JCP, die Datei "ucsrv.ini" im aktuellen Arbeitsverzeichnis (= Verzeichnis, in dem sich die Datei "ucsrvjp.jar" befindet) zu finden.
Mehrere REST-API-Prozesse einrichten
Die JCP-Installation ist sowohl für die AE-REST-API als auch für die erweiterte Objektsuche relevant. Sie können einen einzelnen Java-Kommunikationsprozess (JCP) installieren. In diesem Fall werden alle REST-Anfragen an diese einzelne AE-REST-API-Instanz gesendet, und es ist keine REST-API verfügbar, wenn der Java-Kommunikationsprozess (JCP) ausgefallen ist.
Sie können auch ein System mit mehreren Java-Kommunikationsprozessen (JCPs) einrichten. In diesem Fall werden zwei Java-Kommunikationsprozesse (JCPs) in einem Cluster verwendet, aber nur einer von beiden ist dann verfügbar.
Wichtig! Wenn Sie mehrere Java-Kommunikationsprozesse (JCPs) verwenden, ist es unerlässlich, dass jeder davon eine eigene Automation Engine-Konfigurationsdatei verwendet (ucsrv.ini, siehe Automation Engine). Wenn nur eine INI-Datei für mehr als einen Java-Kommunikationsprozess (JCP) verwendet wird, verbindet sich der erste erfolgreich, während die anderen beim Versuch, den gleichen REST-Port zu registrieren, abgebrochen werden, wenn beide auf demselben Knoten laufen. In die Logdatei des JCP wird eine Fehlermeldung unter Angabe des Grunds für den Abbruch geschrieben.
Die Einrichtung eines Systems mit mehreren Java-Kommunikationsprozessen (JCPs) kann für den Abgleich und die Bereitstellung von Ausfallsicherungen sinnvoll sein, da die REST-Anfragen gesendet und nur an verfügbare Java-Kommunikationsprozesse (JCPs) verteilt werden.
Weitere Informationen finden Sie unter AE-REST-API - Allgemeine Informationen
Nächster Schritt: