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.

Tipp! Diese Seite bezieht sich nur auf den manuellen Installationsprozess. Anweisungen zum Installieren eines Container-Java-Agenten finden Sie unter Container-Java-Agenten installieren.

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

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

Diese Seite beinhaltet Folgendes:

Eine Verbindung zur Automation Engine herstellen

Die Automation Engine und die Windows-, UNIX- und Java-Agenten kommunizieren 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.

Wichtig! Sie sollten mit TLS/SSL und der Zertifikatimplementierung vertraut sein, bevor Sie die entsprechende Komponente installieren bzw. aktualisieren. Weitere Informationen finden Sie hier:

Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert: dem Java Trust Store für Java-Komponenten und Java-Agenten, dem Windows-Betriebssystemspeicher für Windows-Agenten und dem TLS/SSL-Speicher für UNIX-Agenten. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

Wenn sich die relevanten Zertifikate nicht dort befinden und Sie sie importieren möchten, können Sie für diesen Zweck für das Betriebssystem oder Java spezifische Tools verwenden, wie zum Beispiel Keytool, cert-manager, OpenSSL usw. Weitere Informationen zur Verwendung dieser Tools finden Sie in der entsprechenden Produktdokumentation.

Wenn Sie nicht den Standardspeicherort für die oben aufgeführten Komponenten und Agenten verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

Wichtig! TLS/SSL-Agenten (in Containern und vor Ort) sowie das TLS Gateway, wenn sie für die Automic Automation Kubernetes Edition verwendet werden, stellen eine Verbindung zu einem Ingress-/HTTPS-Load-Balancer her, der zur Authentifizierung ein Zertifikat anfordert.

Stellen Sie sicher, dass die Adresse des Load Balancers auf beiden Seiten definiert ist: in der Automation Engine und auf dem Agenten/TLS Gateway, und dass Ihr HTTPS-Load-Balancer die erforderlichen Zertifikate zur Nutzung besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AWI, die JCP- und REST-Prozesse über einen Ingress herstellen.

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.

    • Wenn Sie von einer Zertifizierungsstelle signierte Zertifikate verwendet haben, werden die Zertifikate standardmäßig im entsprechenden Java- oder Betriebssystemspeicher gespeichert. In diesem Fall müssen Sie nur prüfen, ob die Root-Zertifikate bereits im jeweiligen Speicher sind.

      Wenn Sie nicht den Standardspeicherort für diese Komponente verwenden möchten, stellen Sie sicher, dass Sie die Parameter trustedCertFolder=, agentSecurityFolder= und keyPassword= (falls zutreffend) in der entsprechenden Konfigurationsdatei (INI) verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind.

      Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

  3. Verwenden Sie das folgende Kommando, um den Agenten von der Kommandozeile aus zu starten:

    java -jar [Windows:]-Xrs -Xmx2048m ucxjcitx.jar disable_cache

    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:

Agenten installieren