Agenten für Java EE/JMX (Standalone) installieren

Diese Seite führt Sie durch die Installation eines Agenten in einem AE-System, in dem die Authentifizierung nicht verwendet wird. Weitere Installationsschritte sind erforderlich, bevor der Agent gestartet und verwendet werden kann, wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten. Weitere Informationen finden Sie unter Agenten-Authentifizierung.

Der JMX-Agent kann außerhalb eines Anwendungsservers ausgeführt werden.

Tipp: Am besten installieren Sie den Agenten in einem separaten Verzeichnis (z. B. UC4/Agent/jmx oder C:\AUTOMIC\Agent\jmx).

Ab Version 21.0 kommunizieren die Automation Engine und die Windows-, UNIX- und Java-Agenten unter Verwendung von TLS/SSL. Diese Agenten richten eine Verbindung zum Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um ihre Identität gegenüber anderen Kommunikationspartnern nachzuweisen.

Hinweis: Die TLS/SSL-Implementierung gilt nicht für den HP-UX-Agenten, da er in dieser Version nicht mehr unterstützt wird.

Sie können die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei verwenden, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?

TLS/SSL-Agenten und das TLS-Gateway richten bei Verwendung für die Automic Automation Kubernetes-Edition, eine Verbindung zu einem Ingress-/HTTPS-Load Balancer ein, und nicht direkt zum JCP. Der Ingress-/HTTPS-Load Balancer muss erreichbar sein und benötigt ein Zertifikat zur Authentifizierung. Die Adresse des Load Balancers muss auf beiden Seiten definiert sein: Automation Engine und Agent/TLS-Gateway.

Wichtig! Wenn Sie Agenten für ein Automic Automation Kubernetes-Edition-System manuell installieren oder aktualisieren, müssen Sie sicherstellen, dass Sie Ihre Agenten und/oder das TLS-Gateway konfigurieren, um den TCP- oder HTTPS-Load Balancer zu erreichen, und nicht direkt den CP oder JCP. Stellen Sie außerdem sicher, dass ihr HTTPS-Load Balancer die erforderlichen Zertifikate besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AAKE-Cluster herstellen.

Hinweis: Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass sich die Java-Agenten nur mit JCP-Portnummern verbinden können, die kleiner als 65536 sind. Wenn sie eine höhere Portnummer verwenden, kann der Agent nicht starten und bricht mit einer Fehlermeldung ab. Diese Einschränkung wird durch Java verursacht und betrifft die Agenten für JMX, Datenbanken, SAP und Rapid Automation.

Den Agenten für Java EE/JMX installieren

  1. Installieren Sie auf dem Administrator- bzw. Benutzercomputer Java Standard Edition.

    Sie können diesen Schritt überspringen, wenn die gewünschte Version der Java Standard Edition bereits verfügbar ist.

    • Verwenden Sie den folgenden Befehl, um die aktuelle Version der Java Virtual Machine (VM) auf Ihrem System zu prüfen:

      java -version

      Hinweis: Die Reihenfolge der angegebenen Verzeichnisse ist dann relevant, wenn Sie %PATH% oder $PATH angeben, wenn mehrere Versionen der JRE oder des Java SDK auf Ihrem Computer installiert sind. Es wird die zuerst angeführte Java-Laufzeitumgebung (JRE) verwendet.

    • Laden Sie die erforderliche Java-Laufzeitumgebung von der Java-Website herunter und installieren Sie sie, siehe http://java.sun.com.

  2. Richten Sie auf dem Host den Agenten ein.

    • Erstellen Sie einen separaten Ordner für den JMX-Agenten und kopieren Sie die mitgelieferten Dateien und den Unterordner Logs in diesen. Optional können Sie das Programm SETUP.EXE für die Installation verwenden. Sie ist im mitgelieferten Verzeichnis (Agent) verfügbar.

    • Legen Sie in der INI-Datei des JMX-Agenten den Agentennamen, den Computernamen und den Port des JCP fest, mit dem der Agent eine Verbindung herstellen soll. Weitere Informationen finden Sie unter Agent JMX.

    • Verwenden Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= in der jeweiligen INI-Datei, um auf die relevanten Zertifikate zu verweisen. Wenn der Parameter trustedCertFolder= nicht festgelegt ist, sollten die Zertifikate im jeweiligen Speicher installiert werden; das ist der Java-Truststore für Java-Agenten, der Windows-Betriebssystemspeicher für Windows-Agenten oder der TLS/SSL-Speicher für UNIX-Agenten. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      Weitere Informationen zu den verschiedenen Zertifikattypen und ausführliche Anweisungen zur Erstellung und Verwendung finden Sie unter Welche Art von Zertifikaten sollte ich für Automic Automation v21 verwenden?

  3. Verwenden Sie das folgende Kommando, um den Agenten von der Kommandozeile aus zu starten (UNIX und Windows):

    java -jar -Xrs -Xmx1G ucxjjmx.jar

    Sie können den ServiceManager verwenden, um den Agenten zu starten. Weitere Informationen finden Sie unter ServiceManager.

  4. Berücksichtigen Sie auf dem Host Folgendes, wenn Sie Jobs erstellen:

    • Wählen Sie auf der Registerkarte JMX des Job-Objekts die Option Lokale Java VM.
    • Aktivieren Sie die Unterpunkte Benutze vorhandenen MBean-Server und Erzeuge neue Instanz....

Siehe auch:

Die Agenten manuell installieren