Name des vom Agenten verwalteten Systems ändern

Zum Ändern des MSN (Managed System Name - Name des verwalteten Systems) für verschiedene Cloud APM-Agenten sind unterschiedliche Prozeduren anzuwenden. Bei einigen Agenten bedeutet das Ändern des Namens des verwalteten Systems, dass der Hostname oder der Name der Agenteninstanz (oder beide) im Namen des verwalteten Systems geändert wird. Bei anderen Agenten sind bestimmte Prozeduren erforderlich, um den Namen des verwalteten Systems zu ändern.

Vorbereitende Schritte

Machen Sie sich mit den Formaten und dem Einschränkungen bei der Benennung für den Namen des verwalteten Systems vertraut, die unter Namen verwalteter Systeme beschrieben sind.

Informationen zu diesem Vorgang

Bei den meisten Cloud APM-Agenten können Sie den im Namen des verwalteten Systems verwendeten Hostnamen über den Parameter CTIRA_HOSTNAME ändern. Zum Ändern des Agenteninstanznamens im Namen des verwalteten Systems für Agenten mit mehreren Instanzen können Sie den Agentenkonfigurationsparameter verwenden. Wenn Sie den Agenten konfiguriert haben, müssen Sie ihn erneut konfigurieren, um ihn einem anderen Agenteninstanznamen zuweisen zu können. Nachdem Sie den Agenten neu konfiguriert haben, können die von der vorherigen Agenteninstanz erfassten Daten nicht mehr abgerufen werden.

Je nach dem Teil des Namens des verwalteten Systems, der geändert werden soll, kann der Namen des verwalteten Systems möglicherweise nicht in einer einzelnen Prozedur geändert werden.

Informationen dazu, welche Methode zum Ändern des Namens des verwalteten Systems auf den jeweiligen Agenten anzuwenden ist, finden Sie unter Tabelle 1.

Ausnahme: Die Änderung des Namens des verwalteten Systems wird von HTTP Server Agent, Node.js Agent und Synthetic Playback Agent nicht unterstützt.

Tabelle 1. Methoden zum Ändern des Namens des verwalteten Systems für Cloud APM-Agenten
Agent	Methode zum Ändern des Namens des verwalteten Systems
Amazon EC2 Agent	Informationen zum Ändern des EC2-Unterknotennamens im Namen des verwalteten Systems über Agentenkonfigurationsparameter finden Sie unter Konfigurationsparameter für Amazon EC2 Agent.
Amazon ELB Agent	Erstellen Sie eine neue Agenteninstanz mit einem neuen Instanznamen, um den Namen des verwalteten Systems zu ändern.
Azure Compute Agent	Informationen zum Ändern des Unterknotennamens im Namen des verwalteten Systems über Agentenkonfigurationsparameter finden Sie unter Konfigurationsparameter für Azure Compute Agent.
Cassandra Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Cisco UCS Agent	Informationen zum Ändern des Agenteninstanznamens über Agentenkonfigurationsparameter finden Sie unter Konfigurationsparameter für den Agenten.
Citrix VDI Agent	Informationen zum Ändern des Namens für die Citrix-Site über Agentenkonfigurationsparameter finden Sie unter Konfigurationsparameter für Citrix VDI Agent.
Db2 Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
DataPower Agent	Informationen zum Ändern des Namens des verwalteten Systems über Agentenkonfigurationsparameter finden Sie unter DataPower Agent konfigurieren.
DataStage Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Hadoop Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
HMC Base Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
IBM® Cloud Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
IBM Integration Bus Agent	Eindeutigen Namen für verwaltetes System für IBM Integration Bus Agent angegeben
JBoss Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Linux KVM Agent	Informationen zur Verwendung der Agentenkonfigurationsparameter finden Sie unter Linux KVM-Überwachung konfigurieren.
Linux OS Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft .NET Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft Active Directory Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft Exchange Server Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft Hyper-V Server Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft IIS Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft Office 365 Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Microsoft SQL Server Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Microsoft SharePoint Server Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
MongoDB Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
MySQL Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
NetApp Storage Agent	Informationen zur Verwendung der Agentenkonfigurationsparameter finden Sie unter NetApp Storage-Überwachung konfigurieren.
OpenStack Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Oracle Database Agent	Informationen zur Verwendung der Agentenkonfigurationsparameter finden Sie unter Oracle-Datenbanküberwachung konfigurieren.
PHP Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
PostgreSQL Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
RabbitMQ Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Response Time Monitoring Agent	Eindeutigen Namen des verwalteten Systems für Response Time Monitoring Agent angeben
Ruby Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
SAP Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
SAP HANA Database Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
SAP NetWeaver Java™ Stack Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Siebel Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Skype for Business Server Agent (bisher unter der Bezeichnung Microsoft Lync Server Agent)	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
Sterling File Gateway Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Sterling Connect Direct Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
Tomcat Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
UNIX OS Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.
WebSphere Applications Agent	Informationen zum Ändern des Hostnamens im Namen des verwalteten Systems finden Sie unter Vorgehensweise zum Ändern des im Namen des verwalteten Systems verwendeten Hostnamens für die WAS-Agenteninstanz. Informationen zum Ändern des Serveraliasnamens im Namen des verwalteten Systems durch Rekonfigurieren des Agenten finden Sie unter Datenkollektor interaktiv rekonfigurieren.
WebSphere Infrastructure Manager Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern. Verwenden Sie zum Ändern des Instanznamens im Namen des verwalteten Systems den Agentenkonfigurationsparameter.
WebSphere MQ Agent	Eindeutige Namen der verwalteten Systeme für mehrere Warteschlangenmanager angeben
Windows OS Agent	Verwenden Sie zum Ändern des Hostnamens im Namen des verwalteten Systems den Parameter CTIRA_HOSTNAME. Weitere Informationen hierzu finden Sie unter Hostnamen im Namen des verwalteten Systems ändern.

