Agenten für Java EE/JMX (Tomcat) 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.

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.

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 (in Containern und lokal) und das TLS Gatewayrichten bei Verwendung für die Automic Automation Kubernetes Editioneine 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 werden: 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.

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

  1. Richten Sie auf dem Host den JMX-Agenten ein.

    • Starten Sie Tomcat und rufen Sie den Tomcat Web Application Manager auf.

    • Wählen Sie die Datei ucxjjmx.war im Bereich Installieren > lokale WAR-Datei für die Installation laden aus, und starten Sie die Installation.

      Hinweis: Die Rolle administrators muss vorhanden sein. Passen Sie die Datei tomcat-users.xml an, wenn die Rolle noch nicht existiert. Geben Sie die Rolle ein und fügen Sie sie einem Benutzer hinzu.

      Beispiel

      <role rolename="administrators"/>
      <user username="admin" password="" roles="admin,manager,administrators"/>

    • Starten Sie Tomcat neu, um die Rollen anzuwenden.

    • Der JMX-Agent wird im Abschnitt Anwendungen des Web Application Managers angezeigt.

  2. Verwenden Sie auf dem Host die Konfiguration WebInterface.

    • Der JMX-Agent verfügt über eine Web-Konfigurationsschnittstelle, die mit einem Webbrowser über die folgende Adresse aufgerufen werden kann: http://Servername:port/context root. Weitere Informationen finden Sie unter Web-Konfigurationsschnittstelle für den Java EE/JMX-Agenten.

    • Passen Sie die JMX-Agenteneinstellungen an Ihre Systemumgebung an. Die wichtigsten Einstellungen sind:

      • Name des Agenten

      • Name des Rechners, auf dem der Java-Kommunikationsprozess verfügbar ist

      • Portnummer des Java-Kommunikationsprozesses

      Hinweis: Die Konfigurationsdatei wird überschrieben, wenn Sie die WAR-Datei erneut bereitstellen. Daher müssen Sie Ihre Konfigurationseinstellungen neu definieren. Stattdessen können Sie auch eine Kopie Ihrer Konfigurationsdatei (INI-Datei) speichern, bevor Sie das Deployment starten, und sie in den Ordner kopieren, der die Webanwendung enthält, nachdem das Deployment stattgefunden hat.

    • 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?

Siehe auch: