Installation des Host-Agenten auf IBM i

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind. Weitere Informationen zu den unterstützten Betriebssystemen und Rechenplattformen finden Sie unter „Richtlinien “.

• IBM i 7.4 oder später

• Stellen Sie sicher, dass Sie die folgenden lizenzierten Programme in Ihrem System installieren:

  • 5770-SS1 Option 30, QSHELL
  • 5770-SS1 Option 33, PASE
  • 5770-JV1, IBM Developer Kit for Java : Option 17 für Java 8 oder Option 19 (unter IBM i 7.5 und früheren Versionen) für Java 11.

• Installieren Sie einige Open-Source-Pakete in IBM Portable Application Solutions Environment (PASE) für i. Weitere Informationen über Open-Source-Pakete auf IBM i finden Sie unter RPM pile for IBM i releases in standard support. Sie können die Open-Source-Paketverwaltung in „ IBM i Access Client Solutions “ (ACS) nutzen, um diese Pakete in PASE zu installieren. Die erforderlichen Pakete werden standardmäßig installiert. Außerdem müssen Sie die folgenden Pakete installieren:

  • Bash
  • Tar-GNU (zum Entpacken des Agent-Archivs).

Prüfen Sie, ob die lokale Überwachung von IBM i Ihren Anforderungen entspricht, indem Sie sich die folgende nicht erschöpfende Liste der unterstützten Sensoren ansehen, die automatisch unter IBM i erkannt werden können. Wenn nicht, verwenden Sie die Fernüberwachung von IBM i. Weitere Informationen finden Sie unter „Überwachen von IBM i -Instanzen “.

• Apache Tomcat
• Skript für Automatisierungsaktionen
• DB2 for IBM i
• IBM i
• IBM MQ
• Java Virtual Machine
• Node.js
• Python
• Spring Boot
• WebSphere Application Server
• WebSphere Liberty

Um die Metriken für WebSphere Liberty zu sammeln, müssen Sie die Funktion monitor-1.0 aktivieren. Um diese Funktion zu aktivieren, öffnen Sie die Datei server.xml, die sich im Verzeichnis <websphere-liberty_install_dir>/usr/servers/<specific_server>/ befindet, und fügen Sie die folgenden Zeilen in die Datei ein:

<featureManager ...>
    ...
    <feature>monitor-1.0</feature>
    ...
</featureManager>
 

IBM i 7.6 führt die Multi-Faktor-Authentifizierung (MFA) für Benutzerprofile ein. Der „ Instana “-Agent kann unter einem Benutzerprofil ausgeführt werden, bei dem MFA aktiviert ist oder nicht. Weitere Informationen finden Sie unter „Starten des Host-Agenten “.

Um auf „ Java “-basierte Technologien zu überwachen, muss der „ Instana “-Agent zu dem Benutzerprofil wechseln, unter dem der „ Java “-Job ausgeführt wird, falls der Job von einem anderen Benutzer als dem Agenten ausgeführt wird. Im Allgemeinen kann der „ Instana “-Agent zu einem MFA-fähigen Benutzerprofil wechseln, ohne dass der TOTP-Code dieses Profils erforderlich ist. Der Agent kann jedoch nicht zu einem Benutzerprofil wechseln, dem der Zugriff auf die QIBM_RUN_UNDER_USER_NO_AUTH Funktionsnutzungs-ID verweigert wird. Standardmäßig haben alle Benutzerprofile (mit oder ohne MFA) Zugriff auf diese Funktions-ID, wodurch der „ Instana “-Agent eine Verbindung zu ihren JVMs herstellen kann. Weitere Informationen finden Sie unter der Funktions-ID „QIBM_RUN_UNDER_USER_NO_AUTH “.

Weitere Informationen zur Fernüberwachung von „ IBM i “ mit MFA finden Sie im Hinweis zu MFA.

Um den Host-Agenten auf IBM i zu installieren, führen Sie die folgenden Schritte aus:

