Zmiana nazwy systemu zarządzanego agenta

W celu zmiany nazwy systemu zarządzanego dla różnych agentów Cloud APM można zastosować różne procedury. W przypadku niektórych agentów zmiana nazwy systemu zarządzanego oznacza zmianę nazwy hosta lub nazwy instancji agenta (lub obu) w nazwie systemu zarządzanego. W przypadku innych agentów do zmiany nazwy systemu zarządzanego wymagana jest konkretna procedura.

Zanim rozpoczniesz

Zapoznaj się z formatami nazw systemów zarządzanych i ograniczeniami nazewnictwa podanymi w sekcji Nazwy systemów zarządzanych.

O tym zadaniu

Dla większości agentów Cloud APM można użyć parametru CTIRA_HOSTNAME w celu zmiany nazwy hosta używanej w nazwie systemu zarządzanego. Aby zmienić nazwę instancji agenta w nazwie systemu zarządzanego dla agentów o wielu instancjach, można użyć parametru konfiguracyjnego agenta. Jeśli agenta już skonfigurowano, należy zmienić jego konfigurację, aby przypisać inną nazwę instancji agenta. Po zrekonfigurowaniu agenta nie będzie można pobrać danych zgromadzonych przez poprzednią instancję agenta.

Zmiana nazwy systemu zarządzanego przy użyciu pojedynczej procedury może nie być możliwa, w zależności od tego, która część nazwy systemu zarządzanego ma zostać zmieniona.

W celu określenia metody zmiany nazwy systemu zarządzanego dla wybranego agenta należy zapoznać się z sekcją Tabela 1.

Wyjątek: Zmiana nazwy systemu zarządzanego nie jest obsługiwana przez agenta serwera HTTP Server, agenta dla Node.js ani agenta powtarzania syntetycznego.

Tabela 1. Metody zmiany nazwy systemu zarządzanego dla agentów Cloud APM
Agent	metoda zmiany nazwy systemu zarządzanego
agent Amazon EC2	Użyj parametru konfiguracyjnego agenta, aby zmienić nazwę podwęzła EC2 w nazwie systemu zarządzanego. Patrz sekcja Parametry konfiguracyjne dla agenta Amazon EC2.
agent Amazon ELB	Utwórz nową instancję agenta z nową nazwą instancji, aby zmienić nazwę systemu zarządzanego.
agent dla Azure Compute	Użyj parametru konfiguracyjnego agenta, aby zmienić nazwę podwęzła w nazwie systemu zarządzanego. Patrz sekcja Parametry konfiguracyjne agenta dla Azure Compute.
agent Cassandra	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent Cisco UCS	Aby użyć parametru konfiguracyjnego agenta do zmiany nazwy instancji agenta, patrz sekcja Parametry konfiguracyjne agenta.
agent Citrix VDI	Aby użyć parametru konfiguracyjnego agenta do zmiany nazwy serwisu Citrix, patrz sekcja Parametry konfiguracyjne agenta Citrix VDI.
agent Db2	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent DataPower	Aby użyć parametru konfiguracyjnego agenta do zmiany nazwy systemu zarządzanego, patrz sekcja Konfigurowanie agenta agent DataPower.
agent DataStage	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent Hadoop	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla HMC Base	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent IBM® Cloud	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla produktu IBM Integration Bus	Określanie unikalnej nazwy systemu zarządzanego dla agenta dla produktu IBM Integration Bus
agent dla JBoss	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla Linux KVM	Użyj parametrów konfiguracyjnych agenta, patrz sekcja Konfigurowanie monitorowania dla Linux KVM.
agent dla systemu Linux	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft .NET	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft Active Directory	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft Exchange Server	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft Hyper-V Server	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft IIS	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft Office 365	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Microsoft SQL Server	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla Microsoft SharePoint Server	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla MongoDB	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla MySQL	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla NetApp Storage	Użyj parametrów konfiguracyjnych agenta, patrz sekcja Konfigurowanie monitorowania pamięci masowej NetApp.
agent dla OpenStack	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla bazy danych Oracle	Użyj parametrów konfiguracyjnych agenta, patrz sekcja Konfigurowanie monitorowania bazy danych Oracle.
agent dla PHP	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla PostgreSQL	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla RabbitMQ	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent monitorowania czasu odpowiedzi	Określanie unikalnej nazwy systemu zarządzanego dla agenta monitorowania czasu odpowiedzi
agent dla Ruby	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla SAP	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent bazy danych SAP HANA	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent SAP NetWeaver Java™ Stack	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla Siebel	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla serwera Skype for Business (wcześniej nazywany agentem dla serwera Microsoft Lync Server)	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla Sterling File Gateway	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla Sterling Connect Direct	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla Tomcat	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent dla systemu UNIX	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.
agent dla aplikacji WebSphere	Aby zmienić nazwę hosta w nazwie systemu zarządzanego, zapoznaj się z sekcją Jak zmienić nazwę hosta używaną w nazwie systemu zarządzanego dla instancji agenta WAS?. Aby zmienić serwer nazwy aliasu w nazwie systemu zarządzanego, zmień konfigurację agenta, patrz Interaktywna zmiana konfiguracji modułu gromadzącego dane.
agent dla produktu WebSphere Infrastructure Manager	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego. Użyj parametru konfiguracyjnego agenta do zmiany nazwy instancji w nazwie systemu zarządzanego.
agent WebSphere MQ	Określanie unikalnych nazw systemów zarządzanych dla wielu menedżerów kolejek
agent dla systemu Windows	Użyj parametru CTIRA_HOSTNAME, aby zmienić nazwę hosta w nazwie systemu zarządzanego. Patrz sekcja Zmiana nazwy hosta w nazwie systemu zarządzanego.