Hostnamen im Namen des verwalteten Systems ändern

Informationen zu diesem Vorgang

Es ist nicht üblich, den Hostnamen im Namen des verwalteten Systems zu ändern. Der Hostname wird bei der Agentenkonfiguration automatisch erkannt und festgelegt. Ändern Sie den Hostnamen im Namen des verwalteten Systems nur, wenn es erforderlich ist, und stellen Sie sicher, dass der von Ihnen angegebene Wert nicht zu Abschneidungen aufgrund der Einschränkungen bei der Benennung führt.

Vorgehensweise

Stoppen Sie alle vorhandenen Instanzen des Agenten. und warten Sie, bis in der Cloud APM-Konsole angezeigt wird, dass der Agent oder seine Unterknoten offline sind. Wenn keine Agenteninstanzen vorhanden sind, können Sie mit dem nächsten Schritt fortfahren.

Weitere Informationen zum Stoppen von Agenteninstanzen finden Sie im Abschnitt Agentenbefehle verwenden.
Wenn es sich um einen Agenten mit nur einer Instanz handelt, führen Sie die folgenden Schritte aus, um den Parameter CTIRA_HOSTNAME zu ändern. Der Wert, den Sie für den Parameter CTIRA_HOSTNAME angeben, wird auf alle neuen Agenteninstanzen angewendet.
1. Erstellen Sie eine Sicherungskopie der folgenden Datei:
  - installationsverzeichnis/config/pc.environment
  - installationsverzeichnis/TMAITM6_x64/kpccma.ini
  Hierbei gilt:
  - installationsverzeichnis ist das Agenteninstallationsverzeichnis.
  - pc ist der aus zwei Zeichen bestehende Agentencode. Siehe die Tabelle der Agentennamen und Agentencodes.
2. Bearbeiten Sie die Datei, indem Sie den Parameterwert CTIRA_HOSTNAME wie folgt ändern, wobei neuer_hostname die angepasste Zeichenfolge ist, die anstelle des tatsächlichen Hostnamens auf dem Computer verwendet wird, auf dem der Agent installiert ist.
  - CTIRA_HOSTNAME=neuer_hostname
  - CTIRA_HOSTNAME=neuer_hostname .TYPE=REG_EXPAND_SZ
3. Speichern Sie Ihre Änderungen.
Wenn es sich um einen Agenten mit mehreren Instanzen handelt, führen Sie die folgenden Schritte aus, um den Parameter CTIRA_HOSTNAME zu ändern. Normalerweise verwenden alle Agenteninstanzen auf einem Computer denselben Wert für den Hostnamen. Wenn es erforderlich ist, dass die Agenteninstanzen unterschiedliche Werte verwenden, können Sie den Wert, den Sie CTIRA_HOSTNAME zuordnen, variieren, wenn Sie diesen Schritt ausführen.
1. Erstellen Sie eine Sicherungskopie der folgenden Dateien:
  - installationsverzeichnis/config/pc_instance.environment
  - installationsverzeichnis/TMAITM6_x64/kpccma_instance.ini
2. Bearbeiten Sie die Datei, um den Parameterwert CTIRA_HOSTNAME wie folgt zu ändern:
  - CTIRA_HOSTNAME=neuer_hostname
  - CTIRA_HOSTNAME=neuer_hostname .TYPE=REG_EXPAND_SZ
3. Speichern Sie Ihre Änderungen.
Rekonfigurieren Sie die vorhandenen Agenteninstanzen.
Starten Sie alle Agenteninstanzen.

Nächste Schritte

Nach der Änderung des Namens des verwalteten Systems des Agenten müssen Sie die Cloud APM-Konsole starten und die Anwendungen ändern, indem Sie den alten Namen des verwalteten Systems aus den Anwendungen entfernen und stattdessen den neuen Namen des verwalteten Systems hinzufügen.