1. Laden Sie das Agentenarchiv auf Ihr lokales System herunter:

   1. Klicken Sie in der Navigationsleiste der Benutzeroberfläche von „ Instana “ auf „Mehr“ > „Agenten“ > „Agenten installieren “.

   2. Klicken Sie auf der Seite des Agentenbereitstellungskatalogs auf die Kachel IBM i - Archiv (tar.gz).

   3. Wählen Sie den Agentenverpackungsmodus, Dynamic oder Static. Weitere Informationen zu dynamischen und statischen Host-Agenten finden Sie unter „Host-Agent-Typen “.

   4. Klicken Sie auf den Download-Link für IBM i, um die tar.gz-Datei herunterzuladen.

2. Erstellen Sie ein IFS-Zielverzeichnis (z. B. /opt/instana/) auf dem IBM i-System, indem Sie den folgenden Befehl ausführen:

   MKDIR DIR('/opt/instana')
    

3. Verschieben Sie das Agentenarchiv in das Verzeichnis, das Sie in Schritt 2 erstellt haben. Sie können FTP oder die IFS-Schnittstelle von ACS verwenden, um das Agentenarchiv zu verschieben.

4. Extrahieren Sie das Agentenarchiv auf dem IBM i-System, indem Sie die folgenden Befehle ausführen:

   CALL QP2TERM
    

   cd <instana-directory>
    

   /QOpenSys/pkgs/bin/tar -xzf instana-agent-ibmi-ppc.tar.gz
    

   Nachdem Sie das Agentenarchiv entpackt haben, wird ein neues Verzeichnis <instana-directory>/instana-agent erstellt. Beispiel: /opt/instana/instana-agent.

5. Konfigurieren Sie den Agenten so, dass er auf Ihr „ Instana “-Backend verweist, indem Sie die *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend.cfg Datei verwenden. Diese Datei enthält die Konfigurationen, die vom Host-Agenten für die Kommunikation mit dem Backend von „ Instana “ verwendet werden, darunter und host key. Weitere Informationen finden Sie unter „Konfigurieren des Backends für den Dienst „ Instana “.

Der Host-Agent ist nun auf Ihrem IBM i-System installiert und konfiguriert.

Nach der Installation des Host-Agenten können Sie den Host-Agenten verwalten, z. B. den Status des Agenten überprüfen oder den Agenten starten.

Sie können den Agenten auch nach Ihren Wünschen konfigurieren. Weitere Informationen finden Sie unter „Konfigurieren des Host-Agenten “.

Sie können Ansible verwenden, um die Installation des Hostagenten auf mehreren IBM i-Knoten zu automatisieren, indem Sie das folgende Playbook verwenden. Sie können dieses Playbook auf einem UNIX-ähnlichen Server ausführen, auf dem „ Ansible “ installiert ist. Dieses Playbook erstellt automatisch das Zielverzeichnis, kopiert und extrahiert das Agentenarchiv und startet den Agenten auf allen Ihren IBM i-Systemen.

Weitere Informationen über die Voraussetzungen und die Verwaltung von IBM i-Systemen mit Ansible finden Sie unter Power IBM i collection for Ansible. Weitere Beispiele für „ IBM i “ finden Sie unter „Automatisieren Sie Ihre Aufgaben in „ IBM i “ mit „ Ansible “.

Um die Installation des Host-Agenten mithilfe von Ansible zu automatisieren, führen Sie die folgenden Schritte aus:

1. Speichern Sie die folgende Playbook-Konfiguration als „ YAML “-Datei, z. B. playbook.yml „“, in einem Verzeichnis auf Ihrem System.

   ---
   - hosts: ibmi
     collections:
     - ibm.power_ibmi
     tasks:
     - name: Create Instana Directory
       ansible.builtin.file:
         path: /opt/instana
         state: directory
     - name: Remove Old Instana Agent files
       ansible.builtin.file:
         path: '{{ item }}'
         state: absent
       with_items:
         - /opt/instana/instana-agent
         - /opt/instana/instana-agent-ibmi-ppc.tar.gz
     - name: Copy Agent Tar to System
       ansible.builtin.copy:
         src: ./instana-agent-ibmi-ppc.tar.gz
         dest: /opt/instana/
     - name: Extract Instana Agent
       shell:
         cmd: tar -xzf /opt/instana/instana-agent-ibmi-ppc.tar.gz
     - name: Run Instana Agent in QUSRWRK
       ibmi_cl_command:
         cmd: sbmjob cmd(qsh cmd('export JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit; exec bash /opt/instana/instana-agent/bin/start')) jobq(QUSRNOMAX) LOG(*JOBD *JOBD *NOLIST)
    