Zmiana nazwy hosta w nazwie systemu zarządzanego

O tym zadaniu

Zmiana nazwy hosta w nazwie systemu zarządzanego nie jest powszechną praktyką. Nazwa hosta jest automatycznie wykrywana i ustawiana w konfiguracji agenta. Zmień nazwę hosta w nazwie systemu zarządzanego tylko wtedy, gdy jest to konieczne i upewnij się, że podana przez użytkownika wartość nie powoduje żadnych obcięć ze względu na ograniczenia nazewnictwa nazwy systemu zarządzanego.

Procedura

Zatrzymaj wszystkie istniejące instancje agenta i zaczekaj, aż w konsoli Cloud APM zostanie wyświetlona informacja o tym, że agent lub jego podwęzły są w trybie bez połączenia. Jeśli nie ma żadnych istniejących instancji agenta, przejdź do następnego kroku.

Więcej informacji na temat zatrzymywania instancji agenta zawiera sekcja Korzystanie z komend agenta.
Jeśli jest to agent z jedną instancją, wykonaj następujące kroki, aby zmienić parametr CTIRA_HOSTNAME. Wartość podana dla parametru CTIRA_HOSTNAME to wartość, która jest stosowana dla wszystkich nowych instancji agenta.
1. Utwórz kopię zapasową następującego pliku:
  - katalog_instalacyjny/config/pc.environment
  - katalog_instalacyjny/TMAITM6_x64/kpccma.ini
  gdzie:
  - katalog_instalacyjny to katalog instalacyjny agenta.
  - pc to dwuliterowy kod agenta. Patrz Tabela nazw i kodów agentów.
2. Zmodyfikuj plik, zmieniając wartość parametru CTIRA_HOSTNAME w podany poniżej sposób, gdzie nowa_nazwa_hosta to łańcuch niestandardowy, który jest używany zamiast rzeczywistej nazwy hosta komputera, na którym jest zainstalowany agent.
  - CTIRA_HOSTNAME=nowa_nazwa_hosta
  - CTIRA_HOSTNAME=nowa_nazwa_hosta.TYPE=REG_EXPAND_SZ
3. Zapisz zmiany.
Jeśli agent jest agentem o wielu instancjach, wykonaj następujące kroki, aby zmienić parametr CTIRA_HOSTNAME. Zwykle wszystkie instancje agenta na komputerze używają tej samej wartości nazwy hosta. Jeśli instancje agenta mają używać różnych wartości, należy parametrowi CTIRA_HOSTNAME nadawać różne wartości, wykonując ten krok.
1. Należy utworzyć kopię zapasową następujących plików:
  - katalog_instalacyjny/config/pc_instancja.environment
  - katalog_instalacyjny/TMAITM6_x64/kpccma_instancja.ini
2. Zmodyfikuj plik, zmieniając wartość parametru CTIRA_HOSTNAME w następujący sposób:
  - CTIRA_HOSTNAME=nowa_nazwa_hosta
  - CTIRA_HOSTNAME=nowa_nazwa_hosta.TYPE=REG_EXPAND_SZ
3. Zapisz zmiany.
Zrekonfiguruj istniejące instancje agenta.
Uruchom wszystkie instancje agenta.

Co dalej

Po zmianie nazwy systemu zarządzanego agenta uruchom konsolę Cloud APM i zmodyfikuj aplikacje przez usunięcie starej nazwy systemu zarządzanego z aplikacji i dodanie zamiast niej nowej nazwy systemu zarządzanego.