Agentenbefehle verwenden
Die Scripts, die zum Installieren der Überwachungsagenten verwendet werden, können auch zum Überprüfen des Status eines installierten Agenten, zum Starten oder Stoppen des Agenten und zum Deinstallieren des Agenten verwendet werden.
Informationen zu diesem Vorgang
name-agent.sh
name-agent.bat
| Überwachungsagent | name | Agentencode aus zwei Zeichen |
|---|---|---|
| Monitoring Agent for Amazon EC2 | amazon_ec2 | b5 |
| Monitoring Agent for Azure Compute | azure_compute | ak |
| Monitoring Agent for Cassandra | cassandra | zc |
| Monitoring Agent for Cisco UCS | cisco_ucs | v6 |
| Monitoring Agent for Citrix Virtual Desktop Infrastructure | citrix_vdi | vd |
| Monitoring Agent for DataPower | datapower | bn |
| Monitoring Agent for Db2 | db2 | ud |
| Monitoring Agent for Hadoop | hadoop | h8 |
| Monitoring Agent for HMC Base | hmc_base | ph |
| Monitoring Agent for HTTP Server | http_server | hu |
| Monitoring Agent for IBM® Cloud | ibm_cloud | fs |
| Monitoring Agent for IBM Integration Bus | iib | qi |
| Monitoring Agent for MQ Appliance | ibm_mq_appliances | mk |
| Monitoring Agent for InfoSphere DataStage | datastage | dt |
| Monitoring Agent for JBoss | jboss | je |
| Monitoring Agent for Linux KVM | linux_kvm | v1 |
| Monitoring Agent for Linux OS | os | lz |
| Monitoring Agent for MariaDB | mariadb | mj |
| Monitoring Agent for Microsoft Active Directory | msad | 3z |
| Monitoring Agent for Microsoft Cluster Server | mscs | q5 |
| Monitoring Agent for Microsoft Exchange Server | msexch | ex |
| Monitoring Agent for Microsoft Hyper-V Server | microsoft_hyper-v_server | hv |
| Monitoring Agent for Microsoft Internet Information Services | msiis | q7 |
| Monitoring Agent for Skype for Business Server (bisher unter der Bezeichnung Microsoft Lync Server) | skype_for_business_server | ql |
| Monitoring Agent for Microsoft .NET | dotnet | qe |
| Monitoring Agent for Microsoft Office 365 | microsoft_office365 | mo |
| Monitoring Agent for Microsoft SharePoint Server | ms_sharepoint_server | qp |
| Monitoring Agent for Microsoft SQL Server | mssql | oq |
| Monitoring Agent for MongoDB | mongodb | kj |
| Monitoring Agent for MySQL | mysql | se |
| Monitoring Agent for NetApp Storage | netapp_storage | nu |
| Monitoring Agent for Node.js | nodejs | nj |
| Monitoring Agent for OpenStack | openstack | sg |
| Monitoring Agent for Oracle Database | oracle_database | rz |
| Monitoring Agent for PHP | php | pj |
| Monitoring Agent for PostgreSQL | postgresql | pn |
| Monitoring Agent for Python | python | pg |
| Monitoring Agent for RabbitMQ | rabbitMQ | zr |
| Monitoring Agent for Ruby | ruby | km |
| Monitoring Agent for SAP Applications | sap | sa |
| Monitoring Agent for SAP HANA Database | sap_hana_database | s7 |
| Monitoring Agent for SAP NetWeaver Java™ Stack | sap_netweaver_java_stack | sv |
| Monitoring Agent for Siebel | siebel | uy |
| Monitoring Agent for Sterling Connect Direct | sterling_connect_direct-agent | FC |
| Monitoring Agent for Sterling File Gateway | file_gateway | fg |
| Monitoring Agent for Sybase Server | sybase | oy |
| Monitoring Agent for Synthetic Playback | synthetic_transactions | sn |
| Monitoring Agent for Tomcat | tomcat | ot |
| Monitoring Agent for UNIX OS | os | ux |
| Monitoring Agent for VMware VI | vmware_vi | vm |
| Monitoring Agent for WebLogic | oracle_weblogic | wb |
| Monitoring Agent for WebSphere Applications | was | yn |
| Monitoring Agent for WebSphere Infrastructure Manager | wim | d0 |
| Monitoring Agent for WebSphere MQ | mq | mq |
| Monitoring Agent for Windows OS | os | nt |
| Response Time Monitoring Agent | rt | t5 |
Vorgehensweise
-
Wechseln Sie auf dem System, auf dem Sie einen Befehl
an den Überwachungsagenten senden wollen, in das Verzeichnis
installationsverzeichnis/bin.
Geben Sie einen der in Tabelle 2 aufgeführten Befehle ein (hierbei steht name für den Agentennamen, der in Tabelle 1 angegeben ist).
Tabelle 2. Befehle für UNIX- und Linux-Systeme Befehl Beschreibung ./name-agent.sh status Überprüft den Status des Agenten. Der Status kann entweder 'Aktiv' oder 'Nicht aktiv' lauten. Wird der Agent momentan ausgeführt, dann wird auch der Status der Verbindung zwischen dem Agenten und dem Cloud APM-Server überprüft. Die folgenden negativen Verbindungsstatus sind möglich: 'Verbindung fehlgeschlagen', 'Fehler aufgetreten', 'Verbindung getrennt - Fehler'. Der positive Status ist 'Verbunden'. Dieser Status wird erwartet. Der Name des Übergangsstatus lautet 'Verbindung wird hergestellt'. Der Status 'Unbekannt' bedeutet, dass der Agentenstatus nicht identifiziert werden kann. Dies ist möglicherweise auf Fehler im Dateisystem oder in der Agentenprotokolldatei zurückzuführen.
./name-agent.sh start Startet den Überwachungsagenten. Wenn der Agent über Instanzen verfügt, müssen Sie nach dem Befehl einen Instanznamen eingeben. ./name-agent.sh stop Stoppt den Überwachungsagenten. Wenn der Agent über Instanzen verfügt, müssen Sie nach dem Befehl einen Instanznamen eingeben. ./name-agent.sh prereqcheck Führt eine Prüfung der Voraussetzungen durch. Diese Befehlsoption ist für die meisten Agenten verfügbar. ./name-agent.sh install Installiert den Überwachungsagenten. Weitere Informationen finden Sie unter Agenten auf UNIX-Systemen installieren und Agenten auf Linux-Systemen installieren. ./name-agent.sh config instanzname pfad_zur_datei_für_unbeaufsichtigte_konfiguration Konfiguriert den Überwachungsagenten. Führen Sie den Befehl im Verzeichnis installationsverzeichnis/bin aus und fügen Sie den Pfad der Antwortdatei hinzu, sofern erforderlich. Wenn der Agent über Instanzen verfügt, müssen Sie einen Instanznamen eingeben. Weitere Informationen dazu, bei welchen Agenten es sich um Agenten mit mehreren Instanzen handelt, finden Sie in Tabelle 1.
Die Angabe pfad_zur_datei_für_unbeaufsichtigte_konfiguration ist optional. Wenn Sie keine Datei für die unbeaufsichtigte Konfiguration angeben, können Sie den Überwachungsagenten interaktiv durch Ausführen der Eingabeaufforderungen konfigurieren.
./name-agent.sh uninstall Deinstalliert den Überwachungsagenten. Weitere Informationen finden Sie im Abschnitt Agenten deinstallieren. ./smai-agent.sh uninstall_all Deinstalliert alle Überwachungsagenten auf dem verwalteten System. ./name-agent.sh remove instanzname Entfernt eine Instanz eines Agenten mit mehreren Instanzen. ./name-agent.sh Zeigt eine Beschreibung der mit dem Script verfügbaren Funktionen an. -
Wechseln Sie auf dem System, auf dem Sie einen Befehl
an den Überwachungsagenten senden wollen, in der Eingabeaufforderung in das Verzeichnis
installationsverzeichnis\BIN. Beispiel: C:\IBM\APM\bin.
Geben Sie einen der in Tabelle 3 aufgeführten Befehle ein (hierbei steht name für den Agentennamen, der in Tabelle 1 angegeben ist).
Tabelle 3. Befehle für Windows-Systeme Befehl Beschreibung name-agent.bat status Überprüft den Status des Agenten.
Überprüft den Status der Verbindung zwischen dem Agenten und dem Cloud APM-Server. Die folgenden negativen Verbindungsstatus sind möglich: 'Verbindung fehlgeschlagen', 'Fehler aufgetreten', 'Verbindung getrennt - Fehler'. Der positive Status ist 'Verbunden'. Dieser Status wird erwartet. Der Name des Übergangsstatus lautet 'Verbindung wird hergestellt'. Der Status 'Unbekannt' bedeutet, dass der Agentenstatus nicht identifiziert werden kann. Dies ist möglicherweise auf Fehler im Dateisystem oder in der Agentenprotokolldatei zurückzuführen.
name-agent.bat start Startet den Überwachungsagenten. Wenn der Agent über Instanzen verfügt, müssen Sie nach dem Befehl einen Instanznamen eingeben. name-agent.bat stop Stoppt den Überwachungsagenten. Wenn der Agent über Instanzen verfügt, müssen Sie nach dem Befehl einen Instanznamen eingeben. name-agent.bat prereqcheck Führt eine Prüfung der Voraussetzungen durch. Diese Befehlsoption ist für die meisten Agenten verfügbar. name-agent.bat install Installiert den Überwachungsagenten. Weitere Informationen finden Sie im Abschnitt Agenten installieren. name-agent.bat config instanzname pfad_zur_datei_für_unbeaufsichtigte_konfiguration Konfiguriert den Überwachungsagenten. Führen Sie den Befehl im Verzeichnis installationsverzeichnis\bin aus und fügen Sie den Pfad der Antwortdatei hinzu, sofern erforderlich. Wenn der Agent über Instanzen verfügt, müssen Sie einen Instanznamen eingeben. Weitere Informationen dazu, bei welchen Agenten es sich um Agenten mit mehreren Instanzen handelt, finden Sie in Tabelle 1.
Die Angabe pfad_zur_datei_für_unbeaufsichtigte_konfiguration ist optional. Wenn Sie keine Datei für die unbeaufsichtigte Konfiguration angeben, können Sie den Überwachungsagenten interaktiv durch Ausführen der Eingabeaufforderungen konfigurieren.
name-agent.bat uninstall Deinstalliert den Überwachungsagenten. Weitere Informationen finden Sie im Abschnitt Agenten deinstallieren. smai-agent.bat uninstall_all Deinstalliert alle Überwachungsagenten auf dem verwalteten System. name-agent.bat remove instanzname Entfernt eine Instanz eines Agenten mit mehreren Instanzen. name-agent.bat Zeigt eine Beschreibung der mit dem Script verfügbaren Funktionen an.
Befehl für die Agentenversion
-
Führen Sie die folgenden Befehle aus, um die Version eines Agenten in Ihrer Umgebung anzuzeigen:
Geben Sie 1 ein, um die Versionen anzuzeigen.installationsverzeichnis/bin/cinfo-
installationsverzeichnis/InstallITM/kincinfo