2. Laden Sie das Agentenarchiv herunter, indem Sie Schritt 1 im Abschnitt Manuelle Installation des Agenten ausführen, und speichern Sie es im selben Verzeichnis wie das Playbook.

3. Erstellen Sie eine inventory.ini-Datei, in der alle IBM i-Knoten aufgeführt sind, auf denen Sie den Agenten installieren möchten, und speichern Sie sie im selben Verzeichnis wie das Playbook. Weitere Informationen zu dieser inventory.ini Datei finden Sie unter „Erstellen Sie Ihr Inventar “.

4. Führen Sie das Playbook von Ihrem Ansible-Server aus, indem Sie den folgenden Befehl verwenden:

   ansible-playbook -i inventory.ini playbook.yml
    

Der Agent wird auf allen IBM i-Systemen bereitgestellt, die in der inventory.ini-Datei angegeben sind.

Nach der Installation des Agenten können Sie den Agenten nach Bedarf weiter konfigurieren. Die Konfigurationen können bei der Ausführung des Agenten angewendet werden, und die Änderungen werden sofort übernommen. Weitere Informationen finden Sie unter „Konfigurieren des Host-Agenten “.

Nachdem Sie den Host-Agenten installiert haben, können Sie den Status des Agenten in der Benutzeroberfläche von „ Instana “ überprüfen. Weitere Informationen finden Sie unter Prüfen des Status des Host-Agenten.

Um den Host-Agenten zu starten, führen Sie den folgenden Befehl aus:

SBMJOB CMD(QSH CMD('export JAVA_HOME=<java-home>; exec bash *instanaAgentDir*/bin/start')) JOBQ(QUSRNOMAX) LOG(*JOBD *JOBD *NOLIST)
 

Dieser Befehl startet die „ Instana “-Agent-Jobs im QUSRWRK Subsystem und führt die Jobs als aktueller Benutzer aus. Der Agent muss als Benutzer mit der Berechtigung *ALLOBJ laufen. Weitere Informationen finden Sie unter SBMJOB.

Nach Abschluss der Initialisierung verbleiben drei separate Aufträge mit dem Namen QZSHSH zur Ausführung des Agenten. Bei diesen drei Aufträgen ist der Auftrag, der die Funktion PGM-sh hat, der übergeordnete Auftrag. Der Auftrag mit der Funktion PGM-jFromPASE ist das direkte Kind des übergeordneten Auftrags. Der Auftrag mit der Funktion JVM-org.apache ist das Kind des ersten untergeordneten Auftrags. Andere Jobs können kurzzeitig starten oder stoppen, insbesondere während des Starts.

Um den Host-Agenten zu stoppen, führen Sie den folgenden Befehl aus:

*instanaAgentDir*/bin/stop
 

Thema :

Der Host-Agent kann keine Verbindung zu JVM herstellen.

In der folgenden Fehlermeldung hat der Agent versucht, sich an den Prozess „ JVM “ (PID 123) anzuhängen, was jedoch fehlgeschlagen ist:

2025-08-22T09:45:24.832-03:00 | INFO  | instana-executor-thread-2-98     | AttachHelperImpl | com.instana.agent-jvm-handling - 1.0.22 | Agent user {Uid=128, Gid=0} and target JVM user {Uid=4294770318, Gid=201} not identical.
2025-08-22T09:45:24.833-03:00 | INFO  | instana-executor-thread-2-98     | ExternalAttach   | com.instana.agent-jvm-handling - 1.0.22 | Executing: /opt/instana/instana-agent/system/com/instana/ibmi-sudo/1.0.0/ibmi-sudo-1.0.0.exe -u qwebadmin /QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit/jre/bin/java -Xms16m -Xmx16m -Dcom.ibm.tools.attach.enable=no -Duser.dir=/ -cp /tmp/.instana/javaagent-loader-1.3.70.jar com.instana.agent.loader.AgentLoaderAttach agent=/tmp/.instana/javaagent-loader-1.3.70.jar verify=true pid=123 host=127.0.0.1 port=42699 boot=/com.instana.agent.artifact/com.instana/instrumentation-boot/1.1.31/jar shared=/com.instana.agent.artifact/com.instana/instrumentation-shared/1.0.146/jar inMemoryClassLoader=true agentSocket=true
2025-08-22T09:45:25.301-03:00 | ERROR | instana-executor-thread-2-98     | ExternalAttach   | com.instana.agent-jvm-handling - 1.0.22 | com.sun.tools.attach.AttachNotSupportedException: target 123 not found
...
 

Grund :

Der target <pid> not found Fehler kann durch folgende Ursachen hervorgerufen werden:

• Der Prozess „ JVM “ läuft nicht mehr (oder hat eine neue PID).
• Dem „ Instana “-Agenten fehlt die Berechtigung, zum Benutzerprofil des „ JVM “ zu wechseln.

Lösung :

Führen Sie die folgenden Schritte aus, um dieses Problem zu beheben:

1. Überprüfen Sie anhand der folgenden Schritte, ob der Prozess „ JVM “ mit der PID noch läuft:

   1. Führen Sie den ps -e Befehl in einer PASE-Shell aus.
   2. Suchen Sie nach der in der Fehlermeldung angegebenen PID, zum Beispiel. 123

   Wenn der Prozess mit dieser PID nicht mehr läuft, ist die Anbindung fehlgeschlagen, da der Prozess „ JVM “ beendet wurde oder nun unter einer neuen PID läuft. In diesem Fall versucht der Agent, sich an den neuen Prozess anzuhängen.

2. Wenn der Dienst „ JVM “ ausgeführt wird, überprüfen Sie die Benutzerberechtigungen. Das Benutzerprofil des „ Instana “-Agenten muss über die *ALLOBJ spezielle Berechtigung verfügen, als ein anderes Benutzerprofil ausgeführt zu werden, was für die Anbindung an JVMs erforderlich ist. Weitere Informationen finden Sie unter qsysetuid().

   Führen Sie die folgenden Schritte aus, um die Benutzerberechtigungen zu überprüfen:

   1. Führen Sie den ibmi-sudo Befehl manuell mit dem Benutzerprofil „ Instana “ aus, wie im folgenden Beispiel gezeigt, und verwenden Sie dabei den in der Fehlermeldung angegebenen Pfad zur ibmi-sudo ausführbaren Datei:

      /opt/instana/instana-agent/system/com/instana/ibmi-sudo/1.0.0/ibmi-sudo-1.0.0.exe -u qwebadmin /QOpenSys/pkgs/bin/whoami
       

      Wenn der Befehl „sudo“ erfolgreich ausgeführt wird, wird der Name des Benutzerprofils ausgegeben, zum Beispiel:

      QWEBADMIN
       

      Falls der Befehl „sudo“ fehlschlägt, ist dies möglicherweise im Profil des Zielbenutzers festgelegt OWNER(*GRPPRF). Falls die erste Gruppe des Zielbenutzerprofils nicht in der Liste der Zusatzgruppen für den Benutzer des „ Instana “-Agenten enthalten ist, fügen Sie die Zielgruppe zu den Zusatzgruppen hinzu.

   2. Fügen Sie die Gruppe des Zielbenutzers zur Liste der Zusatzgruppen für das Benutzerprofil „ Instana “ hinzu, wie im folgenden Beispiel gezeigt:

      CHGUSRPRF USRPRF(INSTANA) SUPGRPPRF(TARGET_GROUP)
       

Falls die hier beschriebenen Schritte zur Fehlerbehebung Ihr Problem nicht lösen, wenden Sie sich bitte an das IBM Instana Support-Team.